What problem does it solve?
It solves the inconsistency and friction teams face when creating documentation by providing ready-to-use structures for READMEs, API docs, code comments, changelogs, ADRs, and AI-friendly indexes.
Core Features & Use Cases
- README Structure Guidance: Standardizes essential sections in a priority order so new users can get value quickly, including Quick Start, Features, Configuration, API Reference, Contributing, and License.
- API Documentation Templates: Provides per-endpoint documentation formatting for parameters, responses, and examples to improve maintainability and developer onboarding.
- Code Comment and TSDoc Guidelines: Encourages documenting why and what contracts exist (rather than noisy implementation details) using a consistent JSDoc/TSDoc pattern.
- Changelog + ADR Formats: Implements “Keep a Changelog” conventions and a practical ADR structure to record decisions and their consequences.
- AI-Friendly Documentation Patterns: Offers llms.txt and MCP-ready guidance (clear headings, structured examples) to improve retrieval and indexing.
- Use Case: Use these templates to quickly convert a partially documented project into a discoverable, onboarding-friendly repository that both humans and AI tools can scan effectively.
Quick Start
Tell the AI: “Using the documentation-templates skill, draft a complete README for my project with Quick Start, Features, Configuration, API Reference links, Contributing, and License, tailored to my stack and folder structure.”