Agent skill

Legibility Contrast And Spacing

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Apply contrast and spacing for legibility — calibrating color contrast between text and background, character tracking, and line leading so a chosen typeface and size actually render legibly.

Apache-2.0Auto-check passedFrontend & Design

Install Legibility Contrast And Spacing

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill legibility-contrast-and-spacing -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins legibility-contrast-and-spacing --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/legibility-contrast-and-spacing .claude/skills/legibility-contrast-and-spacing && 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
legibility-contrast-and-spacing
GitHub stars
1.3k
Token cost
~2.6k tokens
SKILL.md length
1,470 words
Files
2 (incl. references)
Skills in repo
716
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply contrast and spacing for legibility — calibrating color contrast between text and background, character tracking, and line leading so a chosen typeface and size actually render legibly.

  • Picking text colors
  • SKILL.md covers Color contrast, Tracking (letter spacing), Leading (line height) and Word spacing and paragraph…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Choosing background colors that will carry text

What it does

Legibility Contrast And Spacing is an agent skill from hashgraph-online/awesome-codex-plugins. Apply contrast and spacing for legibility — calibrating color contrast between text and background, character tracking, and line leading so a chosen typeface and size actually render legibly. Use when picking text colors, choosing background colors that will carry text, evaluating accessibility against WCAG, fine-tuning typography for production rendering, or auditing why text "looks designed" but is hard to read. Even a perfect typeface at the right size will fail if contrast is too low, tracking too tight, or…

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

It sits in Frontend & Design, covering Typography, Accessibility and Fine-tuning. 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

  • Picking text colors
  • Choosing background colors that will carry text
  • Evaluating accessibility against WCAG
  • Fine-tuning typography for production rendering

Example prompts

  • “looks designed”
  • “/legibility-contrast-and-spacing”

What it can do on your machine

Read from SKILL.md and the folder at commit 3e1456a. 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

Legibility Contrast And Spacing loads about 2.6k tokens when it runs, and up to ~4.4k if it reads all its reference files. Until then it costs about 142 tokens; SKILL.md has 1,470 words of instructions outside code blocks.

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

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 3e1456a, republished under its Apache-2.0 licence (© hashgraph-online). 1,470 words, ~2,649 tokens.

Download SKILL.mdSave it as .claude/skills/legibility-contrast-and-spacing/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
legibility-contrast-and-spacing
description
Apply contrast and spacing for legibility — calibrating color contrast between text and background, character tracking, and line leading so a chosen typeface and size actually render legibly. Use when picking text colors, choosing background colors that will carry text, evaluating accessibility against WCAG, fine-tuning typography for production rendering, or auditing why text "looks designed" but is hard to read. Even a perfect typeface at the right size will fail if contrast is too low, tracking too tight, or leading too cramped.

Legibility — contrast and spacing

A typeface and size are necessary but not sufficient for legibility. The conditions under which type is rendered — contrast against background, spacing between characters, spacing between lines — determine whether the chosen typography actually communicates. Most legibility failures in production are spacing or contrast failures, not typeface failures.

Color contrast

Color contrast is the difference in luminance between text and its background. WCAG codifies minimum thresholds:

  • 4.5:1 for normal text (under 18pt regular or 14pt bold).
  • 3:1 for large text (18pt+ regular or 14pt+ bold).
  • 3:1 for graphical objects and UI components (icons, button outlines).
  • 7:1 for AAA conformance — recommended for users with low vision or in poor viewing conditions.

These are floors, not targets. Best practice is to substantially exceed them where possible.

Common contrast failures:

Light gray text on white. Common because designers like the "soft" feel. #999 on white is roughly 2.8:1, well below WCAG AA. #767676 is roughly 4.5:1. Below this, you're failing the standard.

Brand color on white that doesn't pass. A brand color in the medium-blue range (e.g., #5BA0E6) on white is often around 3:1 — fine for large display text, fails for body text. Pick text colors with adequate contrast even if the brand color is borderline.

