skills.rest
e-t-y-b
e-t-y-bOFFICIAL
Explore all skills by this author →
GitHub

technical-writer

Document and standardize technical content across APIs, ADRs, and runbooks.

9|1|Updated Mar 21, 2026
Search Tags:#architecture#documentation#adr#diataxis#technical-writing#api-docs#docs-as-code
One-click install
npx skills add https://github.com/e-t-y-b/etyb-skills --skill technical-writer-e-t-y-b
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: technical-writer
Source: https://github.com/e-t-y-b/etyb-skills/tree/main/skills/technical-writer
Command: npx skills add https://github.com/e-t-y-b/etyb-skills --skill technical-writer-e-t-y-b

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Document and standardize technical content across APIs, ADRs, user guides, and operational runbooks.

Core Features & Use Cases

  • API documentation governance and developer experience improvement
  • Architecture and ADR documentation with MADR/arc42 alignment
  • Living, docs-as-code workflows with ownership, review cadences, and localization
  • Create ADRs, design docs, and living documentation for complex systems

Quick Start

Document your first ADR and API reference using the MADR 4.0 template to capture decisions and rationale.

Frequently Asked Questions about technical-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an Architecture Decision Record using the MADR template?▼

To write an Architecture Decision Record using the MADR template, document your technical decisions and rationale by capturing context, alternatives, and consequences. This approach standardizes ADRs and aligns with MADR 4.0 and arc42 frameworks for complex system design.

What is the Diataxis framework for organizing technical documentation?▼

The Diataxis framework organizes technical documentation into four distinct modes: tutorials, how-to guides, reference, and explanation. This method structures user guides and operational runbooks to scale teams by addressing different learning needs.

How do I implement a docs-as-code workflow for API documentation?▼

You implement a docs-as-code workflow for API documentation by integrating documentation governance into your development lifecycle, establishing ownership, review cadences, and localization processes to maintain living documents alongside source code.

Can I generate operational runbooks and API docs for Claude Code and OpenAI Codex?▼

Yes, you can generate operational runbooks and API docs for Claude Code, OpenAI Codex, and Google Antigravity. The system supports AI-assisted documentation across compatible agents to improve developer experience and standardize technical content.

What is the best way to standardize technical writing across multiple engineering teams?▼

The best way to standardize technical writing across multiple engineering teams is to apply documentation governance with consistent templates for ADRs, API references, and design docs, enabling a living docs-as-code workflow with clear ownership and review cadences.

Related Skills

Explore More Content & Communication Skills→
ancolemanancoleman
503

generating-documentation

Generate OpenAPI specifications, code documentation, and system diagrams.

Community
Advanced
brainbrewlabsbrainbrewlabs
7

doc-publishing

Publishes documentation to GitHub Pages, Vercel, or Netlify from source docs and build outputs.

Official
Intermediate
nanorepublicananorepublica
61

Global Commenting

Apply standardized file headers and module-level comments across codebases.

Community
Basic
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced