About codebase-analyzer
A codebase analysis skill for developers who need to understand implementation, locate files, or document code paths. It separates file discovery, implementation tracing, and refactoring assessment into focused modes.
Key features
- 01File and functionality locator
- 02Implementation and data-flow tracing
- 03Technical debt assessment
- 04API and architecture documentation
- 05File:line references
Use cases
- 01Locate where a feature is implemented
- 02Trace data from entry point to exit
- 03Prepare code review documentation
- 04Identify refactoring opportunities
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/codebase-analyzerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
analysis-dimensions.mdconsolidation-patterns.mdreport-templates.mdevals/evals.jsonDetails
From the project READMECodebase Analyzer
Analyze implementation details, trace data flow, explain technical workings, and locate files.
Quick Reference
- analysis-dimensions.md - 8 analysis dimensions with detailed criteria
- consolidation-patterns.md - Common refactoring patterns with examples
- report-templates.md - Output format templates
When to Use
- Understanding how a specific feature works
- Finding where functionality is implemented
- Tracing data flow from entry to exit
- Assessing technical debt and refactoring opportunities
- Documenting API contracts and architecture
- Code review preparation
Analysis Modes
| Mode | Purpose | Output |
|---|---|---|
| Locator | Find file locations | File paths with descriptions |
| Analyzer | Trace implementation | Data flow with file:line refs |
| Consolidator | Assess debt/refactor | Debt report + recommendations |
Locator Strategy
Search Patterns
| Pattern | Purpose |
|---|---|
*service*, *handler* | Business logic |
*test*, *spec* | Test files |
*.config.* | Configuration |
Rust: src/, crates/ | Source files |
Output Format
## File Locations for [Feature]
### Implementation Files
- `src/services/feature.rs` - Main service logic
### Test Files
- `src/services/__tests__/feature.test.rs`
### Configuration
- `config/feature.json`
Analyzer Strategy
Step 1: Read Entry Points
- Start with main files mentioned
- Look for exports, public methods
Step 2: Follow Code Path
- Trace function calls step by step
- Note data transformations
Step 3: Document Key Logic
- Describe validation, error handling
- Explain complex algorithms
Guidelines
Do
✓ Include file:line references ✓ Read files thoroughly before explaining ✓ Trace actual code paths ✓ Group files logically by purpose ✓ Use multiple search patterns
Don't
✗ Guess about implementation ✗ Skip error handling ✗ Make architectural recommendations without context ✗ Analyze without clear goals
Remember
You are a documentarian. Map and explain, don't redesign.