typography

Installation
SKILL.md

Typography

Overview

Ready-to-use type systems (Product UI, Editorial, Marketing, Docs/Technical) plus the methodology to size text, build scales, set vertical rhythm, and pick fonts — so generated UI is readable instead of tiny, thin, and low-contrast.

Core principle: size text by role on a scale, never by eyeballed pixels. Pick a base (16px), a ratio (~1.2), and derive every size from it — then keep every role above the readability floor, because most "impossible to read" output violates at least one of its four numbers.

The readability floor (the contract)

These are the recede-defaults. Meet all four and text is legible by construction; deviate only deliberately and name the reason (a 14px compact scale for genuine enterprise density is a legitimate reason — "it looked better" is not).

Floor Default Why
Size body ≥ 16px / 1rem Browser default; iOS zooms <input> under 16px. Captions never < 14px — the hard floor for any text.
Weight body ≥ 400 Weights 100–300 thin the stroke and drop perceived contrast on small text.
Contrast text ≥ 4.5:1 (large ≥ 3:1) WCAG 2 AA. Re-check dark mode / thin fonts with APCA — WCAG2 overstates contrast near black.
Line-height body ≥ 1.5 Cramped leading hurts reading and fails the WCAG 1.4.12 spacing override.
Installs
27
GitHub Stars
3
First Seen
Jun 26, 2026
typography — antjanus/skillbox