map-project-monorepo — Claude Code skill: setup and features
map-project-monorepo builds self-contained CLAUDE.md files for every monorepo member and keeps the project root minimal.
no license 160 installs ★ 5 updated 2026-08-31
npx skills add ulpi-io/skills --skill map-project-monorepo -a claude-codeWhat map-project-monorepo does
This workflow inspects Cargo workspaces or multi-package repositories to map how packages interact. Instead of relying on raw pub or export visibility declarations, it tracks actual consumption paths, re-exports, manifests, and runtime entry points. It operates using standard local inspection tools: Read, Edit, Write, Glob, Grep, and Bash.
Every member package receives an isolated CLAUDE.md tailored for lazy loading by AI agents. Meanwhile, the root configuration stays lean, retaining high-level architecture decisions, testing baselines, and an inline directory of configured skills and MCP servers. The skill explicitly forbids autonomous background execution: it rewrites persistent repository memory across multiple directories, so it must run only on your direct command.
What it helps with
- strip detailed package documentation out of an overloaded root context file
- map the reachable public interface of individual crates or packages
- regenerate monorepo AI documentation after moving modules or dependencies
- catalog repository skills and active MCP servers inside the root guide
Example prompts for the agent
- /map-project-monorepo all crates
- /map-project-monorepo only packages/api-*
- /map-project-monorepo refresh workspace docs after adding the sql crate
How to install map-project-monorepo
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project-monorepo -a claude-code2Manually: put the files in place
~/.claude/skills/map-project-monorepo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/map-project-monorepo/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project-monorepo -a codex2Manually: put the files in place
.agents/skills/map-project-monorepo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project-monorepo -a cursor2Manually: put the files in place
.cursor/skills/map-project-monorepo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills map-project-monorepo2Manually: put the files in place
.github/skills/map-project-monorepo/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project-monorepo -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path map-project-monorepoManually: put the files in place
.devin/skills/map-project-monorepo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill map-project-monorepo -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-monorepo
How to install map-project-monorepo in Claude Code?
Run npx skills add ulpi-io/skills --skill map-project-monorepo -a claude-code. The skill will be placed into ~/.claude/skills/map-project-monorepo/SKILL.md.
What does map-project-monorepo do?
It explores workspace structure, captures the true reachable surface of each package, and creates local CLAUDE.md files while slimming down the root document.
Can it run on a single-application repository?
No, it targets multi-package workspaces; single-app codebases should use map-project instead.