Skip to main content
skill CX Codex

typography-scale-builder — Claude Code skill: setup & use

typography-scale-builder — a Claude Code skill that designs typographic systems with modular or fluid type scales. It audits existing font values across the codebase and outputs design tokens, CSS, and Tailwind configs.

MIT 116 installs ★ 440 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OneWave-AI/claude-skills --skill typography-scale-builder -a claude-code
Open on GitHub

What typography-scale-builder does

The skill scans the codebase to catalog font sizes, line heights, letter spacing, and weights. It highlights arbitrary values, then organizes them into an explicit ratio-based hierarchy. The base size and scaling factor adapt to the product context, supporting fluid clamp() formulas for marketing layouts or fixed steps for compact application interfaces.

Each scale step receives matching vertical rhythm rules, tighter line-height for headings, and negative tracking for display sizes. Output assets include typography-tokens.json, CSS utility classes in typography.css, documentation in TYPOGRAPHY.md, and Tailwind fontSize settings configured for v4 @theme.

The skill relies on file inspection and editing tools (Read, Grep, Write, Edit, Bash). Component refactoring maps legacy hardcoded font sizes directly to semantic token roles like body or display.

What it helps with

  • audit font sizes and weights across a repository
  • calculate fluid heading scales using CSS clamp()
  • export typography design tokens into JSON, CSS, and Tailwind
  • refactor hardcoded font utility classes into semantic type roles

Example prompts for the agent

  • Build a type system for this project
  • Audit my typography
  • Make my headings fluid

How to install typography-scale-builder

1Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill typography-scale-builder -a claude-code

2Manually: put the files in place

~/.claude/skills/typography-scale-builder/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/typography-scale-builder/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about typography-scale-builder

How to install typography-scale-builder in Claude Code?

Run npx skills add OneWave-AI/claude-skills --skill typography-scale-builder -a claude-code. The skill file installs to ~/.claude/skills/typography-scale-builder/SKILL.md.

What does typography-scale-builder do?

It audits typography usage across a project, calculates a mathematical type scale with proportional line heights and letter spacing, and outputs design tokens.

What files does the skill generate?

It produces typography-tokens.json, typography.css, TYPOGRAPHY.md, and a Tailwind configuration block for fontSize or the @theme directive.

Source text

SKILL.md · MIT
---
name: typography-scale-builder
description: Build a complete typographic system -- modular or fluid type scale, line-height and tracking per size, weight roles, and vertical rhythm -- exported as tokens, Tailwind config, and CSS. Pairs with font-pairing-suggester (which picks the fonts; this builds the system they live in).
tools: Read, Glob, Grep, Write, Edit, Bash
model: inherit
---

# Typography Scale Builder

Typography is the design system's skeleton: most products that look "off" have inconsistent type long before they have bad colors. Build the scale as a system with roles and math, then make the codebase actually use it. Input: the chosen fonts (or run `font-pairing-suggester` first), the product type (marketing site, dense app UI, long-form editorial), and the target range of devices.

## Workflow

1. **Audit what exists.** Inventory every font-size, line-height, letter-spacing, and font-weight in the codebase. The typical finding -- 23 font sizes, 9 of them within 2px of each other -- is the case for the system. Map which are actually distinct roles vs. accumulated drift.
2. **Choose the scale math.** Base size (16px body floor for marketing/editorial; 13-14px acceptable for dense app UI) and ratio -- modest for UI-heavy products (1.125-1.2, more usable steps, less drama), larger for marketing/editorial (1.25-1.333, real hierarchy). Fluid by default for marketing sites: `clamp()` per step so headings scale between viewport bounds without breakpoint jumps; fixed steps are fine for app UI.
3. **Set the companions per step** -- the part single-number "scales" skip: line-height tightens as size grows (body ~1.5-1.6, headings down to 1.1-1.2 at display sizes); letter-spacing goes negative at display sizes (-1% to -2.5%) and slightly positive for small caps/labels; weight roles per font (which weight is body, emphasis, heading, display -- and which loaded weights get deleted because nothing uses them).
4. **Define the roles.** Semantic tokens, not size names: `display`, `h1`-`h4`, `body-lg`, `body`, `body-sm`, `caption`, `overline`, `code`. Each role = size step + line-height + tracking + weight + family, as one token. Components consume roles; nobody composes raw steps.
5. **Vertical rhythm.** Spacing-after rules per role (heading margins proportional to their size, paragraph spacing from body line-height), `text-wrap: balance` on headings, and measure limits (65-75ch for body prose) so line length stays readable at every viewport.
6. **Export and retrofit.** `typography-tokens.json`, Tailwind `fontSize` config (size + line-height + tracking tuples per role; v4 `@theme`), `typography.css` with role classes, and `TYPOGRAPHY.md`. Then map the step-1 inventory onto roles and replace -- with a per-case flag on anything that does not cleanly map (it is either a missing role or drift to delete).

## Rules

- Roles over sizes everywhere: `text-h2`, never `text-[28px]` -- and no role means the component asks the system for one, not the developer for a number.
- Every step ships with its line-height and tracking. A size without its companions is half a token.
- The scale has as few steps as hierarchy needs -- 7-9 roles cover almost any product; 12+ means roles are duplicating.
- Body text is the anchor: it gets sized for reading first, and the scale grows around it -- never shrink body to make headings look bigger.
- Load only the weights the roles use. Every unused weight is dead bytes on first paint.
- Fluid type gets floor and ceiling checks: the `clamp()` minimum must stay readable on a 320px phone and the max must not blow the layout on ultrawide.

## Quick Commands

- "Build a type system for this project" -- full workflow
- "Audit my typography" -- step 1 only
- "Make my headings fluid" -- fluid conversion of an existing scale
- "Retrofit components" -- step 6 against an existing system

© OneWave-AI · MIT · OneWave-AI/claude-skills

Similar skills

All skills for Design →

From the same set185

The whole set →
product-launch-war-room product-launch-war-room is a Claude Code skill that tests a launch plan against expert and customer viewpoints, then returns a decision and rollout steps. Run it for a product launch, repricing, or repositioning. CX Codex +1 159installs pricing-change-strategist pricing-change-strategist plans a price increase or tier restructure with churn modeling. CX Codex +1 158installs hyperframes-sales-demo-builder hyperframes-sales-demo-builder — a skill for Claude Code, Codex, Cursor and other platforms that builds a prospect-specific demo video in HyperFrames. CX Codex +1 157installs before-you-build The before-you-build skill identifies the main risk in an idea and suggests a small test before implementation starts. Use it to assess a product, feature, MVP, agent, or automation. CX Codex +1 130installs local-seo-optimizer local-seo-optimizer — a Claude Code skill for local SEO audits and Google Business Profile optimization. Identifies listing gaps and benchmarks performance against map pack competitors. CX Codex +1 114installs cowork-rfp-response cowork-rfp-response — a skill for Claude Code that shreds RFP documents and maps requirements against company archives. It flags unanswerable criteria and disqualifiers before drafting starts. CX Codex +1 112installs review-response-writer The review-response-writer Claude Code skill drafts review replies in the owner’s voice and sorts reviews by situation. It flags mentions of injury, illness, discrimination, or legal threats for the owner. CX Codex +1 110installs dark-mode-converter The dark-mode-converter Claude Code skill turns a light-only project into a dark theme built around semantic color roles. It also wires up theme switching and saved preferences. CX Codex +1 108installs

Project sponsors

Companies that keep this analytics open