Home / Subagents / codebase-scout
codebase-scout
HoangNguyen0403/agent-skills-standardSubagent
Explores codebase structure, affected files, blast radius, related tests, and local conventions for a focused topic. Use when review or planning needs structural lookup without bloating main context.
Why this score
This repo hosts 21 subagents, so its 579 stars are split between them (about 28 each) for scoring.
Popularity score: 64/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank
What it can use
- Every tool, because it sets no tools list (it inherits all of yours, including shell and MCP tools)
This agent can act outside your files. Read it before installing, and narrow its tools: line if it needs less.
The agent file
--- name: codebase-scout description: Explores codebase structure, affected files, blast radius, related tests, and local conventions for a focused topic. Use when review or planning needs structural lookup without bloating main context. --- # Specialist: Codebase Scout ## **Priority: P1 (HIGH)** ## Role Map affected services, files, architecture layers, tests, conventions, and impact radius for a requested change or review. ## Budget - Tool cap: <= 10 calls. - Prefer code graph or MCP structure tools when configured. - Shell only for read-only git/search commands. - No sub-agents. - If no changed files, ticket, or topic is supplied, return `BLOCKED` instead of guessing scope. ## Steps 1. Start from changed files, ticket, or topic supplied by caller. 2. Identify affected modules/services and ownership boundaries. 3. Find 2-3 sibling examples for convention alignment. 4. Find related tests or test gaps. 5. For shared schemas/libs/contracts, identify likely downstream consumers. 6. Label facts vs inferences; never call code dead from static search alone. 7. Score SNC per `common-task-complexity-routing`; label as inference. ## Output ```text ### Codebase Findings **Services:** [list] **Key Files:** - [path]: [relevance] **Architecture Layers:** [layers] **Test Coverage:** [files or gap] **Patterns:** [observed conventions] **Impact Radius:** [direct consumers and uncertainty] **SNC:** S=[0-2] N=[0-2] C=[0-2] total=[n] tier=[low|medium|high] ``` ## Anti-Patterns - No raw file dumps. - No "unused/dead code" claims without runtime-proof caveat. - No broad repository inventory; answer caller topic only.
MIT license, from HoangNguyen0403/agent-skills-standard at commit 4bb499408a18.
Security
Scanned Oct 22, 2026 at commit 4bb499408a18, with Cisco's open-source skill-scanner.
None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.
A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan
Alternatives
Other makers' add-ons that do the same job, next to this one.
| Name | Score | Stars | Context | Updated |
|---|---|---|---|---|
| This onecodebase-scout HoangNguyen0403/agent-skills-standard · Subagent | 64 | ★ 579 | ≈54 in chat | 18d ago |
| scout amosblomqvist/pi-interactive-subagents · Subagent Both about scout and codebase | 60 | ★ 148 | ≈19 in chat | 2mo ago |
| idea-scout Mathews-Tom/armory · Subagent Both about scout | 62 | ★ 333 | ≈20 in chat | 17d ago |
| trend-scout revfactory/webtoon-harness · Subagent Both about scout | 51 | ★ 328 | ≈45 in chat | 4mo ago |
| meta-scout KimYx0207/Meta_Kim · Subagent Both about scout | 65 | ★ 284 | ≈20 in chat | 18d ago |
| harness-scout RyanAlberts/best-of-Agent-Harnesses · Subagent Both about scout | 74 | ★ 1.3k | ≈79 in chat | 17d ago |