repo-map
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.
npx skills add mohitagw15856/pm-claude-skills --skill repo-map --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Repo Map Skill Agents burn their context windows on exploration: reading ten files to find the one, re-reading them next session, paying full price for code that was only ever navigation. The fix is the oldest one in computing — an index. This skill generates a compact, deterministic map (tree + line counts + top-level symbols via regex, no parser dependencies, nothing leaves the machine) and installs the discipline that makes it pay: *read the map first, open only the files whose names and symbols match the task.* The script prints its own economics: a typical map costs ~3% of reading everything. ## What This Skill Produces - **The map** — tree with per-file line counts and top-level symbols (functions, classes, types) for ~10 common languages - **The token math** — reading-everything vs. reading-the-map, printed in the header - **The navigation plan** — for the task at hand: which files the map says to open, which to skip - **The refresh rule** — when the map is stale and what it costs to regenerate (nothing — it's local and instant) ## Required Inputs Ask for these if not provided: - **The directory** — repo root or the subdirectory that matters (mapping `src/` beats mapping `
- What This Skill Produces
- Required Inputs
- Programmatic Helper
- Framework: The Navigation Discipline
- Output Format
- Navigation Plan (for: [the task])
- Quality Checks
- Anti-Patterns
- Based On
python3 scripts/repo_map.py . python3 scripts/repo_map.py src --max-files 400 --max-symbols 8
What does the repo-map skill do?
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.
How do I install it?
Run `npx skills add mohitagw15856/pm-claude-skills --skill repo-map --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From mohitagw15856/pm-claude-skills, a repository with 1,255 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.