All skills
mblode avatar

/typography-audit

@59baecd
by Matthew Blodemblode/agent-skills136 stars
12

Audits font loading, type scales, measure, spacing, OpenType, and rendered punctuation with 78 scoped rules. Use when asked to "audit typography", "fix the fonts", or "review my type system". For a new visual direction use ui-design Direction; for general UI defects use ui-design Audit.

Use this Skill: https://skilld.dev/gh/mblode/agent-skills/typography-audit

This session only. Nothing lands on disk.

rulesfont-optical-sizes.md

≈405 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Use Text and Display Optical Sizes Correctly

Many families ship optical-size variants, named Text, Display, Banner, Headline, Poster, Titling, or Caption, each tuned to a size range. Display cuts have finer details, tighter spacing, and higher contrast for large sizes. Text cuts have more open spacing, a larger x-height, and lower contrast for body readability.

Never use a Display, Banner, Headline, Poster, or Titling cut for body copy: the fine details disappear and the tight spacing closes up. Never use a Caption cut for web body text; it is drawn for very small print sizes. The reverse also shows: a text cut at 72px looks clunky and loose.

Incorrect (display cut used at body size):

body {
  font-family: 'Garamond Display', serif; /* designed for 24px+ */
  font-size: 16px; /* too small for a display cut */
}

Correct (text cut for body, display cut for headings):

body {
  font-family: 'Garamond Text', serif; /* optimized for 12-18px */
  font-size: 18px;
}

h1 {
  font-family: 'Garamond Display', serif; /* optimized for 24px+ */
  font-size: 48px;
}

Variable fonts with an opsz axis handle this automatically:

body {
  font-family: 'Garamond VF', serif;
  font-optical-sizing: auto; /* browser adjusts based on font-size */
}

A display cut also wants a richer OpenType feature set than body text; see display-headline-opentype. For swapping a display face out at small breakpoints, see size-responsive.

Source: SKILL.md on GitHub

1 warning9d5 checks · Risk SAFE
  • Gen Agent Trust Hub9d

    The typography-audit skill is a comprehensive and secure set of rules for auditing web typography. It provides guidelines for font selection, sizing, and layout through static markdown files. No malicious code, exfiltration attempts, or security vulnerabilities were detected.

  • Socket9d

    No alerts

  • Snyk9d

    Risk: LOW · No issues

  • Runlayer6mo

    2/92 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 59baecd. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 1 hour ago.

Activeupdated last week

README badge

README badge for mblode/agent-skills/typography-audit