Technical Writing

intermediatewritingMin 32K context

Transforms complex technical concepts into clear, well-structured documentation for different audiences. Produces README files, architecture decision records (ADRs), runbooks, onboarding guides, and technical blog posts. Follows documentation best practices with consistent tone, proper formatting, and useful examples.

Use Cases

  • Writing a comprehensive README for an open-source project
  • Creating Architecture Decision Records for design choices
  • Producing runbooks for incident response procedures
  • Writing onboarding guides for new team members
  • Drafting technical blog posts explaining complex systems

Example Prompt

Write an Architecture Decision Record (ADR) for the following decision:

Context: Our API currently uses REST with JSON. We're considering adding GraphQL
for our mobile clients that need flexible queries and reduced over-fetching.

Write the ADR covering:
- Title and status
- Context and problem statement
- Decision drivers
- Considered options (REST-only, GraphQL-only, hybrid)
- Decision outcome with justification
- Consequences (positive, negative, neutral)
- Follow-up actions

Recommended Models

Compatible Tools

claude-codecursorkiroany

Modalities

Input: text, code
Output: text

Related Skills

Author

OpenModels Community

@openmodelsrun
Technical Writing — AI Agent Skill | OpenModels