Readability

Name: Readability
Author: aiskillstore

ASecurity

Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.

416 stars
0 votes
0 copies
3 views
Added May 30, 2026

ai-agents

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned May 30, 2026

npx -y skills add aiskillstore/marketplace --skill readability --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Readability?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/aiskillstore-readability/badge)](https://www.skillsdirectory.com/skills/aiskillstore-readability)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
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