← Back to Skills

API Documentation Writer

Create comprehensive, developer-friendly API documentation including quickstart guides, endpoint references, authentication guides, error documentation, and multi-language code examples following industry best practices.

Gold
v1.0.00 activationsSoftware EngineeringEngineeringintermediate

SupaScore

84.5
Research Quality (15%)
8.5
Prompt Engineering (25%)
8.5
Practical Utility (15%)
8.6
Completeness (10%)
8.4
User Satisfaction (20%)
8.3
Decision Usefulness (15%)
8.4

Best for

  • REST API documentation for developer onboarding and time-to-first-call optimization
  • GraphQL schema documentation with mutation examples and error handling guides
  • Webhook documentation including payload schemas, retry logic, and security practices
  • OpenAPI spec enhancement with comprehensive examples and authentication flows
  • Developer portal architecture following Diataxis framework (tutorials, how-tos, reference, explanation)

What you'll get

  • Complete quickstart guide with 5-minute time-to-first-call including cURL and SDK examples with actual response bodies
  • Comprehensive endpoint reference with request/response schemas, error codes, rate limits, and authentication requirements
  • Multi-section documentation architecture with tutorials, how-to guides, reference materials, and conceptual explanations following Diataxis framework
Not designed for ↓
  • ×Marketing or sales documentation for non-technical audiences
  • ×Internal code comments or inline documentation
  • ×End-user product manuals or customer-facing help docs
  • ×Legal API terms of service or privacy policy writing
Expects

OpenAPI specification, Postman collection, or endpoint list with authentication details and target developer audience context.

Returns

Structured API documentation site with quickstart guide, endpoint reference, authentication guide, error documentation, and multi-language code examples.

Evidence Policy

Enabled: this skill cites sources and distinguishes evidence from opinion.

api-documentationtechnical-writingopenapirest-apigraphqldeveloper-experiencequickstartendpoint-referenceerror-handlingcode-exampleswebhookdiataxis

Research Foundation: 7 sources (2 official docs, 2 books, 2 web, 1 industry frameworks)

This skill was developed through independent research and synthesis. SupaSkills is not affiliated with or endorsed by any cited author or organisation.

Version History

v1.0.02/16/2026

Initial release

Works well with

Need more depth?

Specialist skills that go deeper in areas this skill touches.

Common Workflows

Complete API Development Lifecycle

Design API contracts, create comprehensive documentation, then establish ongoing lifecycle management processes

Activate this skill in Claude Code

Sign up for free to access the full system prompt via REST API or MCP.

Start Free to Activate This Skill

© 2026 Kill The Dragon GmbH. This skill and its system prompt are protected by copyright. Unauthorised redistribution is prohibited. Terms of Service · Legal Notice