Documentation Templates

Solid collection of documentation templates that covers the usual suspects: READs, API docs, changelogs, ADRs, and code comments. The README structure is sensible with priority ordering, and I appreciate the "when to comment" table that actually discourages over-commenting. The AI-friendly section includes llms.txt templates, which feels timely for 2025. Most useful when you're staring at a blank markdown file and need a reasonable starting point. Nothing groundbreaking here, but that's the point. Sometimes you just need the standard template so you can stop bikeshedding and start writing.

skills.sh installs: 390
GitHub stars: 33.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add davila7/claude-code-templates --skill documentation-templates --agent claude-code

Installs into .claude/skills of the current project.

Files

Documentation Templates

Templates and structure guidelines for common documentation types.

1. README Structure

Essential Sections (Priority Order)

Section	Purpose
Title + One-liner	What is this?
Quick Start	Running in <5 min
Features	What can I do?
Configuration	How to customize
API Reference	Link to detailed docs
Contributing	How to help
License	Legal

README Template

# Project Name

Brief one-line description.

## Quick Start

[Minimum steps to run]

## Features

- Feature 1
- Feature 2

## Configuration

| Variable | Description | Default |
|----------|-------------|---------|
| PORT | Server port | 3000 |

## Documentation

- [API Reference](./docs/api.md)
- [Architecture](./docs/architecture.md)

## License

MIT

2. API Documentation Structure

Per-Endpoint Template

## GET /users/:id

Get a user by ID.

**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| id | string | Yes | User ID |

**Response:**
- 200: User object
- 404: User not found

SKILL.md on GitHub