What do I need to use Repo Map?

The directory; The task; Scale expectations.

Is Repo Map free to use?

Yes — run it free in the browser playground (no API key needed for the sponsored trial, or bring any provider key), or install it into Claude Code, Cursor, ChatGPT and more via npx pm-claude-skills. MIT-licensed and open source.

Repo Map

Q: How do I know the Repo Map output is good?

The skill verifies itself against its own quality checks: 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.

🔵 Stable🕐 updated 2026-10-06 🔷 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.

▶ Run it free — no key needed 📝 Grade your existing draft ⬇ Add to Claude (works in Duet) 📱 Use as an app View SKILL.md ↗ What changed

🗣 Say this to your agent

“Explore this repo efficiently.”“Stop re-reading the whole codebase.”“Make a map of this project.”“Which files should the agent actually open?”

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 -p pm-claude-skills pm-claude-skills-mcp

Related 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 1326 open-source professional AI agent skills — all SkillSpec L3. Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog