readability — скилл для Claude Code: оценка читабельности текста
Считает Flesch-Kincaid, Gunning Fog, SMOG и другие метрики читабельности. Пригодится, когда нужно понять, на какую аудиторию тянет черновик.
npx skills add humanizerai/agent-skills --skill readability -a claude-codeЧто делает readability
Скилл берёт текст, который вы передали в аргументе, и считает по нему четыре оценки: Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog и SMOG. К каждой — расшифровка: уровень класса, годы обучения, кому такой текст читается легко. Если текст не передан, скилл попросит его.
Кроме баллов выводится статистика: число слов и предложений, средняя длина предложения в словах, средняя длина слова в символах, доля сложных слов (три слога и больше) и оценка пассивных конструкций. Дальше идут рекомендации — какие предложения сократить, какие слова упростить, где пассив заменить активом, с примерами.
Формулы скилл применяет как есть, поэтому цифры зависят от того, как вы считаете слоги и предложения. На коротких текстах в пару абзацев метрики скачут: SMOG, например, рассчитан на выборку не меньше 30 предложений, так что на заметке в пять строк балл будет грубым. Это повод не спорить с оценкой, а смотреть на неё как на подсказку.
Какие задачи решает
- оценить, какому классу чтения соответствует черновик статьи
- найти предложения длиннее 20 слов и сократить их
- вычислить долю сложных слов в тексте
- проверить, не перегружен ли текст пассивом
- сравнить читабельность двух версий одного документа
Примеры запросов агенту
- /readability <текст для анализа>
- посчитай читабельность этого текста: <вставь абзац>
- прогони мой черновик по Flesch-Kincaid и Gunning Fog
Как установить readability
1Через Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill readability -a claude-code2Вручную: положить файлы
~/.claude/skills/readability/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/readability/
1Через Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill readability -a codex2Вручную: положить файлы
.agents/skills/readability/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill readability -a cursor2Вручную: положить файлы
.cursor/skills/readability/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install humanizerai/agent-skills readability2Вручную: положить файлы
.github/skills/readability/SKILL.md1Через Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill readability -a gemini-cli2Командой платформы
gemini skills install https://github.com/humanizerai/agent-skills --path skills/readabilityВручную: положить файлы
.devin/skills/readability/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill readability -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о readability
Как установить readability в Claude?
Выполните npx skills add humanizerai/agent-skills --skill readability -a claude-code. Скилл встанет в ~/.claude/skills/readability/SKILL.md.
Что делает readability?
Считает Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog и SMOG по вашему тексту, добавляет статистику по словам и предложениям и выдаёт рекомендации, что упростить.
На каких платформах работает readability?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для каждой свой способ установки, например для Cursor — npx skills add humanizerai/agent-skills --skill readability -a cursor.
Исходный текст
SKILL.md · MIT
--- name: readability description: Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations. user-invocable: true argument-hint: "[text to analyze]" --- # 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
© humanizerai · MIT · humanizerai/agent-skills
