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.