Readability Check

Runs a readability audit on a blog post draft or other multi-paragraph prose, calibrated for readers who read English as a second language. Checks ten categories — overall structure and topic order, paragraph structure, opening paragraph strength, tiered sentence length, passive voice, difficult words, filler and hedging, transitions, variation, and heading hierarchy — and reports a Flesch Reading Ease score with a per-category status. Use when the user asks to check readability, run a readability pass, or asks "is this readable", or proactively as a second pass after a substantial draft is co

110 stars 10 forksImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jdevalk/skills --skill readability-check
Manual install
git clone --depth 1 https://github.com/jdevalk/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/readability-check ~/.claude/skills/readability-check

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Readability check

Run a readability audit on a blog post draft or other multi-paragraph prose. Use when the user asks to check readability ("check readability", "readability pass", "is this readable"), or proactively after a substantial draft is complete — as a second pass after the blog-drafting skill's critical read, not during active drafting.

For short strings — page titles, meta descriptions, schema `description` fields, FAQ answers, profile bios, repo taglines — use the `metadata-check` skill. Flesch scoring and the ten-category rubric below don't fit a 5–30 word string and will mislead.

For whether a post earns a ranking — search intent fit, keyphrase placement, E-E-A-T, internal linking — chain into the `content-seo` skill after this audit. Readability is a prerequisite for ranking, not a substitute.

## Audience calibration

Always assume the reader reads English as a second language. That's the default, not a fallback.

In technical posts, the technical sections can use domain terms the audience expects — but any non-technical paragraph (introduction, context, conclusion, transitions, examples, analogies) must be readable by a non-technical L2 reader. Setup and motivation paragraphs carry the post for readers who don't know the domain yet; they're where you lose people.
Read the full skill on GitHub

Details

Skill name
readability-check
Repository
jdevalk/skills
Path
readability-check/SKILL.md
License
MIT
Repo updated
5 July 2026

FAQ

What does the Readability Check skill do?

Runs a readability audit on a blog post draft or other multi-paragraph prose, calibrated for readers who read English as a second language. Checks ten categories — overall structure and topic order, paragraph structure, opening paragraph strength, tiered sentence length, passive voice, difficult words, filler and hedging, transitions, variation, and heading hierarchy — and reports a Flesch Reading Ease score with a per-category status. Use when the user asks to check readability, run a readability pass, or asks "is this readable", or proactively as a second pass after a substantial draft is co

How do I install the Readability Check skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jdevalk/skills --skill readability-check. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Readability Check popular?

It lives in jdevalk/skills, which has 110 GitHub stars and 10 forks.

Related skills

Emdash Github Actions

110

jdevalk/skills

Sets up GitHub Actions CI/CD workflows for EmDash plugins — TypeScript type-checking, ESLint linting, Vitest testing, npm publishing, and automated releases. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an EmDash plugin — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an EmDash plugin repo; set up testing in CI for a plugin; auto-publish a plugin to npm from GitHub; add security scanning or dependency auditing to

Git & Code Review10

Astro Github Actions

110

jdevalk/skills

Sets up GitHub Actions CI/CD workflows for Astro sites — `astro check` (TypeScript + content schema), ESLint, Prettier, build verification, Vitest testing, Lighthouse CI, link checking, npm audit, and automated deployment to GitHub Pages, Cloudflare Pages, Netlify, or Vercel. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an Astro site — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an Astro repo; set up `astro ch

Git & Code Review10

Astro SEO

110

jdevalk/skills

Audits and improves SEO for Astro sites. Use when the user asks to audit, set up, or improve SEO on an Astro site, or mentions head metadata, structured data, JSON-LD, sitemaps, IndexNow, Open Graph images, schema endpoints, NLWeb, hreflang, or search engine indexing in an Astro project. Produces drop-in code routed through `@jdevalk/astro-seo-graph` and chains into `metadata-check` for generated SEO strings.

Marketing, Sales & Business10

Call Acoustic Breath Biomarker Tracker

116

CALLE-AI/awesome-phone-call-agents

Offline nonclinical phone-workflow demonstration over supplied speech/pause durations. Returns illustrative pause-ratio labels, not medical findings or an actual emergency handoff.

Images, Video & Audio512

Youtube Thumbnail Design

223

NeverSight/learn-skills.dev

YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A/B testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image

Images, Video & Audio42

Call Answer Evasion Auditor

116

CALLE-AI/awesome-phone-call-agents

Offline experimental CALL-E transcript helper that grades agent answers to callee direct questions (identity, yes-no, information) as CLEAR, PARTIALLY_CLEAR or EVASIVE with dodge mechanisms, and crafts answer-first goal templates. It is not intent detection, proof of deceit, or authorization to act.

Images, Video & Audio512

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.