readability-check

Audit multi-paragraph prose and report Flesch scores with per-category statuses.

93|9|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/jdevalk/skills --skill readability-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: readability-check
Source: https://github.com/jdevalk/skills/tree/main/readability-check
Command: npx skills add https://github.com/jdevalk/skills --skill readability-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Readability issues in long-form prose slow readers, especially non-native English speakers, and make it hard to glean key points. This skill performs a structured audit and reports a Flesch Reading Ease score plus per-category statuses for ten checks.

Core Features & Use Cases

  • Overall structure and topic order checks ensure topics are grouped and the conclusion ties the message together.
  • Paragraph structure and opening paragraph checks verify each paragraph starts with its core sentence and communicates a clear point.
  • Sentence length, passive voice, difficult words, filler and hedging, transitions, variation, and heading hierarchy are evaluated to improve readability across technical and non-technical prose.
  • Use cases: run a readability pass on blog posts, READMEs, or documentation drafts to improve clarity before publishing; chain into content SEO or metadata checks after readability.

Quick Start

Run a readability audit on this draft to surface issues and suggested fixes.

Frequently Asked Questions about readability-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit the readability of long-form prose like a README or documentation?▼

To audit prose readability, this skill evaluates multi-paragraph text and produces a structured report with a Flesch Reading Ease score. It surfaces actionable fixes across ten categories, including sentence length, passive voice, and heading hierarchy.

What is a Flesch Reading Ease score and how does it identify readability issues?▼

A Flesch Reading Ease score measures text difficulty based on sentence and word length. This skill calculates the score and pairs it with per-category statuses for difficult words, filler, and transitions to pinpoint specific readability issues.

Can I use this skill to check passive voice and heading hierarchy in technical blog posts?▼

Yes, you can check passive voice and heading hierarchy in technical blog posts. The structured audit evaluates technical and non-technical material, checking paragraph structure, opening sentences, and heading hierarchy to improve overall clarity.

Does the readability audit work for non-native English speakers writing documentation?▼

Yes, the readability audit works for non-native English speakers writing documentation. It identifies difficult words, complex sentences, and hedging, providing a standardized report that makes it easier to glean key points before publishing.

What's the best way to improve paragraph structure before publishing long-form content?▼

To improve paragraph structure, run a readability audit to verify each paragraph starts with its core sentence and communicates a clear point. The audit checks overall structure and topic order to ensure the conclusion ties the message together.

Do I need external tools to perform a structured prose audit?▼

No, you do not need external tools to perform a structured prose audit. The skill evaluates text within its own context and outputs a standardized report with a Flesch score and per-category statuses without requiring any external dependencies.