readability
Calculate readability metrics to evaluate and improve writing clarity.
Install
mkdir -p .claude/skills/readability && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16205" && unzip -o skill.zip -d .claude/skills/readability && rm skill.zipInstalls to .claude/skills/readability
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.Key capabilities
- →Calculate Flesch Reading Ease score
- →Determine Flesch-Kincaid Grade level
- →Compute Gunning Fog Index
- →Calculate SMOG Index
- →Provide text statistics like word and sentence count
How it works
The skill applies various readability formulas (Flesch-Kincaid, Gunning Fog, SMOG) to the input text, counting words, sentences, and syllables to generate objective scores and statistics.
Inputs & outputs
When to use readability
- →Calculate Flesch-Kincaid score
- →Analyze writing complexity
- →Get content improvement suggestions
- →Check text readability
About this skill
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
When not to use it
- →When the user does not provide text to analyze
- →When the task requires subjective text analysis
- →When the task is not related to readability metrics
Limitations
- →Complex words are defined as those with 3+ syllables.
- →Recommendations are based on scores, suggesting areas like sentence shortening or word simplification.
- →The interpretation guide provides audience levels based on Flesch scores.
How it compares
This skill provides objective, formula-based readability assessments and specific improvement recommendations, unlike subjective human evaluations.
Compared to similar skills
readability side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| readability (this skill) | 0 | 6mo | No flags | Beginner |
| executing-marketing-campaigns | 11 | 7mo | Review | Intermediate |
| clinical-decision-support | 4 | 2mo | Review | Advanced |
| mm-report-writer | 0 | 2mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
executing-marketing-campaigns
davila7
Plans, creates, and optimizes marketing campaigns including content strategy, social media, email, and analytics. Helps develop go-to-market strategies, campaign messaging, and performance measurement.
clinical-decision-support
K-Dense-AI
Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
mm-report-writer
ShinyGua
Generates daily or weekly research report from evidence cards, quant summary, thesis map, and company profile
market-research-reports
davila7
Generate comprehensive market research reports (50+ pages) in the style of top consulting firms (McKinsey, BCG, Gartner). Features professional LaTeX formatting, extensive visual generation with scientific-schematics and generate-image, deep integration with research-lookup for data gathering, and multi-framework strategic analysis including Porter's Five Forces, PESTLE, SWOT, TAM/SAM/SOM, and BCG Matrix.
competitive-intelligence
anthropics
Research your competitors and build an interactive battlecard. Outputs an HTML artifact with clickable competitor cards and a comparison matrix. Trigger with "competitive intel", "research competitors", "how do we compare to [competitor]", "battlecard for [competitor]", or "what's new with [competitor]".
marketing-ops
alirezarezvani
Central router for the marketing skill ecosystem. Use when unsure which marketing skill to use, when orchestrating a multi-skill campaign, or when coordinating across content, SEO, CRO, channels, and analytics. Also use when the user mentions 'marketing help,' 'campaign plan,' 'what should I do next,' 'marketing priorities,' or 'coordinate marketing.'