Universal Reading Age Score Badge

WHAT IT DOES

Universal Reading Age Score Badge analyzes the text content of any webpage and calculates its reading level using multiple standard readability formulas. The script extracts visible text, counts sentences, words, and syllables, then computes the Flesch-Kincaid Grade Level, Gunning Fog Index, SMOG Index, ARI, and Coleman-Liau Index. A visible badge displays the reading grade level (e.g., "Grade 5", "Grade 8", "Grade 12") with a color-coded indicator: green for easy, yellow for moderate, orange for difficult, and red for very difficult. For international audiences, the reading age in years is shown alongside the grade level. A readability distribution chart compares results across multiple formulas. Detailed statistics show sentence count, word count, syllable count, and complex word count. You can choose which formula to use as the primary metric or view all formulas.

WHERE IT RUNS

This script runs on every website (matching all URLs), analyzing page content across the entire web. It works on articles, blog posts, documentation, emails, and any page with visible text content. The script automatically adapts to each page and handles both static and dynamically loaded content.

HOW TO USE

After installing through the BotGentz extension, simply browse to any webpage. The script automatically analyzes the page and displays the reading level badge. Use the configuration panel to customize your experience: choose the primary formula (Flesch-Kincaid, Gunning Fog, SMOG, ARI, Coleman-Liau, or All Formulas), toggle the badge on or off, show or hide the reading age, enable or disable color-coding, show or hide detailed statistics, show or hide the distribution chart, and enable or disable auto-analysis. The panel displays comprehensive results including the selected formula score, Flesch Reading Ease score, and detailed text statistics. Use the "Analyze Page" button to manually reanalyze, or "Copy Results" to copy all metrics to your clipboard.

MULTI-FORMULA READABILITY ANALYSIS WITH SYLLABLE COUNTING AND TEXT METRICS

This script implements a comprehensive readability analysis engine using five standard formulas. The Flesch-Kincaid Grade Level (0.39*words/sentences + 11.8*syllables/words - 15.59) and Flesch Reading Ease (206.835 - 1.015*words/sentences - 84.6*syllables/words) provide core metrics. The Gunning Fog Index (0.4*((words/sentences) + 100*(complexWords/words))) counts words with 3+ syllables. The SMOG Index (1.043*sqrt(complexWords*30/sentences) + 3.1291) and Automated Readability Index (4.71*words/sentences + 0.5*syllables/words - 21.43) provide additional perspectives. The syllable counter uses vowel group detection with silent-e handling. The text extraction engine filters out invisible elements and non-content tags. The chart visualization compares formula results using color-coded bars for easy comparison.

THE PANEL

The configuration panel is fully draggable and remembers its position per-site using GM_setValue. It snaps to screen edges when dragged near them, collapses to a compact bubble when minimized, and supports Escape key for quick collapse. All settings—including badge visibility, formula selection, reading age display, color-coding, details visibility, chart visibility, and auto-analysis—are persisted across sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. The script runs on all websites and reads page content to calculate readability scores. It does not capture, store, or transmit any personal information. All analysis occurs locally in your browser. Readability formulas are designed for English text and may not be accurate for other languages. The syllable counter uses heuristics and may not be 100% accurate for all words. Grade level and reading age are approximations and should be interpreted as general guides, not definitive measures. This tool is provided for informational and educational purposes only.