codemap
Generate navigational codebase maps with architecture diagrams. Use when mapping a codebase, creating architecture docs, visualizing project structure, generating infrastructure diagrams, understanding repo layout, or onboarding to a new project.
npx skills add majiayu000/claude-skill-registry --skill codemap-antoniocascais-claude-code-toolkit --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Codemap Generator Generate `CODEMAP.md` files that help humans and AI agents navigate codebases. ## Output Separation - **CODEMAP.md** = Auto-generated navigation map (this skill creates/updates) - **ARCHITECTURE.md** = Hand-written design decisions (never touch) ## Workflow ### Phase 1: Project Analysis 1. **Count files** to determine project size: - Use Glob with pattern `**/*` excluding vendored paths - Exclude: `node_modules/`, `vendor/`, `__pycache__/`, `target/`, `.terraform/`, `.*` - Count results to determine depth 2. **Detect project type(s)**: - Check for IaC patterns (Terraform, Ansible, K8s, etc.) - Check for application code (package.json, go.mod, requirements.txt, etc.) - Projects can be mixed (app + infra) 3. **Set depth based on file count**: | Files | Depth | Output | |-------|-------|--------| | <50 | shallow | Single root CODEMAP.md | | 50-500 | medium | Root + key directories | | >500 | deep | Root + 2 levels, skip vendored | ### Phase 2: Existing File Check **STOP. Check for existing CODEMAP.md before proceeding.** Before generating, check if `CODEMAP.md` exists. **If exists**: Use `AskUserQuestion` with options: - Overwrite completely - Merge/update (preserv
- Output Separation
- Workflow
- Phase 1: Project Analysis
- Phase 2: Existing File Check
- Phase 3: Content Generation
- Phase 4: Output
- Detection Patterns
- Application Code
- Infrastructure as Code
- Mermaid Diagram Patterns
- Code Architecture (Component Relationships)
- Infrastructure Topology
- Module Hierarchy (Terraform)
- Analysis Techniques
ast-grep --pattern 'import $_ from "$SOURCE"' --lang ts
ast-grep --pattern 'require("$SOURCE")' --lang js
ast-grep --pattern 'from $MODULE import $_' --lang python
ast-grep --pattern 'import $MODULE' --lang python
ast-grep --pattern 'import "$PKG"' --lang go
terraform graph | # convert DOT to mermaidWhat does the codemap skill do?
Generate navigational codebase maps with architecture diagrams. Use when mapping a codebase, creating architecture docs, visualizing project structure, generating infrastructure diagrams, understanding repo layout, or onboarding to a new project.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill codemap-antoniocascais-claude-code-toolkit --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.