agentsclimarketplace
Sign in

Readability

Skill mickzijdel/dev-hooks/plugins/writing/skills/readability

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.From its SKILL.md

Install
npx -y skills add mickzijdel/dev-hooks --skill readability

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.7 KB, 591 tokens by cl100k_base, as published. Nobody here has run it

Readability

Apply this skill to turn dense copy into web-friendly content that people can scan, understand, and use quickly.

Principles to apply

Ground decisions in NN/g guidance from:

Core rules:

  1. Keep copy concise.
  2. Structure for scanning, not essay-style reading.
  3. Use the inverted pyramid (answer first, details second).
  4. Use plain language and short sentences.
  5. Design for comprehension, not just grammatical correctness.

Workflow

  1. Define audience and task.
  2. Cut nonessential content before reformatting.
  3. Rewrite lead sections to front-load key information.
  4. Add scan aids:
    • Descriptive headings
    • Bullets for parallel points
    • Brief summary or key takeaways for long content
    • Selective emphasis only where it materially aids scanning
  5. Confirm language simplicity and sentence-level clarity.
  6. Run the readability audit script and address failures.

Audit script

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:

  • Flesch-Kincaid grade
  • Sentence and paragraph length pressure
  • Heading/list density for longer content
  • Lead-paragraph length

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.

Output expectations

When using this skill in a user-facing task:

  1. Deliver the revised text.
  2. Briefly summarize structural changes (for example: "added summary, split long paragraphs, converted dense section to bullets").
  3. Call out unresolved tradeoffs (brand voice, legal constraints, required jargon).

Credit: Adapted verbatim from Nate Berkopec's dotfiles.

What ships with it: 6 files

26.1 KB alongside SKILL.md, 4 of them executable

references/

scripts/

Keep looking

Skills are one crate of 326,512. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.