42-readability

Measure per-page readability metrics from Screaming Frog exports or sitemaps.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/chapter42/SEO-Skills-42 --skill 42-readability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 42-readability
Source: https://github.com/chapter42/SEO-Skills-42/tree/main/skills/42-readability
Command: npx skills add https://github.com/chapter42/SEO-Skills-42 --skill 42-readability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires textstat, requests, beautifulsoup4, lxml, and includes scripts (resource) components.

What problem does it solve?

Page readability across a site is inconsistent and difficult to monitor, leading to poor user engagement and lower SEO signals. This tool measures common readability metrics per page to surface content that is too hard or too easy for target audiences, enabling targeted improvements at scale.

Core Features & Use Cases

  • 5 metrics per page: Flesch Reading Ease, Flesch-Kincaid Grade Level, Gunning Fog Index, SMOG Index, and Reading Time.
  • Input flexibility: works with Screaming Frog "All Page Text" exports or live sitemap crawling.
  • Output formats: Markdown readability report and a structured JSON export for downstream analysis.
  • Use Case: identify pages above FKGL 12 for rewrite or below FKGL 6 for beginner-friendly content on large sites.

Quick Start

Run the readability scorer on your Screaming Frog export or sitemap to generate the Readability Report and JSON export.

Frequently Asked Questions about 42-readability

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

FAQPage Schema
How do I check readability scores across my entire website?

You can check site readability at scale by processing Screaming Frog All Page Text exports or crawling live sitemaps. The tool analyzes pages to generate per-page metrics and outlier flags for content needing targeted improvements.

What readability metrics are measured for site content auditing?

Site content readability auditing measures five metrics per page: Flesch Reading Ease, Flesch-Kincaid Grade Level, Gunning Fog Index, SMOG Index, and Reading Time to identify text that is too hard or easy for target audiences.

Can I use a sitemap URL to crawl and evaluate page readability?

Yes, you can use live sitemap crawling to evaluate page readability. The tool accepts sitemap URLs directly, fetches page content, and calculates reading ease and grade level metrics for each discovered URL.

How do I find pages that are too hard to read for my audience?

To find pages too hard for your audience, audit readability scores to flag outliers above your target grade level. You can identify pages above FKGL 12 for rewrite or below FKGL 6 for beginner-friendly content adjustments.

Does this readability tool work with Screaming Frog exports?

Yes, this readability tool works with Screaming Frog All Page Text exports. It accepts SF export directories as input, parses the extracted text, and calculates readability metrics to generate a Markdown report and JSON data file.

What output formats does the bulk readability scorer generate?

The bulk readability scorer outputs a Markdown Readability Report summarizing metrics and outlier flags, plus a structured JSON data file containing per-page scores for downstream analysis and targeted content improvements.