Agent skill
readability
Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.
Install this agent skill to your Project
npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/humanizerai/readability
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
perigon-backend
Perigon ASP.NET Core + EF Core + Aspire conventions
perigon-agent
Pointers for Copilot/agents to apply Perigon conventions
perigon-angular
Angular 21+ standalone/Material/signal conventions for Perigon WebApp
fastapi-mastery
Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.
context7-efficient
Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.
browser-use
Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.
Didn't find tool you were looking for?