map-project — Claude Code skill: what it does, how to install
map-project inspects a single-app repository to build a concise CLAUDE.md router alongside detailed reference guides.
no license 176 installs ★ 5 updated 2026-08-31
npx skills add ulpi-io/skills --skill map-project -a claude-codeWhat map-project does
This skill builds an accurate context map for coding agents by parsing the source tree. It identifies the application framework, routes, exports, local repository skills under .claude/skills/, and MCP setups. Extensive findings move into separate reference guides, leaving CLAUDE.md as an uncluttered router that stays well within context limits.
The routine executes across five steps: scoping, code inventory discovery, reference file generation, router compilation, and verification against size budgets. Existing human-authored rules inside CLAUDE.md remain intact rather than getting overwritten.
Monorepos and Cargo workspaces will break this specific workflow. The skill operates strictly on single-application trees and requires direct user execution to alter repository files.
What it helps with
- refresh agent memory following an architecture refactor
- inventory real routes, services, and exports directly from source code
- document active MCP servers and repository skills for the assistant
- condense bloated CLAUDE.md files into lean routing documents
Example prompts for the agent
- /map-project
- update CLAUDE.md for this repo after auth refactor
- /map-project api only
How to install map-project
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project -a claude-code2Manually: put the files in place
~/.claude/skills/map-project/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/map-project/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project -a codex2Manually: put the files in place
.agents/skills/map-project/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project -a cursor2Manually: put the files in place
.cursor/skills/map-project/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills map-project2Manually: put the files in place
.github/skills/map-project/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path map-projectManually: put the files in place
.devin/skills/map-project/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about map-project
How do I install map-project in Claude Code?
Run npx skills add ulpi-io/skills --skill map-project -a claude-code. The skill file gets installed directly to ~/.claude/skills/map-project/SKILL.md.
What does map-project do?
It scans your application code to locate endpoints, models, and tooling configs, then generates structured reference files along with an updated CLAUDE.md.
Does map-project support monorepos?
No, it targets standalone single applications. For Cargo workspaces or multi-package repositories, use map-project-monorepo instead.