mblode/agent-skills

typography-audit

Audits font loading, type scales, measure, spacing, OpenType, and rendered punctuation with 78 scoped rules.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/mblode/agent-skills --skill typography-audit

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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 codeCategories to load
@font-face, font-family, font files, variable fonts, font-stretch, transform: scaleX on textfont-
font-size, clamp(), media-query type changes, max-width on text, <em>/<strong>, text-decorationsize-
Copy in HTML/JSX (headings, paragraphs, labels)punct-
line-height, letter-spacing, word-spacing, margin on text, text-transform: uppercasespacing-
Heading elements, type scale tokens, --text-* propertieshierarchy-
text-align, lists, blockquotes, multi-column textlayout-
font-feature-settings, font-variant-*, figures/fractions in copyopentype-
Logo/wordmark styles, brand tokens, text color tokens, license commentsbrand-
Two or more distinct font-family valuespairing-
Hero/display sizes, drop caps, initial-letterdisplay-

Rule Categories by Priority

PriorityCategoryImpactPrefixRules
1Font Selection & WeightsCRITICALfont-11
2Sizing & MeasureCRITICALsize-6
3Punctuation & Special CharactersCRITICALpunct-12
4Spacing & RhythmHIGHspacing-8
5Hierarchy & ScaleMEDIUM-HIGHhierarchy-8
6Alignment & LayoutMEDIUMlayout-6
7OpenType FeaturesMEDIUMopentype-7
8Brand & IdentityMEDIUMbrand-8
9Typeface PairingMEDIUMpairing-5
10Display & HeadlinesLOW-MEDIUMdisplay-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 `&ldquo;`/`&rdquo;` (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.

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
mblode
社区

ui-animation

Builds, reviews, and measures UI motion, including springs, gestures, scroll effects, curve fitting from recordings, and sparse interface sound. Use when asked to "add animation", "match this easing", "reverse engineer this motion", "add a click sound", or find animation opportunities.

1小时安装量
2
GitHub Stars
211
最近更新
11月14日
mblode
社区

seo

Audits and fixes technical SEO, researches search demand, creates content briefs, and measures SEO, AEO and GEO performance. Use when asked to "audit SEO", "fix indexing", "improve AI visibility", "do AEO or GEO", "check keyword volume", "write an SEO brief", or "why did organic traffic drop". For Mintlify Agent Score, AFDocs, or Is Agentic reports use agent-ready. For writing the article use ghostwriter; for visual redesign use ui-design.

1小时安装量
2
GitHub Stars
203
最近更新
11月14日
mblode
社区

save-md

Saves a named source to Markdown with provenance and faithful extraction through direct export endpoints. Use when asked to "save this article", "get the markdown", "transcribe this", or "keep this source". A URL supplied as task context alone does not trigger conversion; a chat summary stays in chat.

1小时安装量
1
GitHub Stars
203
最近更新
11月14日
mblode
社区

codebase-architecture

Designs module interfaces, deepens shallow modules, and installs enforceable repository guardrails and agent wayfinding. Use when asked to "design the architecture", "simplify our modules", "find shallow modules", "harden the repo", "gate an unattended agent fix job", or "triage alerts with an agent".

1小时安装量
2
GitHub Stars
189
最近更新
11月5日