API Documentation

API Documentation Workflow

Overview

Specialized workflow for creating comprehensive API documentation including OpenAPI/Swagger specs, developer guides, code examples, and interactive documentation.

When to Use This Workflow

Use this workflow when:

• Creating API documentation
• Generating OpenAPI specs
• Writing developer guides
• Adding code examples
• Setting up API portals

Workflow Phases

Phase 1: API Discovery

Skills to Invoke

• api-documenter - API documentation
• api-design-principles - API design

Actions

1. Inventory endpoints
2. Document request/response
3. Identify authentication
4. Map error codes
5. Note rate limits

Copy-Paste Prompts

Use @api-documenter to discover and document API endpoints

Phase 2: OpenAPI Specification

Skills to Invoke

• openapi-spec-generation - OpenAPI
• api-documenter - API specs

Actions

1. Create OpenAPI schema
2. Define paths
3. Add schemas
4. Configure security
5. Add examples

Copy-Paste Prompts

Use @openapi-spec-generation to create OpenAPI specification

Phase 3: Developer Guide

Skills to Invoke

• api-documentation-generator - Documentation
• documentation-templates - Templates

Actions

1. Create getting started
2. Write authentication guide
3. Document common patterns
4. Add troubleshooting
5. Create FAQ

Copy-Paste Prompts

Use @api-documentation-generator to create developer guide

Phase 4: Code Examples

Skills to Invoke

• api-documenter - Code examples
• tutorial-engineer - Tutorials

Actions

1. Create example requests
2. Write SDK examples
3. Add curl examples
4. Create tutorials
5. Test examples

Copy-Paste Prompts

Use @api-documenter to generate code examples

Phase 5: Interactive Docs

Skills to Invoke

• api-documenter - Interactive docs

Actions

1. Set up Swagger UI
2. Configure Redoc
3. Add try-it functionality
4. Test interactivity
5. Deploy docs

Copy-Paste Prompts

Use @api-documenter to set up interactive documentation

Phase 6: Documentation Site

Skills to Invoke

• docs-architect - Documentation architecture
• wiki-page-writer - Documentation

Actions

1. Choose platform
2. Design structure
3. Create pages
4. Add navigation
5. Configure search

Copy-Paste Prompts

Use @docs-architect to design API documentation site

Phase 7: Maintenance

Skills to Invoke

• api-documenter - Doc maintenance

Actions

1. Set up auto-generation
2. Configure validation
3. Add review process
4. Schedule updates
5. Monitor feedback

Copy-Paste Prompts

Use @api-documenter to set up automated doc generation

Quality Gates

• OpenAPI spec complete
• Developer guide written
• Code examples working
• Interactive docs functional
• Documentation deployed

Related Workflow Bundles

• documentation - Documentation
• api-development - API development
• development - Development

AGI Framework Integration

Adapted for @techwavedev/agi-agent-kit Original source: antigravity-awesome-skills

Memory-First Protocol

Cache workflow configurations and automation patterns. Retrieve prior pipeline designs to avoid re-building similar flows from scratch.

# Check for prior workflow/automation context before starting
python3 execution/memory_manager.py auto --query "automation patterns and workflow configurations for Api Documentation"

Storing Results

After completing work, store workflow/automation decisions for future sessions:

python3 execution/memory_manager.py store \
  --content "Workflow: automated data pipeline with retry logic, dead-letter queue, and Slack alerts on failure" \
  --type technical --project <project> \
  --tags api-documentation workflow

Multi-Agent Collaboration

Share workflow state with other agents so they can trigger, monitor, or extend the automation.

python3 execution/cross_agent_context.py store \
  --agent "<your-agent>" \
  --action "Workflow automation deployed — pipeline processing 1000+ events/day with 99.9% success rate" \
  --project <project>

Playbook Engine

Combine this skill with others using the Playbook Engine (execution/workflow_engine.py) for guided multi-step automation with progress tracking.