·docs-writing
""

docs-writing

mblode/agent-skills

Writes and audits technical documentation using Diataxis, Stripe-style clarity, and the Eight Rules. 52 rules across 9 categories covering voice, structure, clarity, code examples, formatting, navigation, scanability, content hygiene, and review. Use when writing docs, creating READMEs, documenting APIs, writing tutorials, building a docs site, or auditing documentation quality.

11Installs·4Trend·@mblode

Installation

$npx skills add https://github.com/mblode/agent-skills --skill docs-writing

SKILL.md

52 rules across 9 categories for documentation quality. Focuses on concrete issues with concrete fixes.

| Priority | Category | Impact | Prefix | Rules |

| 1 | Voice & Tone | CRITICAL | voice- | 4 | | 2 | Structure & Organization | CRITICAL | structure- | 10 | | 3 | Clarity & Language | HIGH | clarity- | 6 | | 4 | Code Examples | HIGH | code- | 7 | | 5 | Formatting & Syntax | MEDIUM-HIGH | format- | 8 | | 6 | Navigation & Linking | MEDIUM-HIGH | nav- | 6 |

Writes and audits technical documentation using Diataxis, Stripe-style clarity, and the Eight Rules. 52 rules across 9 categories covering voice, structure, clarity, code examples, formatting, navigation, scanability, content hygiene, and review. Use when writing docs, creating READMEs, documenting APIs, writing tutorials, building a docs site, or auditing documentation quality. Source: mblode/agent-skills.

View raw

Facts (cite-ready)

Stable fields and commands for AI/search citations.

Install command
npx skills add https://github.com/mblode/agent-skills --skill docs-writing
Category
""Writing
Verified
First Seen
2026-02-17
Updated
2026-02-18

Quick answers

What is docs-writing?

Writes and audits technical documentation using Diataxis, Stripe-style clarity, and the Eight Rules. 52 rules across 9 categories covering voice, structure, clarity, code examples, formatting, navigation, scanability, content hygiene, and review. Use when writing docs, creating READMEs, documenting APIs, writing tutorials, building a docs site, or auditing documentation quality. Source: mblode/agent-skills.

How do I install docs-writing?

Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/mblode/agent-skills --skill docs-writing Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code or Cursor

Where is the source repository?

https://github.com/mblode/agent-skills