Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
mblode avatar

Typography Audit

  • 479 installs
  • 74 repo stars
  • Updated August 5, 2026
  • mblode/agent-skills

typography-audit is an agent skill that lints web UI typography against 90 rules for hierarchy, font pairing, and responsive type consistency for developers who need pre-release typography QA.

About

typography-audit is a Claude Code agent skill from mblode/agent-skills that audits web projects against 90 typography rules across ten categories, covering punctuation, font stacks, sizing, spacing, OpenType features, hierarchy, and typeface pairing. The skill loads rule categories progressively, prioritizes critical punctuation and font setup problems over medium polish items, and reports findings with file locations and concrete CSS fixes instead of redesign suggestions. Developers reach for typography-audit when reviewing CSS typography systems, validating font stack configuration, or catching common web type errors such as straight quotes, faux italics, and font-weight bold fakes before merge or release. typography-audit complements ui-audit surface typography sweeps by going deeper on pairing, brand identity, and display type while staying honest about scope: it audits existing work against best practices rather than inventing new scales. Install with npx skills add https://github.com/mblode/agent-skills --skill typography-audit and invoke during design QA or pre-release frontend reviews.

  • Type scale and hierarchy checks
  • Readability and contrast review
  • Font pairing consistency
  • Responsive typography audit
  • Actionable remediation list

Typography Audit by the numbers

  • 479 all-time installs (skills.sh)
  • +50 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #607 of 1,880 Design & UI/UX skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/mblode/agent-skills --skill typography-audit

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs479
repo stars74
Last updatedAugust 5, 2026
Repositorymblode/agent-skills

How do you audit web typography before release?

Audit live or in-progress UIs for typography scale, hierarchy, readability, font pairing, and responsive type consistency before release.

Who is it for?

Frontend developers polishing CSS typography systems, font stacks, and responsive type scales before a UI ships.

Skip if: Developers who need a new typography scale designed from scratch rather than linting existing CSS against best-practice rules.

When should I use this skill?

User asks to audit typography, check font hierarchy, review type scale consistency, or catch web type errors before merge.

What you get

Prioritized typography findings with file paths, impact ratings, and concrete CSS or font-stack fixes across ten rule categories.

  • Prioritized typography finding report
  • Per-file CSS fix recommendations

By the numbers

  • Covers 90 typography rules across 10 categories
  • Prioritizes critical punctuation and font-stack issues over medium polish items

Files

SKILL.mdMarkdownGitHub ↗

Typography Audit

89 rules across 10 categories for web typography quality. Focuses on concrete issues with concrete fixes.

Audit Workflow

Copy and track this checklist during the audit:

Audit progress:
- [ ] Step 1: Scope changed surfaces and select relevant categories
- [ ] Step 2: Run CRITICAL checks (punctuation, font setup)
- [ ] Step 3: Run HIGH checks (sizing, spacing)
- [ ] Step 4: Run MEDIUM+ checks for remaining categories in scope
- [ ] Step 5: Report findings with file:line and concrete fixes

1. Audit only changed files unless a full sweep is requested. 2. Scan CSS for font-family, @font-face, font-feature-settings, and sizing/spacing properties to identify relevant categories. 3. Load rule files progressively by category prefix — read only what applies. 4. Prioritize CRITICAL and HIGH findings before medium-priority polish. 5. After fixes, rerun the relevant rules before finalizing.

Rule Categories by Priority

PriorityCategoryImpactPrefixRules
1Punctuation & Special CharactersCRITICALpunct-12
2Font Selection & WeightsCRITICALfont-10
3Sizing & MeasureHIGHsize-7
4Spacing & RhythmHIGHspacing-10
5OpenType FeaturesMEDIUM-HIGHopentype-8
6Hierarchy & ScaleMEDIUM-HIGHhierarchy-8
7Alignment & LayoutMEDIUMlayout-8
8Typeface PairingMEDIUMpairing-10
9Brand & IdentityLOW-MEDIUMbrand-8
10Display & HeadlinesLOW-MEDIUMdisplay-8

Quick Reference

Read only what is needed for the current audit scope:

  • Category map and impact rationale: rules/_sections.md
  • Rule-level guidance and examples: rules/<prefix>-*.md

Example rule files:

rules/punct-smart-quotes.md
rules/font-true-styles.md
rules/size-line-height.md

Each rule file contains:

  • Why the rule matters
  • Incorrect example
  • Correct example

Review Output Contract

Report findings in this format:

## Typography Audit Findings

### path/to/file.css
- [CRITICAL] `punct-smart-quotes`: Straight quotes used in heading text.
  - Fix: Replace `"` with `&ldquo;`/`&rdquo;` entities.

### path/to/clean-file.css
- ✓ pass
  • Group findings by file.
  • Use file:line when line numbers are available.
  • State issue and propose a concrete fix.
  • Include clean files as ✓ pass.

Gotchas

  • Don't load all 89 rules up front — load progressively by category prefix in scope.
  • Don't report findings without file:line and a concrete fix — incomplete findings waste the reader's time.
  • Don't audit unchanged files when a full sweep wasn't requested.
  • Don't treat MEDIUM/LOW polish as equal priority to CRITICAL punctuation or font-setup issues — order findings by impact.
  • Don't suggest typography redesigns (new font pairings, new scales) in an audit. Audits report issues with fixes; redesigns are a separate ask.
  • Don't flag OpenType features as missing without checking whether the loaded font actually ships them.

Related skills

How it compares

Pick typography-audit over ui-audit when the goal is deep typography linting—pairing, OpenType, and display type—rather than broad page-level UI quality checks.

FAQ

How many typography rules does typography-audit check?

typography-audit checks web projects against 90 typography rules organized into ten categories, from critical punctuation and font setup through OpenType features, hierarchy, and typeface pairing.

Does typography-audit redesign my type scale?

typography-audit audits existing CSS typography against best-practice rules and reports concrete fixes with file locations. typography-audit does not propose new scales or redesign brand typography systems.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.