documentation-templates
SKILL.md
Documentation Templates Skill
Create clear, maintainable documentation for projects and code.
Resources
For full templates, see:
references/readme-template.md- Complete README templatereferences/api-docs-template.md- API documentation template
Core Principles
- Explain Why, Not What - Code shows what; docs explain why
- Keep it Updated - Outdated docs are worse than no docs
- Write for Humans - Clear, concise, jargon-free
- Progressive Disclosure - Start simple, provide details on demand
- Examples are King - Show, don't just tell