How do I install the Codemap skill?

Run npx skillmds@latest add shalomb/codemap in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codemap safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codemap?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codemap free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codemap?

shalomb (@shalomb) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codemap by shalomb — Agent Skill

Name: Codemap
Author: shalomb

Codemap

Analyze codebase structure, dependencies, changes, and multi-agent handoffs using codemap. Use this skill as the primary entry point when a task requires understanding project architecture, mapping dependencies, tracing logic, or generating cross-agent handoff artifacts. Always trigger this first when exploring unfamiliar code or when codemap output indicates noisy configurations.

shalomb b408de6 2 files · 4.4 KB Updated Sep 17, 2026

File contents

Codemap

Gives instant architectural context: project tree, dependency flow, hub detection, diff, intent classification, and multi-agent handoff.

Commands

codemap .                       # Project tree with file counts and top files
codemap --deps .                # Dependency flow + hub files (requires ast-grep)
codemap --diff                  # Changes vs main branch
codemap --diff --ref <branch>   # Changes vs specific branch
codemap --importers <file>      # Who imports this file? Is it a hub?
codemap handoff .               # Build + save cross-agent handoff artifact
codemap handoff --latest .      # Read latest saved handoff
codemap skill list              # Show available skills
codemap skill show <name>       # Load full skill instructions
codemap config show             # Show current project config
codemap context --compact       # Minimal JSON context envelope

First-Use Setup

Before deeper analysis in a new repo:

Run codemap . — if output is noisy or config is missing, run codemap skill show config-setup first
Run codemap --deps . — dependency graph and hub files
Config is repo memory: once tuned, all future calls benefit automatically

When to use

Situation	Command
Starting any task	`codemap .`
"Where is X?" / "What uses Y?"	`codemap --deps .`
About to edit a file	`codemap --importers <file>`
"What changed?" / before committing	`codemap --diff`
Switching agents / resuming work	`codemap handoff .`
Config missing or output noisy	`codemap skill show config-setup`
Risk warning in hook output	`codemap skill show <matched-skill>`

Hook output

The prompt-submit hook fires on every message and emits:

<!-- codemap:intent {"category":"refactor","risk":"high",...} -->
<!-- codemap:skills [{"name":"hub-safety","score":5},...] -->
Skills matched: hub-safety, explore — run `codemap skill show <name>` for guidance

Skills are pull-based — names are surfaced automatically, full body loaded only when needed.

Builtin skills

Skill	When to load
`config-setup`	Config missing, boilerplate, or output noisy
`hub-safety`	Editing a file with 3+ importers
`explore`	Understanding how code works
`handoff`	Switching between agents

Reference

For MCP tools and HTTP API endpoints, load references/codemap-api.md.

---name: codemapdescription: Analyze codebase structure, dependencies, changes, and multi-agent handoffs using codemap. Use this skill as the primary entry point when a task requires understanding project architecture, mapping dependencies, tracing logic, or generating cross-agent handoff artifacts. Always trigger this first when exploring unfamiliar code or when codemap output indicates noisy configurations.---# CodemapGives instant architectural context: project tree, dependency flow, hub detection, diff, intent classification, and multi-agent handoff.## Commands```bashcodemap . # Project tree with file counts and top filescodemap --deps . # Dependency flow + hub files (requires ast-grep)codemap --diff # Changes vs main branchcodemap --diff --ref <branch> # Changes vs specific branchcodemap --importers <file> # Who imports this file? Is it a hub?codemap handoff . # Build + save cross-agent handoff artifactcodemap handoff --latest . # Read latest saved handoffcodemap skill list # Show available skillscodemap skill show <name> # Load full skill instructionscodemap config show # Show current project configcodemap context --compact # Minimal JSON context envelope```## First-Use SetupBefore deeper analysis in a new repo:1. Run `codemap .` — if output is noisy or config is missing, run `codemap skill show config-setup` first2. Run `codemap --deps .` — dependency graph and hub files3. Config is repo memory: once tuned, all future calls benefit automatically## When to use| Situation | Command ||---|---|| Starting any task | `codemap .` || "Where is X?" / "What uses Y?" | `codemap --deps .` || About to edit a file | `codemap --importers <file>` || "What changed?" / before committing | `codemap --diff` || Switching agents / resuming work | `codemap handoff .` || Config missing or output noisy | `codemap skill show config-setup` || Risk warning in hook output | `codemap skill show <matched-skill>` |## Hook outputThe `prompt-submit` hook fires on every message and emits:```Skills matched: hub-safety, explore — run `codemap skill show <name>` for guidance```Skills are pull-based — names are surfaced automatically, full body loaded only when needed.## Builtin skills| Skill | When to load ||---|---|| `config-setup` | Config missing, boilerplate, or output noisy || `hub-safety` | Editing a file with 3+ importers || `explore` | Understanding how code works || `handoff` | Switching between agents |## ReferenceFor MCP tools and HTTP API endpoints, load `references/codemap-api.md`.

Frequently asked questions

Codemap

File contents

Codemap

Commands

First-Use Setup

When to use

Hook output

Builtin skills

Reference

Related skills

Frequently asked questions

How do I install the Codemap skill?

What does the Codemap skill do?

Is Codemap safe to use?

Which AI agents work with Codemap?

Is Codemap free to use?

Who published Codemap?