What is the Web Typography skill?
Web Typography is a skill in the wondelai/skills collection. It gives an AI coding agent a framework for choosing and pairing typefaces, setting size, line length and line height, building hierarchy, and loading fonts fast, then scores the result against a 10 row diagnostic.
Web Typography is one skill folder inside wondelai/skills, a collection of 66 agent skills. Its SKILL.md turns a typography guide into rules an AI coding agent can follow when it picks fonts or writes CSS for text.
It triggers on requests such as font pairing, line height, type hierarchy, variable fonts or text that is hard to read. It covers evaluation, CSS and performance, and points to five reference files for detail.
What changes in the agent's output
- Body text starts at 16px or larger, with line length held to about 45 to 75 characters using ch units or max-width.
- Line height is set by context: 1.4 to 1.8 for body, tighter for headlines.
- Headings follow one ratio between 1.2 and 1.5 instead of arbitrary sizes.
- Every font-family gets a system fallback stack, and web fonts load with font-display swap.
- The agent states a score out of 10 and names the diagnostic rows that fail.
Who the skill is for
Best for
- Content sites, blogs and documentation where reading comfort decides whether people stay.
- Choosing between system fonts and web fonts, and cutting the font payload.
- Reviewing a page that feels cramped, cluttered or hard to scan.
- Teams that want type decisions justified by purpose rather than taste.
Not for
- Whole design systems. The skill's own description sends you to refactoring-ui for that.
- Dramatic, expressive type. The description points to top-design instead.
- Licensing advice. It reminds you to check web licenses but does not give legal guidance.
Use it with UiChemy
Typography rules apply wherever the page ends up. If the page is built in WordPress, UiChemy Composer writes HTML, CSS and JS for it, so type values from this skill can be carried over by hand. Click Get Started on uichemy.com.
How to install Web Typography Skill: Font Pairing and Type Rules for AI Agents
/plugin marketplace add wondelai/skillsThe README says the collection works with Claude Code, Codex, Cursor, OpenClaw, Hermes Agent and other agentskills.io compatible agents.Add the marketplace
In an agent that supports plugin marketplaces, run
/plugin marketplace add wondelai/skills.Install the UX design collection
Run
/plugin install ux-design@wondelai-skills. The README lists Web Typography in that collection along with Refactoring UI and Top Design.Or copy the folder
Run
git clone https://github.com/wondelai/skillsand copy theweb-typographyfolder into your agent's skills directory.Ask a typography question
Prompt the agent with a task such as choosing a font pairing for a blog, then check that it cites the measure and line height rules.
Check that it loaded
Ask the agent to review a page's typography. It should reply with a score out of 10 and name the diagnostic rows that fail.
Key features
- Two contexts for typeSplits type for a moment, such as headlines and buttons, from type to live with, such as body text. Each context gets different priorities: personality for the first, readability and endurance for the second.
- Reading mechanicsExplains saccades, fixations and word shapes, then ties them to choices about line length and spacing. Includes the difference between legibility, which is a typeface concern, and readability, which is a setting concern.
- Typeface evaluationChecks stroke consistency, kerning pairs, character set, weights, x-height and open counters. Tells the agent to test at real sizes with real content and to verify the web license first.
- Pairing strategiesPairs by clear contrast: structure, weight, era or width. Limits a page to one or two faces and lists failures such as two near-identical faces competing.
- Measurement rulesBody at 16px minimum, 18px for reading-heavy sites, measure of 45 to 75 characters with 66 as the target, and line height of 1.4 to 1.8 for body text.
- Hierarchy with three leversSize, weight and color are the levers. Vary one or two between adjacent levels, never all three, and use the squint test to confirm the hierarchy still shows.
- Fluid type with clamp()Replaces breakpoint jumps with clamp(min, preferred, max) so text scales smoothly. Suggests slightly larger body text on mobile and a tighter heading scale.
- Font loading budgetKeeps total font payload under 200KB, prefers WOFF2, uses font-display swap, preloads critical fonts, subsets by language and notes a variable font can replace 4 to 6 static files.
- Common mistakes tableLists nine failures with a fix each, from cramped lines and long measure to blurry text, clashing faces and testing with placeholder text.
- Quick diagnostic and scoringTen yes or no checks, including 200% zoom survival, fallbacks and distinct links. The agent reports how many pass and which rows fail.
Frequently asked questions
What is the Web Typography skill?
It is the web-typography folder in wondelai/skills, a SKILL.md that teaches an AI coding agent how to select, pair and implement typefaces for the web. It covers readability, CSS implementation and font-loading performance, and it asks the agent to score the result out of 10.
How do I install the Web Typography skill?
Add the marketplace with /plugin marketplace add wondelai/skills, then run /plugin install ux-design@wondelai-skills, which the README lists as including Web Typography. Without plugins, clone the repository and copy the web-typography folder into your agent's skills directory.
Does Web Typography work with Cursor, Codex and Claude Code?
The wondelai/skills README says its skills work with Claude Code, Codex, Cursor, OpenClaw, Hermes Agent and other agentskills.io compatible agents. Install steps differ by agent, so use the plugin route where supported or copy the folder into the agent's skills path.
What line length and line height does it recommend?
It recommends 45 to 75 characters per line with 66 as the ideal, enforced through ch units or max-width. For line height it gives 1.4 to 1.8 for body text and about 1.1 to 1.25 for headlines, with longer lines needing more.
How does it handle web font performance?
It sets a font budget under 200KB, prefers WOFF2, adds font-display swap with system fallbacks, preloads critical fonts, subsets to the characters needed, and suggests a variable font in place of several static weights.
What are Web Typography skill alternatives?
For type scale work inside a larger design pass, see the typeset command in Impeccable. For layout rhythm, layout covers spacing, and tailwind-design-system covers tokens. Web Typography is narrower and goes deeper on fonts.
Can the skill fix type in a WordPress site?
It writes and reviews CSS and font loading advice, so you can apply the values in any theme or builder. UiChemy Composer writes HTML, CSS and JS for WordPress pages, which suits applying them. Click Get Started on uichemy.com.
Is the Web Typography skill free?
The wondelai/skills repository is published under the MIT license, and the web-typography folder lists MIT in its SKILL.md. The repository shows no price for individual skills, so you can read the SKILL.md and the five reference files before adding it to an agent.


