skills.rest
htdxd
htdxdCOMMUNITY
Explore all skills by this author →
GitHub

codemap

Generate hierarchical CODEMAP.md index files for repositories with optional .analysis.md files for sources over 1,000 lines.

1|Updated Apr 28, 2026
Search Tags:#automation#indexing#codebase#subagents#code-navigation#large-files#codemap
One-click install
npx skills add https://github.com/htdxd/codemap-skill --skill codemap-htdxd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codemap
Source: https://github.com/htdxd/codemap-skill/tree/main
Command: npx skills add https://github.com/htdxd/codemap-skill --skill codemap-htdxd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CODEMAP.md index generation helps teams and agents quickly locate code across large repositories by providing hierarchical, directory-level summaries and export mappings, reducing search time and cognitive load. It creates per-directory CODEMAP.md files and optional deep-analysis files for very large sources.

Core Features & Use Cases

  • Hierarchical indexing: one CODEMAP.md per directory including a concise directory tree and file summaries.
  • Key Exports: per-directory aggregated symbols with source paths and line numbers to speed symbol location.
  • Large-file analysis: for files over 1000 lines, create a .analysis.md companion with structure mapping.
  • Parallel sub-agent support: distribute work across multiple agents for faster indexing.
  • Dual modes: learning (one-time generation) and maintenance (incremental via git).
  • Language-aware outputs: CODEMAP content mirrors user language.

Quick Start

Trigger the skill in a Claude Code session using /codemap or by saying "index this project" to start generating CODEMAP.md files.

Frequently Asked Questions about codemap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a hierarchical index for navigating a large codebase?▼

To navigate a large codebase, you generate hierarchical CODEMAP.md index files that provide per-directory summaries, file structures, and aggregated symbol locations with source paths and line numbers.

What is the best way to map symbols and structure in source files exceeding 1000 lines?▼

For files exceeding 1000 lines, the codebase indexing process automatically creates a companion .analysis.md file mapping the internal structure to speed up symbol location and deep analysis.

How do I incrementally maintain codebase index files after git commits?▼

You maintain codebase index files incrementally using the maintenance mode, which detects changes via git and updates the existing CODEMAP.md files without regenerating the entire repository structure.

Can I use parallel sub-agents to speed up repository indexing?▼

Yes, you can use parallel sub-agent orchestration to distribute directory indexing tasks across multiple agents, significantly speeding up the generation of CODEMAP.md files for large repositories.

Does the generated code map support language-aware output?▼

Yes, the generated CODEMAP.md content mirrors the user's language, ensuring the directory tree, file summaries, and symbol exports are output in the same language used during the session.

Related Skills

Explore More Software Engineering Skills→
SaintForeSaintFore

cartography

Map repository files and generate hierarchical codemap.md templates with change tracking.

Community
Intermediate
indoor47indoor47
9

ask

Answer codebase questions by tracing execution paths and referencing files.

Community
Advanced
dfpalhanodfpalhano

agentlens

Generate hierarchical documentation for codebase exploration and symbol localization.

Community
Intermediate
phanijappsphanijapps

engram-index

Index repositories and generate architectural maps with symbol and call analysis.

Community
Intermediate