Codebase graph scout
Skill Arnie016/codex-prompt-templates/skills/codebase-graph-scout
Use graph-backed or semantic codebase intelligence before editing. Use when tasks need symbol search, blast radius, affected tests, architecture health, dependency paths, large-codebase context, Roam, CodeAlive, GraphRAG, or MCP code search. Skip for tiny scripts where rg/read is enough.From its SKILL.md
npx -y skills add Arnie016/codex-prompt-templates --skill codebase-graph-scoutAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 6 commands, including `roam init` and 5 more.
SKILL.md
1.6 KB, 305 tokens by cl100k_base, as published. Nobody here has run it
Codebase Graph Scout
Prefer graph tools when the repo is large enough that raw file reading will waste context.
Tool Preference
| Available tool | Use for |
|---|---|
roam-code | local symbol graph, preflight, impact, health, affected tests |
| CodeAlive MCP | hosted semantic/GraphRAG code search with API key |
rg + manifests | fallback for small repos or missing graph tools |
Roam Loop
roam init
roam health
roam understand
roam context <symbol>
roam preflight <symbol>
roam affected-tests <symbol>
Use --json for parsing and --budget <n> when context is tight.
CodeAlive Loop
- List data sources.
- Run
semantic_searchorgrep_search. - Fetch only the relevant artifacts.
- Expand relationships for the smallest useful set.
- Use chat/synthesis only after search results are insufficient.
Output
Return:
- symbols/files to read
- edit risk
- likely tests
- dependency or call paths that matter
- what not to touch
Reference source patterns in references/source-repos.md.
Validation
- The returned file/symbol set is smaller than a broad repo read.
- Claimed impact paths cite graph/search output or exact files.
- If graph tools are unavailable, the fallback
rg/manifest path is stated.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.