Text on photos or gradients without protection. Text overlaid on busy photos or gradients can fail in some places and pass in others. Solutions: a dark scrim over the photo, a solid text background, or moving the text out of the photo area.

Low-contrast helper or muted text. Helper text intentionally de-emphasized often drifts into illegibility. Don't go below 4.5:1 (or 3:1 if it's larger text and clearly secondary).

Color-only state indicators. A red error message that loses meaning when rendered to a colorblind user, or a green success message that's invisible to others. Always pair color with shape, label, or icon.

Tools for verifying contrast:

  • WebAIM contrast checker.
  • Browser dev tools' built-in contrast picker.
  • axe, Lighthouse, WAVE for automated audits.
  • Stark or similar Figma/Sketch plugins for design-time checking.

Tracking (letter spacing)

Tracking is the space between characters. The right tracking depends on the typeface, the size, and the use.

Body text: typefaces are usually designed for body sizes with built-in correct tracking. Don't adjust tracking for body unless you have a specific reason.

Display sizes (large): large text often benefits from tighter tracking (-1% to -2%) to prevent characters from feeling too far apart. Many display typefaces are designed expecting some negative tracking at large sizes.

Small sizes (especially below 12px): small text may need slightly looser tracking (+0.5% to +1%) to prevent characters from merging into ambiguous shapes.

All caps: uppercase text needs significantly looser tracking (+5% to +10%) because capital letters have less visual differentiation in their outlines.

Bold text: can sometimes need slightly looser tracking to prevent visual crowding.

Common tracking failures:

Default tracking on display sizes. Many typefaces look loose at large sizes; tighten to -1% to -3%.

Tight tracking on small text. A common cause of "blurry-looking" small text. Loosen slightly.

Untracked all-caps. Uppercase without extra tracking looks crowded and reads slowly.

Leading (line height)

Leading is the space between lines. The right leading depends on the typeface, the line length, and the use.

Body text: 1.4× to 1.6× the font size. So for 16px text, line height of 22–26px. This range is comfortable for sustained reading.

Display / headline text: 1.0× to 1.2× the font size. Tighter leading at display sizes prevents headlines from feeling fragmented.

UI labels and dense text: 1.2× to 1.4× the font size. Tighter than body but loose enough to keep characters from overlapping.

Long-form prose: 1.5× to 1.7× the font size. Slightly more generous than UI body text for sustained reading comfort.

Common leading failures:

Default browser leading on body text. Browsers default to about 1.2× line height, which is too tight for body text. Set explicit line-height: 1.5 or higher for prose.

Leading too tight for the font's x-height. Fonts with tall x-heights (Verdana, Inter) need slightly more leading than fonts with shorter x-heights (Times, Garamond) at the same size.

Inconsistent leading across the type system. Body, headings, captions all should have leading that's calibrated to their use; one-size-fits-all is rarely right.

Tight leading on multi-line UI elements. Buttons, table cells, form labels with multiple lines often have insufficient line height, causing the lines to crowd.

Word spacing and paragraph spacing

Less critical than tracking and leading for most UI but worth checking:

Word spacing. Default word spacing in most typefaces is appropriate. Adjust only for specific cases (justified text, very large display).

Paragraph spacing. Space between paragraphs should be larger than line spacing. A common ratio: paragraph spacing = 0.75× to 1× the font size, in addition to leading.

First-line indent vs. block paragraphs. Most digital UI uses block paragraphs with space between. First-line indents are reserved for editorial / book contexts.

Worked examples

A button that fails contrast

