Full-stack-skills documentation-builder

Generates structured technical documentation including API docs (OpenAPI/Swagger), README files, user guides, developer guides, and changelogs. Use when the user needs to create or improve project documentation, generate API reference docs, write onboarding guides, or structure documentation for a codebase.

install

source · Clone the upstream repo

git clone https://github.com/partme-ai/full-stack-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/partme-ai/full-stack-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/dev-utils-skills/documentation-builder" ~/.claude/skills/partme-ai-full-stack-skills-documentation-builder && rm -rf "$T"

manifest: skills/dev-utils-skills/documentation-builder/SKILL.md

When to use this skill

Use this skill whenever the user wants to:

Generate a project README with installation, usage, and contributing sections
Create API documentation from code or OpenAPI specs
Write developer onboarding or setup guides
Build user manuals or quick-start tutorials
Structure documentation for a new or existing project
Generate a CHANGELOG from commit history or release notes

How to use this skill

Workflow

Identify the doc type - README, API reference, user guide, developer guide, or changelog
Gather context - Read the codebase, existing docs, and project structure
Generate documentation - Use the templates and patterns below
Validate - Ensure all code examples run, links resolve, and sections are complete

README Template

# Project Name

Brief description of what the project does and why it exists.

## Quick Start

\`\`\`bash
npm install my-package
\`\`\`

\`\`\`typescript
import { MyClient } from 'my-package';
const client = new MyClient({ apiKey: process.env.API_KEY });
const result = await client.query('hello');
\`\`\`

## Features

- Feature one with brief explanation
- Feature two with brief explanation

## Installation

Detailed installation steps for different environments.

## Usage

Detailed usage examples with code snippets.

## API Reference

Link to full API docs or inline reference.

## Contributing

How to contribute, run tests, and submit PRs.

## License

License type and link.

API Documentation Pattern (OpenAPI)

paths:
  /users/{id}:
    get:
      summary: Get user by ID
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: User found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '404':
          description: User not found

Best Practices

Start with a quick-start - Let readers get running in under 2 minutes
Include runnable code examples - Every API endpoint or function should have a copy-paste example
Keep docs next to code - Co-locate documentation with the source it describes
Use consistent structure - Follow the same heading hierarchy across all doc pages
Version your docs - Tag documentation alongside code releases

Keywords

文档编写, documentation, README, API docs, OpenAPI, Swagger, user guide, 用户手册, developer guide, 开发指南, changelog, 技术文档