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.

ScannedSubagentSource: GitHub
579 stars Updated 18d ago License MIT Context ≈54 tokens in your chat
64popular

Why this score

Stars10/35
Usage (forks)4/15
Upkeep25/25
License15/15
Owner history10/10

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.

NameScoreStarsContextUpdated
This onecodebase-scout HoangNguyen0403/agent-skills-standard · Subagent 64★ 579≈54 in chat18d ago
scout amosblomqvist/pi-interactive-subagents · Subagent Both about scout and codebase 60★ 148≈19 in chat2mo ago
idea-scout Mathews-Tom/armory · Subagent Both about scout 62★ 333≈20 in chat17d ago
trend-scout revfactory/webtoon-harness · Subagent Both about scout 51★ 328≈45 in chat4mo ago
meta-scout KimYx0207/Meta_Kim · Subagent Both about scout 65★ 284≈20 in chat18d ago
harness-scout RyanAlberts/best-of-Agent-Harnesses · Subagent Both about scout 74★ 1.3k≈79 in chat17d ago