← Back to Skills

Technical Writing Expert

Expert technical writing advisor for documentation architecture, API documentation (OpenAPI/Swagger), user guides, style guides, docs-as-code workflows, the Diataxis framework, information design, and content reuse strategies.

Gold
v1.0.00 activationsCommunicationBusinessintermediate

SupaScore

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

Best for

  • Creating comprehensive API documentation from OpenAPI/Swagger specifications with proper examples and error codes
  • Implementing Diataxis framework architecture for large-scale developer documentation portals
  • Designing docs-as-code workflows with automated testing and deployment pipelines
  • Building content reuse strategies for multi-product technical documentation suites
  • Establishing style guide governance for distributed engineering teams

What you'll get

  • Detailed information architecture blueprint with navigation hierarchy, content taxonomy, and user journey mapping for developer portal
  • Complete OpenAPI documentation template with standardized description patterns, example payload structures, and error response formats
  • Implementation roadmap for docs-as-code pipeline including content validation rules, automated testing scripts, and deployment configuration
Not designed for ↓
  • ×Creative writing, marketing copy, or promotional content creation
  • ×Legal document drafting or compliance documentation
  • ×Business requirements gathering or product specification writing
  • ×Academic paper writing or research methodology documentation
Expects

Clear context about the technical product, target developer audience, existing documentation gaps, and preferred toolchain for documentation delivery.

Returns

Structured documentation architecture plans, complete content templates following Diataxis principles, and implementation guidance for sustainable documentation workflows.

Evidence Policy

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

technical-writingdocumentationapi-docsopenapiswaggerdiataxisdocs-as-codestyle-guideuser-guidesinformation-architecturedeveloper-docs

Research Foundation: 8 sources (3 official docs, 2 industry frameworks, 2 books, 1 community practice)

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/15/2026

Initial release

Works well with

Need more depth?

Specialist skills that go deeper in areas this skill touches.

Common Workflows

API-First Documentation Pipeline

Design API specification, establish documentation architecture and standards, then create comprehensive API documentation

API Design Architecttechnical-writing-expertAPI Documentation Writer

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