typography-audit — скилл для Claude Code: аудит типографики
Скилл typography-audit для Claude Code проверяет шрифты, размеры, интервалы, пунктуацию и текстовую вёрстку. Проводит аудит типографики интерфейса или PR.
MIT 1 200 установок ★ 216 обновлён 2026-10-24
npx skills add mblode/agent-skills --skill typography-audit -a claude-codeЧто делает typography-audit
typography-audit проверяет веб-типографику по 78 правилам в 10 категориях: загрузка шрифтов, размеры и ширина текста, пунктуация, интервалы, иерархия, выравнивание, OpenType, брендинг, сочетание гарнитур и display-текст. Для каждого найденного дефекта скилл требует указать файл, строку, идентификатор правила и исправление.
Сначала он ограничивает область изменёнными файлами или полным проходом, затем выбирает категории по сигналам в коде и запускает их по приоритету. После правок повторно проверяются правила, где были находки. Для PR скилл смотрит diff относительно фактической merge-base и фильтрует CSS, SCSS, HTML, TSX, JSX и шаблоны.
Это аудит типографики, а не общий обзор UI и не редизайн. Скилл не предлагает новые шрифты или шкалы, а направляет такие задачи в ui-design Direction; для проверки реально загруженного шрифта нужен ui-verification.
Какие задачи решает
- проверить загрузку шрифтов и начертания
- найти ошибки в размерах и межстрочных интервалах
- выявить прямые кавычки и другую неверную пунктуацию
- сопоставить текстовую иерархию с кодом
- разобрать проблемы OpenType и сочетания гарнитур
Примеры запросов агенту
- Проведи аудит типографики в изменённых файлах этого PR и укажи файл, строку, правило и исправление.
- Проверь полный проект: найди проблемы с загрузкой шрифтов, шириной текста и межстрочными интервалами.
- Повтори только те проверки, где были находки, и собери итоговый отчёт по приоритетам.
Как установить typography-audit
1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill typography-audit -a claude-code2Вручную: положить файлы
~/.claude/skills/typography-audit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/typography-audit/
1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill typography-audit -a codex2Вручную: положить файлы
.agents/skills/typography-audit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill typography-audit -a cursor2Вручную: положить файлы
.cursor/skills/typography-audit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mblode/agent-skills skills/typography-audit2Вручную: положить файлы
.github/skills/typography-audit/SKILL.md1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill typography-audit -a gemini-cli2Командой платформы
gemini skills install https://github.com/mblode/agent-skills --path skills/typography-auditВручную: положить файлы
.devin/skills/typography-audit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill typography-audit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о typography-audit
Как установить typography-audit в Claude Code?
Выполните npx skills add mblode/agent-skills --skill typography-audit -a claude-code. Файл скилла появится по пути ~/.claude/skills/typography-audit/SKILL.md.
Что делает typography-audit?
Скилл проводит аудит веб-типографики по 78 правилам: проверяет шрифты, размеры, интервалы, пунктуацию, иерархию и другие типографические признаки. В каждом результате указывает файл, строку, правило и способ исправления.
Чем typography-audit отличается от ui-design Audit?
typography-audit проверяет только типографику. ui-design Audit предназначен для более общего аудита интерфейса, включая доступность, формы и навигацию.
Исходный текст
SKILL.md · MIT
--- name: typography-audit description: 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. --- # Typography Audit 78 rules in 10 categories for web typography. Every finding names file, rule, and fix. - **IS:** typography only: font loading, sizing, punctuation, spacing, hierarchy, text layout, OpenType features, typeface pairing, brand type, display type. - **IS NOT:** broad UI review (accessibility, forms, navigation: use `ui-design` Audit mode), or a redesign (new typefaces, scales: use `ui-design` Direction mode). ## Audit Workflow Track this checklist: ```text Audit progress: - [ ] Step 1: Scope. List changed files (or full sweep), map signals to categories - [ ] Step 2: Run CRITICAL rules in scope (font-, size-, punct-) - [ ] Step 3: Run HIGH rules in scope (spacing-) - [ ] Step 4: Run remaining in-scope categories by descending priority - [ ] Step 5: Report per the contract; every finding has file:line, rule ID, fix ``` 1. Scope to changed files unless a full sweep is requested. For a PR, use the diff against its actual base merge-base, including committed changes, filtered to `.css`, `.scss`, `.html`, `.tsx`/`.jsx`, and template files. 2. Map code to categories via the signal table; skip categories with no signal. 3. Load rule files by prefix (`rules/font-*.md`, etc.), only for the categories the signals selected. 4. Run categories in priority order so CRITICAL findings surface even if the audit is cut short. 5. After fixes, re-run only the rules that produced findings, then finalize the report. ## Scoping Signals → Categories | Signal in code | Categories to load | |--------------------|--------------------| | `@font-face`, `font-family`, font files, variable fonts, `font-stretch`, `transform: scaleX` on text | `font-` | | `font-size`, `clamp()`, media-query type changes, `max-width` on text, `<em>`/`<strong>`, `text-decoration` | `size-` | | Copy in HTML/JSX (headings, paragraphs, labels) | `punct-` | | `line-height`, `letter-spacing`, `word-spacing`, `margin` on text, `text-transform: uppercase` | `spacing-` | | Heading elements, type scale tokens, `--text-*` properties | `hierarchy-` | | `text-align`, lists, blockquotes, multi-column text | `layout-` | | `font-feature-settings`, `font-variant-*`, figures/fractions in copy | `opentype-` | | Logo/wordmark styles, brand tokens, text color tokens, license comments | `brand-` | | Two or more distinct `font-family` values | `pairing-` | | Hero/display sizes, drop caps, `initial-letter` | `display-` | ## Rule Categories by Priority | Priority | Category | Impact | Prefix | Rules | |----------|----------|--------|--------|-------| | 1 | Font Selection & Weights | CRITICAL | `font-` | 11 | | 2 | Sizing & Measure | CRITICAL | `size-` | 6 | | 3 | Punctuation & Special Characters | CRITICAL | `punct-` | 12 | | 4 | Spacing & Rhythm | HIGH | `spacing-` | 8 | | 5 | Hierarchy & Scale | MEDIUM-HIGH | `hierarchy-` | 8 | | 6 | Alignment & Layout | MEDIUM | `layout-` | 6 | | 7 | OpenType Features | MEDIUM | `opentype-` | 7 | | 8 | Brand & Identity | MEDIUM | `brand-` | 8 | | 9 | Typeface Pairing | MEDIUM | `pairing-` | 5 | | 10 | Display & Headlines | LOW-MEDIUM | `display-` | 7 | Category map and impact rationale: `rules/_sections.md`. Each rule file gives why it matters plus an incorrect and a correct example. Category impact reflects the category's worst-case rules; report findings with the rule's own frontmatter `impact`, which frequently differs (e.g. `brand-color` is HIGH inside the MEDIUM `brand-` category because it holds the WCAG contrast floor). ## Review Output Contract Report findings as: ```markdown ## Typography Audit Findings ### path/to/file.css - [CRITICAL] `punct-smart-quotes` (file.css:42): Straight quotes in heading copy. - Fix: Replace `"` with `“`/`”` (or UTF-8 curly quotes). - [CRITICAL] `size-line-height` (file.css:18): `line-height: 20px`, a fixed value the 48px `h1` inherits, so its lines overlap. - Fix: Use unitless `line-height: 1.5`. ### path/to/clean-file.css - ✓ pass ``` - Group by file; order by impact within file. - Every finding: impact tag, rule ID, `file:line`, one-line issue, fix. - Include clean files as `✓ pass` so coverage is visible. - End with a summary: counts per impact level. ## Gotchas - Don't preload every rule file. Load only the prefixes the signal table selects; a full load spends the budget on categories with no signal in scope. - Report the rule's frontmatter `impact`, never the category's. Two rules get misreported most: `brand-color` is HIGH (an accessibility floor, not a brand nicety) and `punct-daggers` is LOW-MEDIUM (decoration, despite sitting in a CRITICAL category). - Punctuation rules apply to rendered copy only. Flagging straight quotes or `--` inside `<code>`, `<pre>`, or JS/TS string literals is a false positive; "fixing" them breaks the code. - Confirm the rendered font and computed styles through `ui-verification` when a finding depends on them. A CSS declaration alone does not prove which face loaded. - Don't flag missing OpenType features without confirming the loaded font ships them. Browsers silently ignore unsupported `font-feature-settings` tags, so the fix does nothing. - Every finding needs `file:line` and a concrete fix; an unactionable finding forces a redo. - An audit is not a redesign. Proposing new pairings or scales turns a 10-minute review into a design project; flag the issue and route redesign asks to `ui-design`. - Don't equalize priorities. A LOW-MEDIUM `display-` nit above a CRITICAL faux-bold finding buries what actually looks broken. ## Related Skills - `ui-design` Audit mode: broad frontend quality (accessibility, forms, navigation, motion); its typography coverage is shallower. - `ui-design` Direction mode: choosing typefaces, scales, and visual direction from scratch; run when a finding becomes a redesign request. - `ghostwriter`: heading and label wording. This skill governs only the casing of that copy (`punct-case-rules`). Maintenance only: `evals/evals.json` contains regression scenarios for changes to this skill; it does not load during a user task.
© mblode · MIT · mblode/agent-skills