Codebase Map

Build a persistent, evidence-based map of a software repository inside docs/codebase-map/ - TL;DR, architecture and dependency diagrams in Mermaid, real data flows traced with an archetype-specific strategy, the most important files ("the spine"), a reading order, potentially AI-assisted code, key concepts, and open questions. Five modes - "codebase-map init" builds the full map, "codebase-map update" refreshes it after changes, "codebase-map explain [topic]" covers one feature or domain, "codebase-map trace [flow]" follows one request path, "codebase-map check" reports drift without writing.

7 starsSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add rdilruba/codebase-map --skill codebase-map

Manual install

git clone --depth 1 https://github.com/rdilruba/codebase-map.git /tmp/codebase-map
mkdir -p ~/.claude/skills
cp -r /tmp/codebase-map/. ~/.claude/skills/codebase-map

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Codebase Map

## Purpose

Build a persistent, evidence-based mental model of a software repository.

The goal is not merely to document the codebase.

The goal is to help the developer understand:

* how the system is structured
* where important logic lives
* how components depend on each other
* how real user requests move through the system
* which files are worth reading first
* which concepts are central to the application
* where AI-assisted or unfamiliar code may require additional attention
* what is still unknown

The output must remain inside the repository so it can be reused by the developer and future coding agents.

---

# Commands

The skill supports five modes. Accept them as commands, as natural language, or as a mix of both — `codebase-map update`, `/codebase-map update`, and "update the codebase map" all mean the same thing.

Resolve the mode before doing any work. When the mode is ambiguous, apply the default resolution rules below rather than asking, unless the choice would waste significant effort.

| Command | Mode | What it does |
| --- | --- | --- |
| `codebase-map` or `codebase-map init` | INIT | Full workflow. Build the complete map from scratch. |
| `codebase-map update` | UPDATE | Re-inspect the repository, refresh what changed, preserve what is still accurate. |
| `codebase-map explain <topic>` | EXPLAIN | Focused analysis of one feature, domain, or module. |
| `codebase-map trace <flow>` | TRACE | Trace a single user-facing flow end to end. |

Read the full skill on GitHub

Details

Skill name: codebase-map
Repository: rdilruba/codebase-map
License: MIT
Repo updated: 11 September 2026

FAQ

What does the Codebase Map skill do?

How do I install the Codebase Map skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add rdilruba/codebase-map --skill codebase-map. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Codebase Map popular?

It lives in rdilruba/codebase-map, which has 7 GitHub stars and 0 forks.

Related skills

Mcd Status Codes

chaucerj/mcd-status-codes

麦门监控台 —— 主动运维型身体 SRE。把每一笔麦当劳订单判定为 HTTP 状态码（双方向语义宪法 v4.0：18 码 + 3 指标告警），Agent 依据代谢模型（体重/身高/年龄→BMR→TDEE→分餐预算）在咖啡窗与补给窗主动探活提醒：该喝没喝的咖啡判 599 超时、减脂缺口下发 103 下午茶建议、超预算 412 否决、异常订单自动生成 P1-P3 事故复盘。当用户想回顾麦当劳订单、查看热量/营养/健康合规、生成监控面板或状态码报告、听取主动补给提醒、复盘事故或查询自己的 SRE 职级，或询问 1024 程序员节限定玩法时使用。基于麦当劳中国官方 MCP 只读采集，全部数值确定性可复算。

Software Development

Adobe Fonts Skill

alexh/adobe-fonts-skill

Search Adobe Fonts (Typekit) families, create and manage web kits/projects, and return ready-to-use embed snippets plus CSS font-family values. Use when the user asks to find Adobe fonts, compare font options, set up Typekit for a website, add fonts to kits, publish kits, or generate copy/paste font embed metadata for Codex, Claude Code, or OpenCode workflows.

Software Development

Safe Encryption

grittygrease/safe-encryption-skill

Encrypt, decrypt, and manage keys with the SAFE CLI — a modern GPG alternative with post-quantum support.

Software DevelopmentIn 1 list

Code Feeder

Ecrypted-Data/Code_Feeder_Skill

当用户需将代码提供给外部 AI（重构/分析/修复）时激活。自动收集代码、记录意图、生成上下文文档。支持增量合并。

Software Development

Steam Debug

kmturley/steam-debug

Inspect, debug, and inject custom code into a running Steam client — desktop (macOS, Linux, Windows) or Steam Deck over the network — through its Chromium Embedded Framework (CEF) Chrome DevTools Protocol endpoint. Use when developing Steam UI plugins, mods, themes, or integrations — injecting CSS/JS to try a change, locating webpack modules and obfuscated class names, reading React or SteamUIStore state, inspecting Big Picture / Quick Access Menu windows, screenshotting what actually rendered, streaming console logs, or diagnosing runtime errors in Steam's UI. The same commands run against ei

Software Development

Automotive Syseng

duonghvu/automotive-syseng

When the user wants to analyze automotive requirements, check INCOSE/EARS compliance, review MISRA-C code, assess ADAS levels, or verify ISO 26262/AUTOSAR/SOTIF conformance. Also use when the user says 'check requirements', 'EARS check', 'INCOSE analysis', 'MISRA check', 'ASIL assessment', 'V-model check', 'requirements breakdown', 'ADAS level', 'AUTOSAR review', 'SOTIF analysis', 'functional safety', or 'requirements quality'. For general code review, see review.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.