
Docs Writing
A structured documentation auditor that knows the difference between a tutorial and reference docs, then applies the right rules to each. Built on Diataxis, Stripe's clarity principles, and 52 rules across nine categories from voice to code examples. It works through a checklist, prioritizes critical issues like passive voice and bad structure before polish, and reports findings with file:line references and concrete fixes. Use it when you're writing a README, building a docs site, or need someone to tell you why your API documentation feels off. The progressive loading and scoped audits keep it from drowning you in nitpicks when you just changed three files.
- skills.sh installs
- 949
- GitHub stars
- 191
- last updated
- Aug 21, 2026
Install
$ npx -y skills add mblode/agent-skills --skill docs-writing --agent claude-codeInstalls into .claude/skills of the current project.
Files
A structured documentation auditor that knows the difference between a tutorial and reference docs, then applies the right rules to each. Built on Diataxis, Stripe's clarity principles, and 52 rules across nine categories from voice to code examples. It works through a checklist, prioritizes critical issues like passive voice and bad structure before polish, and reports findings with file:line references and concrete fixes. Use it when you're writing a README, building a docs site, or need someone to tell you why your API documentation feels off. The progressive loading and scoped audits keep it from drowning you in nitpicks when you just changed three files.
Browse the repository on GitHubSponsors
Details
- Repository
- github.com/mblode/agent-skills
- Categories
- Git & Pull Requests, Documentation, Code Review & Quality, AI & Agent Building, Marketing & SEO, Finance & Trading
- First seen
- Jun 3, 2026
More from mblode/agent-skills
All 22- Agents Md884
- Scaffold Nextjs785
- Scaffold Cli751
- Ui Audit733
- Autoship687
- Optimise Seo647
- Readme Creator604
- Copywriting483
- Define Architecture448
- Blog Post404
- Review Pr185
- Agent Native140
- Babysit Pr124
- Mermaid Mind Map124
- Audit Ui114
- Ui Animation10.8K
- Multi Tenant Architecture1.8K
- Ui Design1.5K
- Typography Audit1.1K
- Agent Skills Creator1K
- Presentation Creator960