RM
Repo Map
🔵 Stable🕐 updated 2026-07-19
🔷 SkillSpec L3
⚙ ships an executable helper
pm-tokens
Navigate a codebase by map instead of reading files wholesale — a deterministic stdlib script that emits the tree with line counts and top-level symbols, plus the read-the-map-first discipline that cuts exploration tokens by an order of magnitude. Use when asked explore this repo efficiently, stop re-reading the whole codebase, make a map of this project, or which files should the agent actually open. Produces the compact map with its token math (map vs. everything), the navigation discipline, and the open-only-what-matches rule.
What to give it
▸The directory — repo root or the subdirectory that matters (mapping `src/` beats mapping `node_modules`' ancestors)
▸The task — the map is generic; the *navigation plan* needs to know what's being hunted (a bug in auth? the payment flow? where X is defined?)
▸Scale expectations — huge monorepos get mapped per-subdirectory (`--max-files` guards the map's own size; a 40,000-file map defeats itself)
✅ The bar it holds itself to
Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.
✓The map was generated before any wholesale file reading
✓The token comparison (map vs. everything) appears
✓The navigation plan shortlists by name/symbol match with reasons
✓Monorepos were mapped per-subdirectory, not defeated by their own size
✓The regex-symbols limitation is stated when the task is call-graph-shaped
⚠️ What it refuses to do
Do not read files to find out what's in them — that's the map's job at 3% of the price
Do not regenerate the map every turn — it's stable; put it once at the session's top
Do not oversell the symbols — top-level names, not semantics; grep and real parsers pick up where regex stops
Do not map the world — `--max-files` and subdirectory scoping exist because a bloated map is just a slower file dump
Do not skip the navigation plan — a map without a shortlist saved nothing yet
Install
npx pm-claude-skills add --agent claude # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcpRelated skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="repo-map"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>💬 Discussion
Repo Map is one of 750 open-source professional AI agent skills — all SkillSpec L3.
Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog