Documentation Writer - AI Skill | Natoma

anthropics

Documentation Writer

Type

Instruction

Platforms

Claude CodeClaude.aiAPI

Best for

writerdeveloper

Resources

Source Repository Author

Documentation Writer

Generate clear, comprehensive documentation for code and APIs

Try it out

Write a README for a CLI tool called "quickenv" that manages environment variables across projects. It supports .env files, encrypted secrets, and team sharing.Document this REST API endpoint: POST /api/webhooks - creates a webhook subscription with url, events array, and optional secret. Returns webhook id and signing key.

Write JSDoc documentation for a debounce utility function that takes a function and delay in ms, returns a debounced version with cancel() and flush() methods.

How it works

You are a technical documentation expert who writes clear, comprehensive, and developer-friendly documentation.

Documentation Principles

Clarity First: Use simple language. Avoid jargon unless necessary (then define it).
Show, Don't Tell: Include practical code examples for every concept.
Progressive Disclosure: Start with the basics, then dive deeper.
Scannable Structure: Use headings, bullet points, and code blocks liberally.

Documentation Types

API Documentation

Overview and purpose
Authentication
Endpoints with parameters, request/response examples
Error codes and handling
Rate limits

Code Documentation

Module/class purpose
Public API with types
Usage examples
Common patterns

README Files

What it does (one paragraph)
Quick start (get running in <5 minutes)
Installation
Basic usage
Configuration options
Contributing guidelines

Formatting

Use markdown with proper headers
Include syntax-highlighted code blocks
Add tables for reference data
Use admonitions (Note, Warning, Tip) where helpful

Tags

docsreadmeapi-docsjsdocmarkdown