Context

Context

• Project files: !find . -maxdepth 1 \( -name 'pyproject.toml' -o -name 'package.json' -o -name 'Cargo.toml' -o -name 'go.mod' \)
• Existing docs: !find . -maxdepth 1 \( -name 'README.md' -o -type d -name 'docs' \)
• Source files: !find . -type f \( -name "*.py" -o -name "*.ts" -o -name "*.js" \)
• Python with docstrings: !grep -r "\"\"\"" --include="*.py" -l

Parameters

• --api: Generate API reference documentation
• --readme: Update README.md based on code analysis
• --changelog: Update CHANGELOG.md from git history

Your task

Delegate this task to the documentation agent.

Use the Agent tool with subagent_type: documentation to generate or update project documentation. Pass all the context gathered above and the parsed parameters to the agent.

The documentation agent should:

1. Analyze codebase:

   • Extract docstrings and type annotations
   • Identify public API surface
   • Map module structure and dependencies
   • Find usage examples in tests

2. Generate requested documentation:

   If --api:

   • Create API reference from docstrings
   • Document function signatures and types
   • Include usage examples
   • Generate module hierarchy

   If --readme:

   • Update project description
   • Document installation steps
   • Add usage examples
   • Update feature list
   • Ensure badges are current

   If --changelog:

   • Parse conventional commits
   • Group by version/release
   • Categorize by type (feat, fix, docs, etc.)
   • Include breaking changes prominently

   If no flags: Generate all documentation

3. Follow documentation standards:

   • Clear, concise language
   • Consistent formatting
   • Working code examples
   • Accurate cross-references

4. Output summary:

   • Files created/updated
   • Documentation coverage metrics
   • Suggested improvements

Provide the agent with:

• All context from the section above
• The parsed parameters
• Detected documentation framework (if any)

The agent has expertise in:

• Multi-language documentation extraction
• API reference generation
• README best practices
• Changelog automation from commits
• GitHub Pages integration

Agent Teams (Optional)

For large projects, spawn teammates for parallel documentation generation:

Teammate	Focus	Value
API docs teammate	Extract and generate API reference	Parallel with README generation
README teammate	Update project README and guides	Parallel with API docs
Changelog teammate	Generate changelog from git history	Independent of other doc tasks

This is optional — the skill works with a single agent for most projects.