Prototyping a typeface from a PRD
Overview
Write the PRD first, with numeric metrics, then draw. Glyphs are stroke skeletons on a 1000 UPM
grid, stroked per weight into specimen/glyphs.json; specimen, proof sheets and fonts all
render that file. Review every terminal and junction at every weight on proof sheets first.
Scripts read family and weights from font.json or the PRD.
When to use
A brief for a new font family or UI face; a font PRD; sample glyphs; a specimen or type tester;
an OTF/WOFF prototype. Not for editing existing fonts, hinting, kerning or full character sets.
Workflow
Project: docs/PRD.md, font.json, tools/glyphs.py, specimen/, fonts/, proofs/.
SKILL=~/.claude/skills/prototyping-typeface-from-prd.
- PRD. Write
docs/PRD.md from references/prd-template.md:
22 sections, numeric metrics (8), each mandated glyph as **glyph (subtitle)** plus bullets
with coordinates (9.1), weights table (12), Appendix A strings. Resolve conflicting metrics
there. Copy font.example.json to font.json.
- Metrics. Copy
glyphs.py to tools/glyphs.py; set its metrics block to PRD section 8.
Read references/glyph-construction.md first.
- Glyphs. Rewrite the
@glyph recipes to the PRD, mandated glyphs first; run glyphs.py.
- Review loop. Render the eight proof sheets in
references/review-checklist.md, Read every PNG, fix,
regenerate, re-render; Bold fails first.
- Specimen.
build_specimen.py creates specimen/index.html from the template once,
then refreshes only its marked regions.
- Fonts and tester.
python3 -m venv .venv && .venv/bin/pip install fonttools skia-pathops brotli,
then build_font.py --screenshot.
- Publish. Screenshot specimen and tester at 1280 and 400 px, Read them, publish both as
artifacts (checklist section 5).
Quick reference
All commands take --root <project> (default: cwd); all but build_font.py are stdlib-only.
| Script |
Output |
Command |
glyphs.py |
specimen/glyphs.json |
python3 tools/glyphs.py |
proof.py |
proof sheet per weight; --zoom, --png |
python3 $SKILL/scripts/proof.py proofs/lc1.html a b c --png proofs/lc1.png |
build_specimen.py |
specimen/index.html |
python3 $SKILL/scripts/build_specimen.py |
build_font.py |
OTF/WOFF/WOFF2 per weight, specimen/tester.html |
.venv/bin/python $SKILL/scripts/build_font.py --screenshot |
screenshot.py |
headless Chrome PNG; --wrap for doctype-less pages |
python3 $SKILL/scripts/screenshot.py specimen/index.html out.png --wrap --width 400 |
Common mistakes
| Mistake |
Fix |
| Clip-rectangle terminal trim leaves a sliver or wedge |
End the skeleton where the tangent gives the cut (12/6 o'clock for a vertical face, 3/9 horizontal) or use face_cut |
| Diagonal meeting a bar as two strokes: stepped corner (z Z 7 1 2 5 E) |
One filled polygon, mitres from diag_angle |
| Monoline double-storey a and s congest at Bold |
Counters ≥ 30, clearance ≥ 40, steeper terminals, ≤ 6 % width growth, documented |
| g tail counter fills at Bold |
Tail inner radius ≥ 60 at the boldest master |
| Arch overshoots or seams at its stem |
Skeleton tangent to the stem centre; stem overlaps 1 to 3 units into the arch |
| "g as in the reference image" |
PRD gives bowl box, stem x, tail radius, terminal x/y, clearances |
| Judging a fix from path data |
Re-render proof sheets after every fix; Read the PNGs |
| Conflicting PRD metrics (fixed descender vs minimum clearance) |
Reconcile in the PRD, never silently |
1---2name: prototyping-typeface-from-prd3description: Use when someone wants a new typeface or font designed from a brief, a font PRD written, sample glyphs drawn, a type specimen page, a WOFF/OTF prototype or an editable type tester, especially a geometric sans with letterform rules such as a straight t, a straight j, a single-storey g, and named weights (Light, Medium, Bold). Also use to review or extend an existing skeleton-based glyph generator.4metadata:5 source: https://skillmd.com/skills/mantlecurve/prototyping-typeface-from-prd6---78# Prototyping a typeface from a PRD910## Overview1112Write the PRD first, with numeric metrics, then draw. Glyphs are stroke skeletons on a 1000 UPM13grid, stroked per weight into `specimen/glyphs.json`; specimen, proof sheets and fonts all14render that file. Review every terminal and junction at every weight on proof sheets first.15Scripts read family and weights from `font.json` or the PRD.1617## When to use1819A brief for a new font family or UI face; a font PRD; sample glyphs; a specimen or type tester;20an OTF/WOFF prototype. Not for editing existing fonts, hinting, kerning or full character sets.2122## Workflow2324Project: `docs/PRD.md`, `font.json`, `tools/glyphs.py`, `specimen/`, `fonts/`, `proofs/`.25`SKILL=~/.claude/skills/prototyping-typeface-from-prd`.26271. **PRD.** Write `docs/PRD.md` from [references/prd-template.md](references/prd-template.md):28 22 sections, numeric metrics (8), each mandated glyph as `**glyph (subtitle)**` plus bullets29 with coordinates (9.1), weights table (12), Appendix A strings. Resolve conflicting metrics30 there. Copy `font.example.json` to `font.json`.312. **Metrics.** Copy `glyphs.py` to `tools/glyphs.py`; set its metrics block to PRD section 8.32 Read [references/glyph-construction.md](references/glyph-construction.md) first.333. **Glyphs.** Rewrite the `@glyph` recipes to the PRD, mandated glyphs first; run `glyphs.py`.344. **Review loop.** Render the eight proof sheets in35 [references/review-checklist.md](references/review-checklist.md), Read every PNG, fix,36 regenerate, re-render; Bold fails first.375. **Specimen.** `build_specimen.py` creates `specimen/index.html` from the template once,38 then refreshes only its marked regions.396. **Fonts and tester.** `python3 -m venv .venv && .venv/bin/pip install fonttools skia-pathops brotli`,40 then `build_font.py --screenshot`.417. **Publish.** Screenshot specimen and tester at 1280 and 400 px, Read them, publish both as42 artifacts (checklist section 5).4344## Quick reference4546All commands take `--root <project>` (default: cwd); all but `build_font.py` are stdlib-only.4748| Script | Output | Command |49|---|---|---|50| `glyphs.py` | `specimen/glyphs.json` | `python3 tools/glyphs.py` |51| `proof.py` | proof sheet per weight; `--zoom`, `--png` | `python3 $SKILL/scripts/proof.py proofs/lc1.html a b c --png proofs/lc1.png` |52| `build_specimen.py` | `specimen/index.html` | `python3 $SKILL/scripts/build_specimen.py` |53| `build_font.py` | OTF/WOFF/WOFF2 per weight, `specimen/tester.html` | `.venv/bin/python $SKILL/scripts/build_font.py --screenshot` |54| `screenshot.py` | headless Chrome PNG; `--wrap` for doctype-less pages | `python3 $SKILL/scripts/screenshot.py specimen/index.html out.png --wrap --width 400` |5556## Common mistakes5758| Mistake | Fix |59|---|---|60| Clip-rectangle terminal trim leaves a sliver or wedge | End the skeleton where the tangent gives the cut (12/6 o'clock for a vertical face, 3/9 horizontal) or use `face_cut` |61| Diagonal meeting a bar as two strokes: stepped corner (z Z 7 1 2 5 E) | One filled polygon, mitres from `diag_angle` |62| Monoline double-storey a and s congest at Bold | Counters ≥ 30, clearance ≥ 40, steeper terminals, ≤ 6 % width growth, documented |63| g tail counter fills at Bold | Tail inner radius ≥ 60 at the boldest master |64| Arch overshoots or seams at its stem | Skeleton tangent to the stem centre; stem overlaps 1 to 3 units into the arch |65| "g as in the reference image" | PRD gives bowl box, stem x, tail radius, terminal x/y, clearances |66| Judging a fix from path data | Re-render proof sheets after every fix; Read the PNGs |67| Conflicting PRD metrics (fixed descender vs minimum clearance) | Reconcile in the PRD, never silently |