A button with white text (#FFFFFF) on a light blue background (#7AB8FF). Contrast ratio: 2.1:1. Below WCAG AA for both normal and large text.

The fix: darken the blue (#1E78D6 gives 4.5:1) or change the text to a darker color. White on the original blue is too low contrast for accessibility.

Show full SKILL.md (603 more words)Show less
Body text with too-tight leading

Default browser styling: 16px body text with default line-height (about 1.2 = 19px). The text feels cramped; users skim faster than they should and miss content.

The fix: set line-height to 1.5 or higher for body text. 24px line height for 16px text is a comfortable baseline for sustained reading.

A headline with too-loose tracking

A 48px display headline using a typeface with default (positive) tracking. The letters feel separated; the headline doesn't read as a unit.

The fix: tighten tracking to -1% or -2% at this size. The headline now reads as a cohesive title rather than as separate letters.

All-caps navigation that's hard to read

A navigation bar uses ALL CAPS labels at 13px with default tracking. The text feels crowded and reads slowly because all-caps lacks the ascender/descender silhouette that aids word recognition.

The fix: add positive tracking (+5% to +8%) to give the capitals room to breathe; consider whether all-caps is necessary at all (sentence-case or title-case is usually more readable).

Helper text that drifts into illegibility

Helper text under form fields is set in #BBBBBB on white. Contrast ratio: 1.6:1. Many users can't read it at all; even those who can, struggle.

The fix: darken to #767676 or similar (gives 4.5:1). The helper text remains clearly secondary but is now legible.

Code that's hard to scan

Code blocks in a documentation site use a serif typeface at 14px with default tracking and line-height. The text is technically legible but feels dense and hard to scan.

The fix: switch to a monospace typeface (JetBrains Mono or similar), set line-height to 1.6 (a bit more generous than body for visual scanning), and add some background tinting to set code apart from prose.

Anti-patterns

Designing on high-contrast displays then shipping to low-contrast contexts. Mobile devices in sunlight, lower-DPI external monitors, projectors all reduce effective contrast. Test in the worst conditions you'll actually encounter.

Using opacity for text instead of explicit colors. A semi-transparent black text on a colored background can produce unpredictable contrast depending on the underlying color. Use explicit colors, computed against the actual background.

Ignoring user-chosen color schemes. Dark mode, high-contrast mode, and user-overridden colors all change the effective contrast. Test your typography in all the modes your users will use.

Tracking adjustments without testing. Tracking is sensitive to typeface and size. A -2% adjustment that improves a 48px headline may break a 14px body. Calibrate each adjustment to its specific use.

Set-and-forget design tokens for typography. Typography tokens that haven't been audited in years often drift away from current best practices. Review your typography system periodically.

Relying on automated contrast checkers without visual review. Automated tools catch the most obvious failures but miss situations like text over photos, gradient backgrounds, or color combinations that pass technically but feel low-contrast.

Heuristic checklist

Before shipping any typography decision, ask: Does the contrast meet WCAG AA at minimum (4.5:1 normal, 3:1 large)? Check with a contrast tool. Does the contrast hold up in dark mode? Test both modes. Is the leading appropriate for the use case? 1.5× for body, 1.2× for display. Is the tracking appropriate for size and case? Tighter for display, looser for small or all-caps. Have you tested in production conditions? Actual devices, actual browsers, actual viewing conditions.

  • legibility — parent principle on visual character clarity.
  • legibility-typeface-and-size — sibling skill on typeface and size choices.
  • color — color choices that affect contrast.
  • accessibility — contrast is one critical accessibility dimension.
  • signal-to-noise — well-spaced, high-contrast type is signal; the opposite is noise.

See also

  • references/contrast-spacing-recipes.md — specific recipes for common situations (light mode, dark mode, hero text, code, captions).

© 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/legibility-contrast-and-spacing of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/contrast-spacing-recipes.md

Open the folder on GitHubat commit 3e1456a

Compare with similar skills

Legibility Contrast And Spacing 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.

Legibility Contrast And Spacing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Legibility Contrast And Spacing this skillhashgraph-online/awesome-codex-plugins1.3k—~2.6kAutomated safety check: PassApache-2.0
Baseline UIibelick/ui-skills9.6k8 repos~855Automated safety check: PassMIT
UI/UX Design System AdvisorGalaxy-Dawn/claude-scholar5.7k1 repos~1.1kAutomated safety check: PassMIT
Typeui Fundamentalsbergside/typeui2k—~861Automated safety check: PassMIT
UX Principalh0x91b/dev-3.0310—~3kAutomated safety check: PassApache-2.0
Replica DesignJakeschincariol/replica-skill1.4k—~994Automated safety check: PassMIT

Similar skills

  • Baseline UI

    ibelick/ui-skills

    Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.

    9.6k GitHub starsUsed in 8 repos~855 tokens
    Frontend & DesignAuto-check passed
  • UI/UX Design System Advisor

    Galaxy-Dawn/claude-scholar

    Turns a vague UI request into a concrete design system with style, palette, typography and layout guidance from a search script, plus stack-specific implementation advice.

    5.7k GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Typeui Fundamentals

    bergside/typeui

    Universal UI/UX design principles covering visual hierarchy, interaction laws, typography foundations, and WCAG accessibility requirements.

    2k GitHub stars~861 tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • UX Principal

    h0x91b/dev-3.0

    Principal UX architect skill for deciding WHERE a UI feature belongs, before it is implemented.

    310 GitHub stars~3k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Replica Design

    Jakeschincariol/replica-skill

    Rebuilds an app's design system for a clone: colour roles, type scale, spacing, radius, shadows and every component with its states, as design tokens plus component specs, with original assets…

    1.4k GitHub stars~994 tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • iOS Design Guidelines

    MacMagazine/app-iOS

    MacMagazine design reference — theme tokens, card selection, typography, touch targets, accessibility, dark mode.

    170 GitHub stars~767 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 715 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.3k GitHub stars~922 tokensUpdated today
    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.3k GitHub stars~1k tokensUpdated today
    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.3k GitHub stars~1.7k tokensUpdated today
    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.3k GitHub stars~2.5k tokensUpdated today
    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.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

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

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Questions about Legibility Contrast And Spacing

What does Legibility Contrast And Spacing do?

Apply contrast and spacing for legibility — calibrating color contrast between text and background, character tracking, and line leading so a chosen typeface and size actually render legibly. Legibility Contrast And Spacing is an agent skill from hashgraph-online/awesome-codex-plugins. Apply contrast and spacing for legibility — calibrating color contrast between text and background, character tracking, and line leading so a chosen typeface and size actually render legibly.

When should I use Legibility Contrast And Spacing?

Legibility Contrast And Spacing fits situations like: picking text colors; choosing background colors that will carry text; evaluating accessibility against WCAG; fine-tuning typography for production rendering.

How do I install Legibility Contrast And Spacing in Claude Code?

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

How do I install Legibility Contrast And Spacing in Codex?

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

Can I use Legibility Contrast And Spacing 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 legibility-contrast-and-spacing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/legibility-contrast-and-spacing, .gemini/skills/legibility-contrast-and-spacing, .github/skills/legibility-contrast-and-spacing and .opencode/skills/legibility-contrast-and-spacing in your project.

What does Legibility Contrast And Spacing need to run?

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

Does Legibility Contrast And Spacing 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 Legibility Contrast And Spacing 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 Legibility Contrast And Spacing use?

Legibility Contrast And Spacing 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 Legibility Contrast And Spacing use?

About 2.6k tokens (SKILL.md is roughly 11k 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 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Legibility Contrast And Spacing?

Skills that share tags, products or a category with Legibility Contrast And Spacing: Baseline UI (ibelick/ui-skills, 9.6k stars), UI/UX Design System Advisor (Galaxy-Dawn/claude-scholar, 5.7k stars), Typeui Fundamentals (bergside/typeui, 2k stars) and UX Principal (h0x91b/dev-3.0, 310 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Legibility Contrast And Spacing?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,267 GitHub stars. The repository holds 716 skills in this directory. The repository was last updated on October 10, 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.