better-typography

Reviews and fixes web typography across fonts, spacing, wrapping, and accessibility.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chhpt/skills --skill better-typography-chhpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: better-typography
Source: https://github.com/chhpt/skills/tree/main/skills/better-typography
Command: npx skills add https://github.com/chhpt/skills --skill better-typography-chhpt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web interfaces often ship with inconsistent font choices, broken heading hierarchy, poor line lengths, layout-shifting numbers, and unreadable small text. This Skill provides a systematic set of typography principles and review procedures so text renders correctly, wraps well, and stays accessible across browsers and devices. ## Core Features & Use Cases - Font Selection and Loading: Guidance on typeface categories, pairing, woff2 formats, variable font axes, and OpenType features like tabular numbers and stylistic sets. - Spacing, Sizing, and Wrapping: Type scales, heading hierarchy mapping, line-height and letter-spacing rules, measure caps, text-wrap, truncation, and smart punctuation. - Accessibility and Details: iOS input zoom prevention, font smoothing, underline metrics, text selection rules, RTL/bidi handling, and size and contrast floors. - Structured Reviews: Produces severity-ranked findings tables with before/after fixes, verification steps, and a Block/Needs changes/Approve verdict, expressed in the project's own styling system (Tailwind, CSS Modules, styled-components, or StyleX). ## Quick Start Review the typography of my landing page components and report any issues with fonts, spacing, and wrapping.

Frequently Asked Questions about better-typography

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

FAQPage Schema
How do I fix typography issues in my web app?

Apply a small type scale with semantic names, map heading levels to descending scale steps, and cap line length around 60-75 characters. The Skill reviews your code and returns findings with severity, location, and before/after fixes in your project's styling system.

What font format should I use on the web?

Use woff2, which offers Brotli compression and broad browser support. Keep woff only as a fallback for very old browsers, and avoid serving raw ttf or otf files since they have no web compression.

How do I stop numbers from shifting layout when values change?

Apply font-variant-numeric: tabular-nums (the tabular-nums utility in Tailwind) to timers, counters, and prices. This gives every digit equal width so updating values no longer cause layout shift.

Does this work with Tailwind CSS projects?

Yes. Every CSS declaration covered maps to a Tailwind equivalent in the included cheat sheet, such as text-balance, text-pretty, tabular-nums, and antialiased. Fixes are always expressed in the styling system the project already uses.

Why does iOS Safari zoom in when I focus an input?

iOS Safari zooms the page when input text is smaller than 16px. Set inputs to text-base on mobile and sm:text-sm from the small breakpoint up, and avoid the maximum-scale=1 viewport meta since it blocks pinch zoom and fails WCAG.

When should I use font-variation-settings instead of font-weight?

Prefer font-weight and other high-level properties because they keep working with non-variable fallback fonts. Reserve font-variation-settings for custom axes like GRAD that have no corresponding CSS property.