scout
/scout
Szybko i równolegle przeszukuje bazę kodu, dane, devops i analitykę: pliki, modele dbt, dashboardy, IaC, DAG-i, manifesty K8s, sekrety i workflow CI przed zmianami.
- Autor
- vanducng ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Szybko i równolegle przeszukuje bazę kodu, dane, devops i analitykę: pliki, modele dbt, dashboardy, IaC, DAG-i, manifesty K8s, sekrety i workflow CI przed zmianami.
Argumenty
/scout [search-target] [ext]
Oryginalny opis (EN)
Fast, parallel codebase scouting across software, data-engineering, devops, and analytics surfaces. Use to locate files, dbt models, dashboards, IaC, pipeline DAGs, K8s manifests, secrets, and CI workflows before changes. Supports internal (Explore subagents) and external (Gemini/OpenCode CLI) modes.
Jak działa
- Modes
- When to use
- Quick start
- Configuration
- Workflow
- Report format
- References
Podgląd SKILL.md
---
name: scout
description: "Fast, parallel codebase scouting across software, data-engineering, devops, and analytics surfaces. Use to locate files, dbt models, dashboards, IaC, pipeline DAGs, K8s manifests, secrets, and CI workflows before changes. Supports internal (Explore subagents) and external (Gemini/OpenCode CLI) modes."
license: MIT
argument-hint: "[search-target] [ext]"
metadata:
author: vanducng
version: "1.1.0"
---
# Scout
Token-efficient parallel scouting that finds the right files before you touch them. Tuned for multi-discipline repos: app code, data pipelines, IaC, and BI artifacts.
## Modes
| Argument | What | When |
|---|---|---|
| _(none)_ | **Internal** - Explore subagents in parallel (`references/internal-scouting.md`) | Default in Claude Code. Best for ≥6 logical segments. |
| `ext` | **External** - Gemini / OpenCode CLI in parallel (`references/external-scouting.md`) | Large surfaces (1M+ ctx) and you have one of the CLIs installed. SCALE 1-5. |
Internal mode needs the Task/Explore tool (Claude Code). In a runtime without it (e.g. Codex), use `ext` mode - run its `gemini`/`opencode` bash commands sequentially - or fall back to inline `Glob`/`Grep` sweeps.
## When to use
Use when a change could span multiple folders (e.g. a new dbt source touching `models/`, `schema.yml`, `dashboards/`, and a CI workflow), the user says **"find / locate / search for"** anything, a debug session needs a file map before `vd:debug`, or a refactor / migration / deletion could ripple across services. **Skip scout when** the target file is already known, or one `grep` answers the question - scout is for breadth, not pinpoint lookups.
## Quick start
1. Parse the prompt → list **search targets** (names, patterns, behaviors)
2. Probe scale with a few `Glob` / `Grep` calls - count matches, list top dirs
3. Decide **SCALE** (number of agents) and divide the repo into **non-overlapping** scopes
4. (If SCALE ≥ 3) register Claude Tasks per agent - see `references/task-management-scouting.md`
5. Spawn agents **in parallel** in a single tool message
6. Aggregate into a **Scout Report** (template below)
## Configuration
External mode reads model from env (no per-user config files):
```bash
GEMINI_MODEL=gemini-3-flash-preview # default
OPENCODE_MODEL=opencode/grok-code # default
```
Both are optional. Unset → defaults above.
## Workflow
### 1. Analyze the task
- What exact thing is being searched? Name it (e.g. *"the dbt source for `payments_raw`"*, *"the K8s manifest that mounts the SOPS-encrypted secret"*).
- What dirs are obviously in-scope? What's obviously out-of-scope (vendor, generated, fixtures)?
- Estimate file count via `Glob` / `find . -type f` - this sets SCALE.
### 2. Divide and conquer
Pick **logical segments**, not arbitrary partitions - every agent gets one segment, no overlap. Example for a data-engineering repo:
```
Agent 1: models/staging, models/intermediate → dbt staging + intermediate
Agent 2: models/marts, snapshots/, seeds/ → dbt marts and seeds
Agent 3: macros/, tests/, analyses/ → reusable SQL + tests
Agent 4: dags/ or workflows/ → Airflow/Dagster/Prefect DAGs
Agent 5: schema.yml files (recursive) → sources, exposures, columns
Agent 6: lightdash/, lookml/, metabase/ → BI semantic layer
```
Derive segments from the repo's own layout, one subsystem per agent: software → feature / api / services / contracts / tests / config; infra → IaC / cluster manifests / CI / containers / secrets / env overlays; analytics → dashboards / charts / metrics / reports. Mixed repos → mix the patterns.
### 3. Register scout tasks (SCALE ≥ 3)
`TaskList()` first - reuse if a scout pipeline already exists this session. Otherwise `TaskCreate` per agent. Schema in `references/task-management-scouting.md`.
Skip task registration if SCALE ≤ 2 (overhead > benefit) or if Task tools are unavailable (use `TodoWrite` instead).
### 4. Spawn parallel agents
- **Internal:** load `references/internal-scouting.md` and spawn N `Explore` subagents in one Task tool message.
- **External:** load `references/external-scouting.md`. Pick `gemini` (SCALE ≤ 3) or `opencode` (SCALE 4-5). Wrap gemini with the resolved timeout wrapper (`gtimeout` on macOS - stock macOS has no `timeout`; the reference resolves it once per session).
- Each agent gets: explicit dir scope, search targets, **3-minute timeout**, and the report shape it must return.
- Each agent has <200K tokens - keep prompts terse, hand it the dir list, not the whole repo.
`TaskUpdate` each task to `in_progress` before spawning (skip if Task tools unavailable).
### 5. Collect and aggregate
- Skip non-responders after 3 minutes - log them as "timed out" in the report.
- `TaskUpdate` completed tasks. Mark timeouts in metadata, don't drop them silently.
- Deduplicate paths (different agents may surface the same file). Merge descriptions.
- **Where to save:** write to the injected `Reports:` path. Filename: `scout-{YYYYMMDD-HHMM}-{slug}.md`. Save **only** when the user is going to act on it; for one-shot lookups, print the report inline.
## Report format
```markdown
# Scout Report - {target}
_Date: {YYYY-MM-DD} · Mode: {internal|external} · SCALE: {N}_
## Relevant files
- `path/to/file.ext` - what's in it, why it matters here
- `path/to/another.ext` - …
## Patterns observed
- Convention X is used in {dirs}; convention Y in {dirs}
- Cross-cutting wire: A → B → C
## Surface map (if applicable)
- **Code:** …
- **Data:** dbt models / DAGs / sources implicated
- **Infra:** manifests, IaC modules, env overlays
- **BI:** dashboards / metrics referencing the above
## Gaps / unresolved
- Couldn't determine: …
- Timed out: agent N (scope: …)
- Worth a second pass: …
```
The "Surface map" section is only useful when the change spans disciplines. Drop it for pure-code scouts.
## References
- `references/internal-scouting.md` - Explore subagents (default mode)
- `references/external-scouting.md` - Gemini / OpenCode CLIs (`ext` mode)
- `references/task-management-scouting.md` - Claude Task patterns for coordinating agents
- `references/domain-scouting.md` - search-target playbooks per discipline (data eng, devops, analytics)
Pliki w paczce (5)
- SKILL.md 6 KB
- references/domain-scouting.md 3 KB
- references/external-scouting.md 4 KB
- references/internal-scouting.md 3 KB
- references/task-management-scouting.md 2 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · vanducng/skills | 100 | MIT |
| anton-abyzov/vskill | 100 | MIT |
| mcorbett51090/ravenclaude | 100 | MIT |
| kovrichard/portable-agent-layer | 100 | MIT |
| ahmad-punch/oss-contributor | 100 | MIT |
| udaysharmadev/Skills | 100 | MIT |
| dodobrands/scout | 100 | Apache-2.0 |
| vaayne/agent-kit | 100 | MIT |
| yandmed/skill-scout | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 61d348a15338 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90ck:scout
Szybko przeszukuje bazę kodu równoległymi agentami: odkrywanie plików, zbieranie kontekstu zadania i szybkie wyszukiwania w katalogach, z agentami wewnętrznymi i zewnętrznymi (Gemini, OpenCode). - 90vc:scout
Szybko przeszukuje bazę kodu w powłoce, a przy większym zadaniu uruchamia równoległe agenty badawcze. - 90vc:scout
Szybko rozpoznaje bazę kodu przez wyszukiwanie w shellu i opcjonalnych równoległych agentów badawczych: odnajduje pliki, zbiera kontekst zadania i przeszukuje wskazane katalogi. - 90vc:scout
Szybko rozpoznaje bazę kodu przez wyszukiwanie w shellu i opcjonalnych równoległych agentów badawczych: odnajduje pliki, zbiera kontekst zadania i przeszukuje wskazane katalogi. - 95codebase-explore
Analizuje bazę kodu wyłącznie do odczytu: sprawdza architekturę, szuka powiązanych plików i poznaje projekt przed zmianami. - 90dbt-and-analytics-engineering
Prowadzi przez analytics engineering w dbt: modele staging i marty, testy, snapshoty, dokumentacja, exposures i modele warstwy semantycznej.