# map-project-monorepo

map-project-monorepo builds self-contained CLAUDE.md files for every monorepo member and keeps the project root minimal.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 160 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/map-project-monorepo/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/map-project-monorepo

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project-monorepo -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/map-project-monorepo/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/map-project-monorepo/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project-monorepo -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/map-project-monorepo/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project-monorepo -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/map-project-monorepo/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills map-project-monorepo
```

2. **Manually: put the files in place**
- File: `.github/skills/map-project-monorepo/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project-monorepo -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path map-project-monorepo
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/map-project-monorepo/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project-monorepo -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ulpi-io/skills/tree/HEAD/map-project-monorepo/SKILL.md

## When to use it
- 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
- /map-project-monorepo all crates
- /map-project-monorepo only packages/api-*
- /map-project-monorepo refresh workspace docs after adding the sql crate

## Similar
- [project-memory](https://affpapa.org/en/nevibecode/skills/project-memory.md) — skill · 180 installs
- [project-context](https://affpapa.org/en/nevibecode/skills/project-context.md) — skill · ★ 134 repo stars
- [monorepo](https://affpapa.org/en/nevibecode/skills/monorepo.md) — skill · 741 installs
- [monorepo-tamagui](https://affpapa.org/en/nevibecode/skills/monorepo-tamagui.md) — skill · 717 installs
- [monorepo-navigator](https://affpapa.org/en/nevibecode/skills/monorepo-navigator.md) — skill · 591 installs
- [monorepo-setup](https://affpapa.org/en/nevibecode/skills/monorepo-setup.md) — skill · 283 installs

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
