Codebase Indexing Skill for Claude Code

A Claude Code skill that enables systematic codebase indexing and mapping to build comprehensive understanding of project structure, dependencies, and architecture.

Installation

Copy the .claude/skills/codebase-indexing/ directory to your project or user skills folder:

# For project-level (shared via git)
cp -r .claude/skills/codebase-indexing your-project/.claude/skills/

# For user-level (personal, all projects)
cp -r .claude/skills/codebase-indexing ~/.claude/skills/

Usage

Once installed, Claude will automatically use this skill when you:

• Ask to "index the codebase"
• Ask to "map this project"
• Ask to "understand the architecture"
• Start working on an unfamiliar codebase

Or invoke it directly by asking Claude to use the codebase-indexing skill.

What It Does

The skill guides Claude through a systematic 4-phase indexing process:

1. Project Overview - Identify stack, read configs, map directory structure
2. Entry Points & Core - Find main files, identify hub modules
3. Architecture Mapping - Map dependencies, identify patterns, trace data flow
4. Key Patterns - Document conventions and critical paths

Files

.claude/skills/codebase-indexing/
├── SKILL.md                           # Main skill definition
└── reference/
    ├── language-patterns.md           # Language-specific indexing patterns
    └── architecture-detection.md      # Architecture pattern detection guide

License

MIT