# Repo Map

> Generate a ranked codebase map showing key files and relationships

- Skill: `majiayu000/repo-map-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/repo-map-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/repo-map-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/repo-map-2

---


# Codebase Map Generator

Generate a graph-ranked map of the codebase showing the most important files, dependencies, and call relationships.

## What To Do

1. **Analyze the repository structure**: Use Glob to find all source files, count per directory, identify entry points.

2. **Rank files by importance**:
   - Fan-in (how many files reference this file) -- higher = more important
   - Fan-out (how many files this file imports) -- moderate = hub file
   - Size and change frequency via `git log`
   - Entry points (Controllers, Program.cs, App.tsx) rank highest

3. **Generate the map** as structured summary:
   ```
   ## Core (highest rank)
   src/backend/Program.cs                    -- Entry point, DI registration
   src/backend/Services/MatchingService.cs   -- Core matching algorithm (12 refs)

   ## API Layer
   src/backend/Controllers/CandidateController.cs -- 8 endpoints

   ## Domain
   src/backend/Models/CandidateProfile.cs    -- Central model (18 refs)
   ```

4. **Focus mode**: When `--focus=<module>`, zoom into that module with full dependency graph.

## Arguments
- `--depth=<n>`: Directory tree depth (default: 2)
- `--focus=<module>`: Focus on specific module
- `--format=<md|mermaid|json>`: Output format