readability

readability is a skill for Claude Code from humanizerai/agent-skills. It costs 33 tokens per session (631 once invoked), scanned A, original, MIT.

A text-reading checker that calculates scores such as Flesch-Kincaid, Gunning Fog, and SMOG. These scores estimate how much education a reader may need to understand the writing.

In plain words
What is it for?
Use it to measure reading difficulty, word and sentence counts, sentence length, complex words, and estimated passive voice in supplied text.
Why use it?
It replaces guesses about readability with measurements and basic text statistics. It can show whether sentences or words may be too difficult for the intended audience.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter.

Good fit Use it to measure reading difficulty, word and sentence counts, sentence length, complex words, and estimated passive voice in supplied text.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/humanizerai/agent-skills/readability
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add humanizerai/agent-skills --skill readability
Clone the repo
git clone --depth 1 https://github.com/humanizerai/agent-skills

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for readability

README.md
[![agentmods](https://agentmods.dev/badge/skills/humanizerai/agent-skills/readability/github.svg)](https://agentmods.dev/skills/humanizerai/agent-skills/readability)
Your own site
<a href="https://agentmods.dev/skills/humanizerai/agent-skills/readability"><img src="https://agentmods.dev/badge/skills/humanizerai/agent-skills/readability/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for readability

Your own site · 80×15
<a href="https://agentmods.dev/skills/humanizerai/agent-skills/readability"><img src="https://agentmods.dev/badge/skills/humanizerai/agent-skills/readability.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 631 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 15 Sept 2026
  • Snyk pass 15 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00033 $0.00631
Opus 5.5 $0.00013 $0.00252
Sonnet 5.5 $0.00007 $0.00126
Haiku 4.5 $0.00003 $0.00063

Measured 1mo ago against content hash f0e615721b45, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

readability scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/readability/SKILL.md · 85 lines

What it actually says

Analyze Readability

Calculate and display readability metrics for the provided text.

Input

The user provides text in $ARGUMENTS. If no text provided, ask for it.

Metrics to Calculate

Core Scores

Metric Formula Interpretation
Flesch Reading Ease 206.835 - 1.015(words/sentences) - 84.6(syllables/words) 0-100, higher = easier
Flesch-Kincaid Grade 0.39(words/sentences) + 11.8(syllables/words) - 15.59 US grade level
Gunning Fog Index 0.4[(words/sentences) + 100(complex words/words)] Years of education
SMOG Index 1.043 × √(complex words × 30/sentences) + 3.1291 Grade level

Complex words = 3+ syllables

Text Statistics

  • Word count
  • Sentence count
  • Average sentence length (words)
  • Average word length (characters)
  • Complex words count and %
  • Passive voice sentences (estimate)

Output Format

## Readability Analysis

### Scores
| Metric | Score | Meaning |
|--------|-------|---------|
| Flesch Reading Ease | [X] | [interpretation] |
| Flesch-Kincaid Grade | [X] | [grade level] |
| Gunning Fog | [X] | [years education] |
| SMOG | [X] | [grade level] |

### Statistics
- Words: [X]
- Sentences: [X]
- Avg sentence length: [X] words
- Complex words: [X] ([Y]%)

### Target Audience
[Who can easily read this based on scores]

### Recommendations
1. [Specific suggestion]
2. [Specific suggestion]
3. [Specific suggestion]

Interpretation Guide

Flesch Score Grade Audience
90-100 5th Very easy
80-89 6th Easy
70-79 7th Fairly easy
60-69 8-9th Standard
50-59 10-12th Fairly difficult
30-49 College Difficult
0-29 Graduate Very difficult

Recommendations

Based on scores, suggest:

  • Sentences to shorten (if avg > 20 words)
  • Complex words to simplify
  • Passive voice to convert to active
  • Specific examples of what to fix
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 85 lines · 33 tokens per session scan A f0e615721b45

Subscribe to this mod's changes

readability is a skill published in the GitHub repository humanizerai/agent-skills (53 stars, last pushed 8mo ago), licensed MIT. It adds 33 tokens to every session and 631 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.