Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Przegląd i audyt

typography-audit

/typography-audit

Audytuje ładowanie fontów, skale typograficzne, miarę, odstępy, OpenType i wyrenderowaną interpunkcję według 78 reguł.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
82
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Audytuje ładowanie fontów, skale typograficzne, miarę, odstępy, OpenType i wyrenderowaną interpunkcję według 78 reguł.

Wyzwalacze z opisu

audit typographyfix the fontsreview my type system
Oryginalny opis (EN)

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.

Jak działa

  1. Audit Workflow
  2. Scoping Signals → Categories
  3. Rule Categories by Priority
  4. Review Output Contract
  5. Gotchas
  6. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 100 linii, 942 słów
Podgląd SKILL.md
---
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 `&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.
Pliki w paczce (82)
  • SKILL.md 6 KB
  • evals/evals.json 1 KB
  • rules/_sections.md 3 KB
  • rules/_template.md 1 KB
  • rules/brand-capitalization.md 1 KB
  • rules/brand-color.md 1 KB
  • rules/brand-cross-medium.md 1 KB
  • rules/brand-dark-backgrounds.md 1 KB
  • rules/brand-equity.md 1 KB
  • rules/brand-identifiable-body.md 1 KB
  • rules/brand-licensing.md 1 KB
  • rules/brand-logo-typeface.md 1 KB
  • rules/display-drop-caps.md 1 KB
  • rules/display-grid-breaking.md 1 KB
  • rules/display-headline-opentype.md 1 KB
  • rules/display-headline-spacing.md 1 KB
  • rules/display-large-type.md 1 KB
  • rules/display-lead-paragraph.md 1 KB
  • rules/display-swashes.md 1 KB
  • rules/font-body-selection.md 1 KB
  • rules/font-condensed-extended.md 2 KB
  • rules/font-face-setup.md 1 KB
  • rules/font-fallbacks.md 1 KB
  • rules/font-monospaced.md 1 KB
  • rules/font-optical-sizes.md 2 KB
  • rules/font-quality.md 1 KB
  • rules/font-rendering.md 1 KB
  • rules/font-true-styles.md 2 KB
  • rules/font-variable-fonts.md 1 KB
  • rules/font-weight-body.md 1 KB
  • rules/hierarchy-body-first.md 1 KB
  • rules/hierarchy-caps-subheads.md 1 KB
  • rules/hierarchy-consistent-system.md 1 KB
  • rules/hierarchy-heading-color.md 1 KB
  • rules/hierarchy-heading-levels.md 1 KB
  • rules/hierarchy-modular-scale.md 1 KB
  • rules/hierarchy-size-contrast.md 1 KB
  • rules/hierarchy-weight-contrast.md 1 KB
  • rules/layout-center-alignment.md 1 KB
  • rules/layout-justified-text.md 1 KB
  • rules/layout-lists.md 2 KB
  • rules/layout-optical-balance.md 1 KB
  • rules/layout-proximity-dividers.md 1 KB
  • rules/layout-widows-orphans.md 1 KB
  • rules/opentype-body-features.md 1 KB
  • rules/opentype-kerning.md 1 KB
  • rules/opentype-ligatures.md 1 KB
  • rules/opentype-monoscript-kerning.md 1 KB
  • rules/opentype-oldstyle-figures.md 1 KB
  • rules/opentype-small-caps.md 1 KB
  • rules/opentype-tabular-figures.md 1 KB
  • rules/pairing-contrast-harmony.md 2 KB
  • rules/pairing-limit-typefaces.md 1 KB
  • rules/pairing-stress-skeleton.md 2 KB
  • rules/pairing-superfamilies.md 1 KB
  • rules/pairing-ui-fonts.md 1 KB
  • rules/punct-abbreviations.md 1 KB
  • rules/punct-ampersands.md 1 KB
  • rules/punct-case-rules.md 1 KB
  • rules/punct-daggers.md 1 KB
  • rules/punct-dashes.md 1 KB
  • rules/punct-diacritics.md 1 KB
  • rules/punct-fractions.md 1 KB
  • rules/punct-midpoints.md 1 KB
  • rules/punct-primes.md 1 KB
  • rules/punct-single-space.md 1 KB
  • rules/punct-smart-quotes.md 1 KB
  • rules/punct-symbols.md 1 KB
  • rules/size-body-text.md 1 KB
  • rules/size-emphasis.md 2 KB
  • rules/size-hanging-punctuation.md 1 KB
  • rules/size-line-height.md 1 KB
  • rules/size-line-length.md 1 KB
  • rules/size-responsive.md 1 KB
  • rules/spacing-hair-thin-spaces.md 1 KB
  • rules/spacing-letterspacing-body.md 1 KB
  • rules/spacing-letterspacing-uppercase.md 2 KB
  • rules/spacing-nav-items.md 1 KB
  • rules/spacing-paragraph-indent.md 1 KB
  • rules/spacing-paragraph-margins.md 2 KB
  • rules/spacing-paragraph-separation.md 1 KB
  • rules/spacing-subhead-proximity.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · mblode/agent-skills100MIT
OutlineDriven/outline-driven-development100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki dcc25dcce469 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100typography-font-stinger
    Buduje system typografii webowej: fonty zmienne, ładowanie fontów, skale płynne, rytm pionowy i tokeny typograficzne.
  • 100typography
    Dobiera skale typograficzne, pary fontów, hierarchię nagłówków i wczytywanie fontów do stron internetowych.
  • 100better-typography
    Pomaga w typografii webowej od doboru fontów po odstępy, zawijanie i dostępność: pary krojów, fonty zmienne, OpenType, skala typograficzna i hierarchia nagłówków.
  • 100better-typography
    Dobiera i wdraża typografię stron: kroje pisma, wagi, skalę, rytm, zawijanie i akcenty dla dostępności.
  • 100ui-design-system
    Tworzy i utrzymuje system projektowy: tokeny, specyfikacje komponentów, palety, skale typografii i odstępy.
  • 100typography-expert
    Prowadzi dobór, parowanie i wdrażanie krojów pisma: katalog krojów i foundry, ramy wyboru według nastroju i epoki, skale płynne, osie fontów zmiennych, OpenType i wydajność web fontów.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.