Apply the principle of Readability — the ease with which sustained prose can be read, determined by line length, line height, paragraph rhythm, font choice for prose, and visual breathing room.

Apache-2.0Auto-check passedWriting & Content

Install Readability

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill readability -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins readability --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/readability .claude/skills/readability && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
readability
GitHub stars
1.2k
Token cost
~2.5k tokens
SKILL.md length
1,353 words
Files
2 (incl. references)
Skills in repo
736
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply the principle of Readability — the ease with which sustained prose can be read, determined by line length, line height, paragraph rhythm, font choice for prose, and visual breathing room.

  • Designing long-form content (articles
  • SKILL.md covers Why readability matters, The five inputs to readability, Diagnosing readability problems and Sub-skills in this cluster, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Evaluating whether users can comfortably read paragraphs of text

What it does

Readability is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of Readability — the ease with which sustained prose can be read, determined by line length, line height, paragraph rhythm, font choice for prose, and visual breathing room. Use when designing long-form content (articles, documentation, books, transcripts), writing email or report layouts, evaluating whether users can comfortably read paragraphs of text. Distinct from legibility (per-character clarity); readability is about the experience of reading sustained prose without fatigue. The two…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/lineage.md`).

It sits in Writing & Content, covering Plain language and style rules and Typography. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Designing long-form content (articles
  • Evaluating whether users can comfortably read paragraphs of text

Example prompts

  • “/readability”

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Readability loads about 2.5k tokens when it runs, and up to ~4.5k if it reads all its reference files. Until then it costs about 154 tokens; SKILL.md has 1,353 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~154
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 1,353 words, ~2,539 tokens.

Download SKILL.mdSave it as .claude/skills/readability/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
readability
description
Apply the principle of Readability — the ease with which sustained prose can be read, determined by line length, line height, paragraph rhythm, font choice for prose, and visual breathing room. Use when designing long-form content (articles, documentation, books, transcripts), writing email or report layouts, evaluating whether users can comfortably read paragraphs of text. Distinct from legibility (per-character clarity); readability is about the experience of reading sustained prose without fatigue. The two principles compose: readability requires legibility and adds prose-specific constraints.

Readability

Definition. Readability is the ease with which sustained text can be read — paragraphs, articles, documentation, long-form content. It depends on the legibility of individual characters (necessary precondition) plus a set of prose-specific factors: line length, line height, paragraph spacing, typeface suited for sustained reading, and visual breathing room. A readable design lets the reader move smoothly through the text without fatigue or visual jumping.

Readability is distinct from legibility. Legibility is per-character clarity — can the user identify each letter at a glance. Readability is sustained-reading ease — can the user read paragraphs of prose comfortably without tiring.

A typeface can be highly legible (every character distinguishable) but poorly readable (uncomfortable for long-form reading) — many display typefaces are this way. A typeface can be highly readable (comfortable for sustained reading) but only moderately legible (some characters look similar) — many traditional book typefaces have minor character-distinction issues that don't matter for prose.

Why readability matters

Most UI text is short — labels, buttons, helper text. Legibility usually dominates these contexts. But many products also serve long-form text: documentation, articles, emails, transcripts, reports, books, news, dashboards with substantial commentary. For these, readability matters as much as or more than legibility.

Poor readability costs the user real effort: they tire faster, lose their place more often, miss content, and abandon longer pieces. The cost is not in any single moment but in the cumulative fatigue of reading.

The five inputs to readability

Readability is determined by:

Line length (measure). The number of characters per line. The classic recommendation is 45–75 characters per line for body prose, with ~66 as the sweet spot. Lines that are too long cause the eye to lose track between the end of one line and the start of the next; lines that are too short force frequent line breaks that interrupt reading flow.

Line height (leading). The vertical space between lines. Generous leading aids reading by giving the eye clear separation between adjacent lines. Tight leading causes ascenders and descenders to overlap, slowing reading.

Paragraph spacing. The space between paragraphs. Adequate spacing creates clear paragraph breaks that aid scanning and chunking. Tight paragraph spacing turns prose into a wall of text.

Typeface choice for prose. Some typefaces are designed for sustained reading (humanist serifs, transitional serifs, humanist sans-serifs); others are designed for short use (display, signage). Sustained reading typefaces have proportions and details that reduce eye fatigue.

Visual breathing room. Margins around text, vertical space between sections, page-level rhythm. Cramped layouts cost reading comfort even when individual elements are well-designed.

Diagnosing readability problems

Symptoms of readability issues:

Users skim or abandon long content. They open an article, scan the first paragraph, and leave. Often the problem is not the content but the readability of the layout.

Users complain about "tiring" or "hard-to-read" pages. Difficult to articulate, but a reliable signal of readability issues.

Reading-time analytics drop sharply over content length. Time-on-page falls faster than content length predicts; users are tiring faster than the content warrants.

Reflow on different screen sizes produces dramatically different layouts. A page that's readable at desktop width may be unreadable at a different width if the text doesn't reflow well.

Users zoom in or use reader mode. When users invoke browser reader mode or zoom in, your readability has failed; the browser is doing what your design should have done.

Sub-skills in this cluster

  • readability-line-length — Setting line length (measure) and how it interacts with screen width, font size, and reading context. The most fundamental readability decision.
  • readability-rhythm-and-prose — Paragraph rhythm, leading, vertical spacing, and the prose-level readability that goes beyond line-by-line.

Worked examples

A readable article layout

A long-form article on a content site: 18px serif body type at 1.6 line height, line length capped at 70 characters, paragraph spacing of about 0.8em above each paragraph, generous margins on the article, no other elements competing in the central column. Subheadings break up sections every 3–5 paragraphs.

The reader can move smoothly through the article without conscious effort. The line length is short enough that the eye easily finds the next line, the leading is comfortable, and the paragraph rhythm provides natural rest points.

A documentation page

Documentation often combines prose and code. The prose follows similar readability principles (15–17px body text, 1.6 line height, 60–70 character line length) and code blocks are differentiated visually (monospace, slightly tinted background, generous leading).

The combination requires careful design: code blocks shouldn't disrupt prose flow; prose shouldn't blur into code. Vertical rhythm between paragraphs and code blocks should be consistent.

A wall of text that fails

A FAQ page with no structural breaks: 16px text running 120 characters per line, 1.2 line height, single paragraphs of 10–15 sentences each, no subheadings. Users open it, see the wall, and leave without reading.

The fix: shorter paragraphs, subheadings every few paragraphs, line length capped at 70 characters, line height bumped to 1.5+, more vertical space between paragraphs. The content is the same; the readability transforms.

Show full SKILL.md (531 more words)Show less
A dashboard with too-long lines

A dashboard widget shows a paragraph of explanatory text that runs the full width of the dashboard column — about 130 characters per line. Users read the first few lines and skip the rest because the long lines tire the eye.

The fix: cap the explanation's max-width at 70 characters. The dashboard column can be wider, but the text within it shouldn't run the full width.

Email that's hard to read on mobile

An email designed at desktop width (600px column with 12pt text) is read on a mobile phone. The text reflows to the narrower screen width but the font size doesn't scale up; lines are now very short (15–20 characters) and the user pinches to zoom or switches to a different reader.

The fix: design email for mobile-first, with larger base font sizes (16–18px) and narrower max-widths that still read well at desktop width.

Anti-patterns

Lines that run the full container width. Default web behavior is to fill the available width with text, which often produces lines too long for comfortable reading. Cap your max-width.

Tight leading on body prose. Browser default leading (about 1.2) is too tight for sustained reading. Bump to 1.5 or higher for body content.

No paragraph breaks. Long paragraphs that don't break up are visually intimidating and cognitively dense. Most prose benefits from 3–5 sentence paragraphs.

No subheadings in long content. A 2000-word article without subheadings is a wall. Subheadings every 3–5 paragraphs provide visual rest and structural navigation.

Dense layouts that compete with the prose. Sidebars, ads, callouts, and pop-ups that surround the prose all reduce reading focus. Long-form content benefits from cleared layouts that prioritize the reading experience.

Display typefaces in body prose. A typeface chosen for headlines used at body sizes for prose. Reading fatigue accelerates rapidly.

Justified text without proper hyphenation. Justified text (left and right edges aligned) without good hyphenation produces uneven word spacing — "rivers" of white space running through the prose. Most digital contexts should use left-aligned (ragged-right) text instead.

Text overlaid on busy backgrounds. Text on a photo or pattern fights for attention with the background. Use a solid background for body text.

Heuristic checklist

Before shipping any long-form content, ask: Is the line length capped at 45–75 characters? Wider needs justification. Is the leading at least 1.5× the font size? Tighter is uncomfortable. Is there adequate paragraph spacing? Visible breaks between paragraphs. Are there subheadings every 3–5 paragraphs? Long content needs structural navigation. Is the typeface designed for sustained reading? Display type doesn't survive at body sizes. Have I tested at all the screen sizes my users will use? Especially mobile.

  • Legibility — the per-character clarity that readability builds on.
  • Hierarchy — readability is supported by clear structural hierarchy.
  • Chunking — paragraphs and subheadings chunk prose into readable pieces.
  • Signal-to-Noise Ratio — readable layouts maximize signal (the prose) and minimize noise (everything else).
  • Form Follows Function — long-form reading layouts should be different from UI layouts because their function is different.
  • Accessibility — readable typography helps users with reading differences.

See also

  • references/lineage.md — origins in book typography, web typography, and reading research.
  • readability-line-length/ — sub-skill on line length (measure).
  • readability-rhythm-and-prose/ — sub-skill on paragraph rhythm and breathing room.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/readability of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/lineage.md

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Readability next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Readability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Readability this skillhashgraph-online/awesome-codex-plugins1.2k—~2.5kAutomated safety check: PassApache-2.0
Figure Table QualityMathews-Tom/armory327—~1.7kAutomated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill3.9k—~4.1kAutomated safety check: PassMIT
Natural Japanese Business Writingcoji/natural-japanese1.9k—~2.1kAutomated safety check: PassMIT
Technical Writing Standardcursor/plugins10k10 repos~2.4kAutomated safety check: PassNone
PgjevrealZachi/pg-jev1k—~2.9kAutomated safety check: PassCustom licence

Similar skills

  • Figure Table Quality

    Mathews-Tom/armory

    Readability and rendering audit for figures and tables in academic manuscripts.

    327 GitHub stars~1.7k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    3.9k GitHub stars~4.1k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.

    1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Official

    Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.

    10k GitHub starsUsed in 10 repos~2.4k tokens
    Writing & ContentAuto-check passed
  • Pgjev

    realZachi/pg-jev

    Install, configure, query and explain pgjev (the jev PostgreSQL extension that filters, ranks and classifies rows with plain-language conditions via TypeSafe's Jev model).

    1k GitHub stars~2.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Defensive Writing Editor

    lennney/stop-that-shit

    Cuts defensive disclaimers, stacked hedging and self-protective narration from proposals and summaries, keeping only limits that affect the reader's decision.

    2.5k GitHub starsUsed in 1 repo~902 tokens
    Writing & ContentAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated yesterday
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed

Questions about Readability

What does Readability do?

Apply the principle of Readability — the ease with which sustained prose can be read, determined by line length, line height, paragraph rhythm, font choice for prose, and visual breathing room. Readability is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of Readability — the ease with which sustained prose can be read, determined by line length, line height, paragraph rhythm, font choice for prose, and visual breathing room.

When should I use Readability?

Readability fits situations like: designing long-form content (articles; evaluating whether users can comfortably read paragraphs of text.

How do I install Readability in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill readability -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/readability in hashgraph-online/awesome-codex-plugins) into .claude/skills/readability in your project. Claude Code loads it when a task matches its description.

How do I install Readability in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill readability -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/readability in hashgraph-online/awesome-codex-plugins) into .agents/skills/readability in your project. Codex loads it when a task matches its description.

Can I use Readability in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill readability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/readability, .gemini/skills/readability, .github/skills/readability and .opencode/skills/readability in your project.

What does Readability need to run?

SKILL.md names no scripts, command-line tools or credentials: Readability is instructions for the agent only.

Does Readability access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Readability safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Readability use?

Readability is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Readability use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Readability?

Skills that share tags, products or a category with Readability: Figure Table Quality (Mathews-Tom/armory, 327 stars), Asd Ste100 (danyuchn/asd-ste100-skill, 3.9k stars), Natural Japanese Business Writing (coji/natural-japanese, 1.9k stars) and Technical Writing Standard (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Readability?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.