humanizerai/agent-skills

Overview

This skill analyzes text readability using established formulas like Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog, and SMOG. It returns objective scores, interprets them for likely readers, and gives concrete recommendations to simplify or adjust the text. The output includes summary statistics and actionable edits to improve clarity.

How this skill works

You provide the text to analyze. The skill counts words, sentences, syllables and complex words (3+ syllables), estimates passive sentences, and computes core readability metrics. It maps numeric results to audience levels and produces targeted suggestions such as shortening sentences, replacing complex words, and converting passive constructions.

When to use it

• Assess accessibility of blog posts, guides, or web content
• Optimize copy for a target grade level or audience
• Evaluate SEO and UX impact of long or complex text
• Review academic or technical drafts for readability
• Compare readability before and after edits

Best practices

• Provide representative sample text (at least a few paragraphs) for accurate metrics
• Specify a target audience or grade level if you have one
• Iterate: re-run analysis after applying recommendations
• Prioritize shortening very long sentences (>20 words) and simplifying frequent complex words
• Use active voice for clearer, more direct prose

Example use cases

• Lower reading level of product descriptions to improve conversions
• Prepare user manuals targeted at a general audience (grade 8–10)
• Edit marketing emails to increase engagement by raising Flesch score
• Audit internal documentation to reduce jargon and passive phrasing
• Train writers with before/after readability comparisons