readability

readability is a skill for Claude Code, Codex 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 CodeCodex

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.

agentmods
npx agentmods add skills/humanizerai/agent-skills/readability
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, Codex.

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.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.svg" alt="Measured on agentmods" 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. Scan, not verified.
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 $0.00033 $0.00631
Opus 5 $0.00016 $0.00316
Sonnet 5 $0.00007 $0.00126
Haiku 4.5 $0.00003 $0.00063

Measured 3d ago against content hash f0e615721b45, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 3d 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. 3d 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 (42 stars, last pushed 6mo ago), licensed MIT. It adds 33 tokens to every session and 631 once invoked, about $0.0002 per session on Opus 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.

Related

Other skills, from other repositories

humanizer-zh

Use when removing AI writing痕迹 from Chinese text to make it sound more natural and human-written.

oyi77/1ai-skills · 26 tokens

humanizer

Use when transform AI-generated content into natural, human-sounding writing with proper tone and style. Use when working with humanizer.

oyi77/1ai-skills · 29 tokens

notion

Notion API for creating and managing pages, databases, and blocks. Use when the user wants to create a Notion page, query a Notion database, update Notion properties, search Notion, add content to Notion, manage Notion blocks, or interact with Notion data sources and workspaces via the API.

elizaOS/eliza · 69 tokens

ondb

A logical analysis and reasoning tool for AI. Use when decomposing documents into structured knowledge, querying entities and relations, validating consistency, or indexing files. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", "analyze this document", entity CRUD, or cross-skill…

x-cmd/x-cmd · 71 tokens

finding-protocol

Operational-tier finding template — minimal fields for sub-agent decision support. Heavyweight deliverable promotion lives in skills/decepticon/final-report.

PurpleAILAB/Decepticon · 32 tokens

babysit

Same-session monitoring loop for PRs, CI runs, tickets, and deployments using the monitorstart / monitorupdate / autonudgestop MCP tools. The loop re-injects your check instructions into THIS session on an idle interval — same context, same tools — and works from dashboard chat, Slack threads, and Discord DMs. Use…

kirodotdev/KiroCrew · 137 tokens