readability

Compute readability metrics and text statistics with improvement recommendations.

1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/tawf-labs/zkt-hackathon --skill readability-tawf-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readability
Source: https://github.com/tawf-labs/zkt-hackathon/tree/main/.agents/skills/readability
Command: npx skills add https://github.com/tawf-labs/zkt-hackathon --skill readability-tawf-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quantify how hard a piece of writing is to read so you can revise it for the intended audience instead of guessing based on intuition.

Core Features & Use Cases

  • Readability scoring: Computes Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog, and SMOG to estimate accessibility and grade level.
  • Text statistics: Reports word count, sentence count, average sentence length, average word length, and complex-word density.
  • Actionable recommendations: Suggests concrete edits like shortening sentences, simplifying complex words, and reducing passive voice based on the results.

Quick Start

Paste the text you want to evaluate and ask for a readability analysis with scores and improvement recommendations.

Frequently Asked Questions about readability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the readability of my text and find out what grade level it matches?

To check text readability and determine its grade level, paste your content into the tool. It computes Flesch-Kincaid Grade, Flesch Reading Ease, Gunning Fog, and SMOG scores to estimate the exact audience comprehension level required.

What do Flesch Reading Ease and SMOG readability scores mean for my writing quality?

Flesch Reading Ease and SMOG are readability metrics that quantify how accessible your writing is. Flesch Reading Ease rates text on a 0-100 scale for general comprehension, while SMOG estimates the years of education needed to understand your text.

How do I analyze text statistics to improve audience comprehension for an essay or report?

To improve audience comprehension, the tool analyzes text statistics including word count, sentence count, average sentence length, and complex-word density. It then provides actionable recommendations like shortening sentences and simplifying complex words.

Can I use readability analysis to edit documentation and ensure it matches a target reading level?

Yes, you can use readability analysis to edit documentation for a target reading level. It assesses essays, articles, and reports by computing established metrics like Gunning Fog and SMOG, then suggests concrete edits to align with your audience's grade level.

What is the best way to reduce passive voice and complex-word density in my articles?

The best way to reduce passive voice and complex-word density is to run a readability analysis. The tool identifies these specific text statistics and returns clear improvement recommendations, suggesting concrete edits to simplify your writing.

Does text readability scoring work for any type of content, or only specific formats?

Text readability scoring works across multiple content formats. It applies to editing tasks for essays, articles, documentation, and reports, assessing audience comprehension uniformly by calculating standard metrics like Flesch-Kincaid Grade and SMOG.