About repo-map
repo-map is a skill for scanning repository assets, querying a graph, and checking coverage or drift. It requires a compatible graph runtime and produces basis-qualified results and derived navigation views.
Key features
- 01Bounded repository asset scans
- 02Graph queries and coverage checks
- 03Conflict and snapshot drift detection
- 04Derived navigation views
Use cases
- 01Query component identity, relations, or consumers
- 02Assess change impact and source authority
- 03Check graph coverage and snapshot staleness
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/repo-mapin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
agents/openai.yamlreferences/api-contract-map.mdchecklist.mdeval-cases.mdfrontend-inventory.mdgraph-operation-gates.mdjava-build-and-dependency-map.mdproject-grounding.mdproject-guidance.mdprompt-templates.mdreuse-index.mdusage.mdDetails
From the project READMERepository Map
Entry Gate
Own bounded repository asset scan, graph query, coverage/drift check, and derived navigation rendering. Require a compatible graph runtime, repository root, safe scope, and exact basis. Never substitute a hand-written map when the runtime is unavailable.
Route Map
| Request condition | Read | Result |
|---|---|---|
| Build/refresh an unambiguous graph snapshot | graph operation gates and usage | Validated bounded snapshot |
| Query identity, relation, consumer, impact, authority, coverage, conflict, or drift | graph operation gates and usage | Basis-qualified compact result |
| Root ownership or bounded source resolution is ambiguous | ambiguity checklist | Resolved bounded roots/source or safe stop |
| Need language/profile extraction detail | frontend inventory, API contract map, and/or Java build map | Profile-specific graph evidence |
| Cross-project/repository signal applies | project grounding | Qualified boundary result |
| Render requested navigation view | prompt templates | Derived, disposable view |
Invariants
- Reject scope escape; isolate and exclude run-local cache from scans.
- A graph/query miss is bounded
Not found, never proof of absence; stale snapshots remain stale. - Index native authorities without copying or authoring repository guidance, product/design contracts, source, runtime facts, or Git state.
Output Map
Return capability/version, basis, scope/exclusions, snapshot/query identity, coverage,
unresolved/conflict/stale state, and Not verified boundaries; renders name their input.
Reference Map
- Read graph operation gates for every scan/query. Read ambiguity checklist only when root ownership or bounded source resolution is ambiguous.
- Read usage for route examples and owner boundaries.
- Read frontend inventory, API contract map, Java build map, project grounding, reuse index, and prompt templates only when applicable.
- Read Project guidance only to recognize and reroute an explicit guidance create/bootstrap/update request; never use it as authoring instructions in
repo-map. - Maintainers only: read eval cases; do not load it during ordinary runtime.