readability
starsforks
How to install readability?
humanizerai/agent-skills/readability
$npx -y skills add humanizerai/agent-skills --skill readabilityAnalyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.
SKILL.md
| 1 | # Analyze Readability |
| 2 | |
| 3 | Calculate and display readability metrics for the provided text. |
| 4 | |
| 5 | ## Input |
| 6 | |
| 7 | The user provides text in $ARGUMENTS. If no text provided, ask for it. |
| 8 | |
| 9 | ## Metrics to Calculate |
| 10 | |
| 11 | ### Core Scores |
| 12 | |
| 13 | | Metric | Formula | Interpretation | |
| 14 | |--------|---------|----------------| |
| 15 | | **Flesch Reading Ease** | 206.835 - 1.015(words/sentences) - 84.6(syllables/words) | 0-100, higher = easier | |
| 16 | | **Flesch-Kincaid Grade** | 0.39(words/sentences) + 11.8(syllables/words) - 15.59 | US grade level | |
| 17 | | **Gunning Fog Index** | 0.4[(words/sentences) + 100(complex words/words)] | Years of education | |
| 18 | | **SMOG Index** | 1.043 × √(complex words × 30/sentences) + 3.1291 | Grade level | |
| 19 | |
| 20 | *Complex words = 3+ syllables* |
| 21 | |
| 22 | ### Text Statistics |
| 23 | |
| 24 | - Word count |
| 25 | - Sentence count |
| 26 | - Average sentence length (words) |
| 27 | - Average word length (characters) |
| 28 | - Complex words count and % |
| 29 | - Passive voice sentences (estimate) |
| 30 | |
| 31 | ## Output Format |
| 32 | |
| 33 | ``` |
| 34 | ## Readability Analysis |
| 35 | |
| 36 | ### Scores |
| 37 | | Metric | Score | Meaning | |
| 38 | |--------|-------|---------| |
| 39 | | Flesch Reading Ease | [X] | [interpretation] | |
| 40 | | Flesch-Kincaid Grade | [X] | [grade level] | |
| 41 | | Gunning Fog | [X] | [years education] | |
| 42 | | SMOG | [X] | [grade level] | |
| 43 | |
| 44 | ### Statistics |
| 45 | - Words: [X] |
| 46 | - Sentences: [X] |
| 47 | - Avg sentence length: [X] words |
| 48 | - Complex words: [X] ([Y]%) |
| 49 | |
| 50 | ### Target Audience |
| 51 | [Who can easily read this based on scores] |
| 52 | |
| 53 | ### Recommendations |
| 54 | 1. [Specific suggestion] |
| 55 | 2. [Specific suggestion] |
| 56 | 3. [Specific suggestion] |
| 57 | ``` |
| 58 | |
| 59 | ## Interpretation Guide |
| 60 | |
| 61 | | Flesch Score | Grade | Audience | |
| 62 | |--------------|-------|----------| |
| 63 | | 90-100 | 5th | Very easy | |
| 64 | | 80-89 | 6th | Easy | |
| 65 | | 70-79 | 7th | Fairly easy | |
| 66 | | 60-69 | 8-9th | Standard | |
| 67 | | 50-59 | 10-12th | Fairly difficult | |
| 68 | | 30-49 | College | Difficult | |
| 69 | | 0-29 | Graduate | Very difficult | |
| 70 | |
| 71 | ## Recommendations |
| 72 | |
| 73 | Based on scores, suggest: |
| 74 | - Sentences to shorten (if avg > 20 words) |
| 75 | - Complex words to simplify |
| 76 | - Passive voice to convert to active |
| 77 | - Specific examples of what to fix |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
