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-code

Installs 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 GitHub

Sponsors

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
1asyrafhussin avatarweb-design-guidelinesasyrafhussin/agent-skillsUI/UX best practices and accessibility audit. Use when reviewing UI code, checking accessibility, running accessibility audits, auditing forms, or ensuring web 948skills.sh installs
2luwill avatarresearch-proposalluwill/research-skillsUse when the user asks to write or draft a PhD / doctoral research proposal, research plan, 研究计划书, or 开题报告 — a forward-looking plan of background, gap, research935skills.sh installs
3vibe-motion avatarwechat-2d-rendervibe-motion/skillsClone or update https://github.com/sxhzju/wechat-2d and render the default WeChat-style 2D chat motion video with Remotion. Use when users ask for 微信聊天动画, wecha930skills.sh installs
4alirezarezvani avatarsenior-secopsalirezarezvani/claude-skillsSenior SecOps engineer skill for application security, vulnerability management, compliance verification, and secure development practices. Runs SAST/DAST scans928skills.sh installs
5orchestra-research avatarfine-tuning-openvla-oftorchestra-research/ai-research-skillsFine-tunes and evaluates OpenVLA-OFT and OpenVLA-OFT+ policies for robot action generation with continuous action heads, LoRA adaptation, and FiLM conditioning 926skills.sh installs
6jwynia avatarpdf-generatorjwynia/agent-skillsCreate and manipulate PDF files programmatically. Use when the user needs to generate PDFs, fill PDF forms, extract PDF content, add watermarks/overlays, or mer921skills.sh installs