| name | codebase-documenter |
| description | Create comprehensive, beginner-friendly documentation for codebases. Use when writing READMEs, architecture guides, code comments, or API documentation. |
Codebase Documenter
This skill enables creating comprehensive, beginner-friendly documentation for codebases. It provides structured templates and best practices for writing READMEs, architecture guides, code comments, and API documentation that help new users quickly understand and contribute to projects.
When to use this skill
- Creating or updating project READMEs.
- Writing architecture overviews for complex systems.
- Adding explanatory comments to non-obvious code.
- Documenting public APIs and interfaces.
- Onboarding new developers to the project.
Core Principles for Beginner-Friendly Documentation
- Start with the "Why": Explain purpose before implementation.
- Progressive Disclosure: Present information in layers (simple to complex).
- Provide Context: Why does this code exist?
- Include Examples: Always show concrete usage.
- Assume No Prior Knowledge: Define terms and avoid jargon.
- Visual Aids: Use diagrams, flowcharts, and file trees.
- Quick Wins: Help users get running in < 5 minutes.
Documentation Workflow
Step 1: Analyze the Codebase
- Identify entry points and map dependencies.
- Map core abstractions and configuration.
Step 2: Choose Documentation Type
- README: For root directories and major modules.
- Architecture: For system design and data flow.
- Code Comments: For complex logic and non-obvious algorithms.