| name | write-docs |
| description | Triggered when user asks to write documentation, update README, add comments, or create technical docs. Automatically delegates to the docs-writer agent. |
| allowed-tools | Read, Write, Edit, Grep, Glob |
| context | fork |
| agent | docs-writer |
Write Docs Skill
Trigger Phrases
This skill is automatically triggered when the user:
- Asks to "write documentation" or "create docs"
- Requests README updates or documentation
- Wants to "add comments" or "document code"
- Mentions "documentation", "README", or "JSDoc"
- Asks about documenting APIs or features
Delegation Instructions
When this skill is triggered:
- Delegate immediately to the
docs-writer agent
- Specify what needs documentation
- Include documentation type (README, JSDoc, API docs, etc.)
- Provide code or feature context
- Include any documentation standards
Context to Pass
- Documentation Target: What to document (code, feature, API, etc.)
- Documentation Type: README, JSDoc, API docs, guides, etc.
- Code Context: Code or feature being documented
- Audience: Target audience (developers, users, etc.)
- Standards: Documentation standards or templates
- Examples: Any examples to include
Agent Responsibilities
The docs-writer agent will:
- Understand what needs documentation
- Write clear, comprehensive documentation
- Add appropriate code comments
- Include examples where helpful
- Follow documentation standards
- Ensure documentation is accurate and up-to-date
Usage Examples
Example 1: README Update
User: "Update the README with the new authentication feature"
Delegation: Delegate to docs-writer with:
- Type: README
- Feature: Authentication
- Context: New feature details
Example 2: JSDoc Comments
User: "Add JSDoc comments to the public API functions"
Delegation: Delegate to docs-writer with:
- Type: JSDoc
- Code: Public API functions
- Standards: JSDoc format
Example 3: API Documentation
User: "Document the new API endpoints"
Delegation: Delegate to docs-writer with:
- Type: API documentation
- Endpoints: New API endpoints
- Format: API doc format
Best Practices
- Delegate documentation to docs-writer
- Specify documentation type
- Provide code or feature context
- Include documentation standards
- Request comprehensive docs
