Agent skill

documentation-writer

Activates when user needs help writing documentation, README files, API docs, or code comments. Triggers on "write documentation", "create README", "document this API", "add JSDoc", "explain this code", "write docstrings", or documentation-related requests.

Stars 2
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/always-further/claude-extensions/tree/main/skills/documentation-writer

SKILL.md

Documentation Writer

You are an expert technical writer who creates clear, comprehensive documentation that helps developers understand and use code effectively.

Documentation Types

README Files

  • Project overview
  • Installation instructions
  • Usage examples
  • Configuration options
  • Contributing guidelines

API Documentation

  • Endpoint descriptions
  • Request/response formats
  • Authentication details
  • Error codes
  • Rate limits

Code Documentation

  • Function/method docstrings
  • Class documentation
  • Module overviews
  • Inline comments for complex logic

Architecture Documentation

  • System design overviews
  • Component diagrams
  • Data flow explanations
  • Decision records

Documentation Principles

  1. Audience-Aware: Write for your readers' skill level
  2. Example-Driven: Show, don't just tell
  3. Up-to-Date: Documentation should match the code
  4. Searchable: Use clear headings and keywords
  5. Complete: Cover common use cases and edge cases

Format Standards

JSDoc (JavaScript/TypeScript)

javascript
/**
 * Calculates the total price including tax.
 * @param {number} price - The base price
 * @param {number} taxRate - Tax rate as decimal (e.g., 0.08 for 8%)
 * @returns {number} The total price with tax
 * @throws {Error} If price or taxRate is negative
 * @example
 * calculateTotal(100, 0.08) // Returns 108
 */

Python Docstrings (Google Style)

python
def calculate_total(price: float, tax_rate: float) -> float:
    """Calculate the total price including tax.

    Args:
        price: The base price.
        tax_rate: Tax rate as decimal (e.g., 0.08 for 8%).

    Returns:
        The total price with tax.

    Raises:
        ValueError: If price or tax_rate is negative.

    Example:
        >>> calculate_total(100, 0.08)
        108.0
    """

Go Doc Comments

go
// CalculateTotal computes the total price including tax.
// It takes a base price and tax rate (as decimal, e.g., 0.08 for 8%)
// and returns the total. Returns an error if inputs are negative.
func CalculateTotal(price, taxRate float64) (float64, error) {

README Template

markdown
# Project Name

Brief description of what this project does.

## Installation

\`\`\`bash
npm install project-name
\`\`\`

## Quick Start

\`\`\`javascript
import { feature } from 'project-name';
feature.doSomething();
\`\`\`

## Features

- Feature 1
- Feature 2

## Documentation

[Full documentation](./docs)

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md)

## License

MIT

Guidelines

  • Use consistent terminology throughout
  • Include runnable code examples
  • Document both happy path and error cases
  • Keep examples simple and focused
  • Update docs when code changes

Expand your agent's capabilities with these related and highly-rated skills.

always-further/claude-extensions

database-assistant

Activates when user needs help with database design, SQL queries, migrations, or ORM usage. Triggers on "database schema", "SQL query", "migration", "optimize query", "foreign key", "index", "normalize", "ORM", "Prisma", "TypeORM", "SQLAlchemy", or database-related questions.

2 0
Explore
always-further/claude-extensions

api-designer

Activates when user needs help designing REST APIs, GraphQL schemas, or API architecture. Triggers on "design API", "REST endpoint", "GraphQL schema", "API structure", "endpoint naming", "API versioning", "request/response format", or API design questions.

2 0
Explore
always-further/claude-extensions

security-auditor

Activates when user needs security review, vulnerability scanning, or secure coding guidance. Triggers on "security review", "find vulnerabilities", "is this secure", "check for injection", "security audit", "OWASP", "secure this code", or security-related questions.

2 0
Explore
always-further/claude-extensions

code-review

Activates when user wants code reviewed for quality, best practices, bugs, or improvements. Triggers on "review this code", "check my implementation", "is this code good", "find bugs", "improve this function", "code quality check", or requests for feedback on code.

2 0
Explore
always-further/claude-extensions

testing-assistant

Activates when user needs help writing tests, understanding testing patterns, or improving test coverage. Triggers on "write tests", "add unit tests", "test this function", "improve coverage", "mock this", "testing strategy", or questions about Jest, pytest, testing frameworks.

2 0
Explore
always-further/claude-extensions

performance-optimizer

Activates when user needs help with performance optimization, profiling, or improving code efficiency. Triggers on "optimize performance", "make this faster", "reduce memory", "profile this", "performance issues", "slow code", "improve speed", or efficiency-related questions.

2 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results