# codemap

This skill uses the codemap CLI to search code by intent and inspect repository dependencies. Use it to locate symbols or investigate how files relate.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 167 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/codemap/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/codemap

## What it does

The skill routes questions to `codemap` commands for semantic search, symbol lookup, file summaries, and incoming or outgoing imports. It can also report file rankings, module coupling, and dependency cycles. When discovery points to specific files, it uses `Read` to inspect them.

Before relying on results, it checks the CLI version and repository index. A missing setup requires approval before `codemap init`, while a stale index is refreshed with `codemap index`. Empty or stale indexes are not reliable. For an exact text match, the skill favors `grep` over a codemap query.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills codemap
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill codemap -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/codemap/SKILL.md

## When to use it
- locate code that handles a described behavior
- find a function or class by its name
- trace imports into or out of a file
- identify circular dependencies between modules
- rank important files or inspect module coupling

## Example prompts
- Find where this project handles authentication and show the most relevant files.
- Look up the `UserService` symbol and trace which files depend on it.
- Check the project for circular dependencies and report the modules involved.

## Similar
- [code-explorer](https://affpapa.org/en/nevibecode/skills/code-explorer.md) — skill · 146 installs
- [coupling-analysis](https://affpapa.org/en/nevibecode/skills/coupling-analysis.md) — skill · ★ 7191 repo stars
- [audit-full](https://affpapa.org/en/nevibecode/skills/audit-full.md) — skill · 208 installs
- [testing-engineering](https://affpapa.org/en/nevibecode/rules/testing-engineering.md) — rule · ★ 517 repo stars
- [audit-dependencies](https://affpapa.org/en/nevibecode/commands/audit-dependencies.md) — command · ★ 1357 repo stars
- [GitHits](https://affpapa.org/en/nevibecode/mcp/githits.md) — MCP server · ★ 140 repo stars

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
