From dev-hooks
This skill should be used when writing or revising web content, product copy, AI-generated responses, docs, or long-form text where clarity, scannability, and comprehension matter.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dev-hooks:readabilityThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Apply this skill to turn dense copy into web-friendly content that people can scan, understand, and use quickly.
Apply this skill to turn dense copy into web-friendly content that people can scan, understand, and use quickly.
Ground decisions in NN/g guidance from:
references/nng-guidelines.mdCore rules:
Use the bundled script for deterministic checks:
uv run scripts/readability_audit.py <file>
Optional comparison to baseline branch:
uv run scripts/readability_audit.py <file> --branch main
Optional grade target (default is 10):
uv run scripts/readability_audit.py <file> --target-grade 9
The script reports:
Supplemental scripts are available when a narrower check is useful:
uv run scripts/flesch_kincaid.py <file> [branch]
uv run scripts/vocabulary_profiler.py <file> [branch]
Use flesch_kincaid.py for a simple grade-only check. Use vocabulary_profiler.py to estimate how much copy uses common top-1000 English words; it is backed by scripts/top1000.txt.
Treat these scripts as guardrails, not substitutes for human judgment.
When using this skill in a user-facing task:
Credit: Adapted verbatim from Nate Berkopec's dotfiles.
npx claudepluginhub mickzijdel/dev-hooks --plugin writingGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.