CommunityBildgithub.com

Schriftdesign

Entwerfen, bauen und ausliefern einer benutzerdefinierten Display-Schriftart für eine Website als selbst gehostete variable Webfont – eine parametrische Schrift, die für die Marke gezeichnet und durch drei Runden Konzeptseiten ausgewählt wird.

Was ist Schriftdesign?

Diese Fähigkeit ermöglicht es KI-Agenten, einen vollständigen Workflow zur Erstellung einer maßgeschneiderten Display-Schriftart (Typeface) für eine Website zu steuern. Der Prozess umfasst neun klar definierte Phasen mit jeweils einem Gate (Entscheidungspunkt), an dem der menschliche Operator die Kontrolle übernimmt. Der Agent beginnt mit einer Prüfung der bestehenden Website, leitet daraus Gestaltungsrichtlinien ab, wählt in drei Runden von Konzeptseiten ein Design aus, erstellt einen detaillierten Bauplan (der von einer unabhängigen Person überprüft wird), baut die Schrift mit automatischen Selbstprüfungen, testet sie auf echten Seiten und führt die finale Änderung nach einer weiteren unabhängigen Überprüfung aus. Die Fähigkeit ist sowohl für große Neuentwicklungen als auch für kleine Parameteranpassungen ausgelegt. Sie ist für Claude Code, Codex und ähnliche Entwicklungswerkzeuge vorgesehen, die in einer Bash-Umgebung (macOS/Linux) laufen. Die Implementierung stützt sich auf Python-Skripte (mit fonttools, brotli, uharfbuzz etc.), Node.js, Chrome und vordefinierte Vorlagen. Die Ausgabe ist eine selbst gehostete variable Webfont, die direkt in das Site-Repository integriert wird.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/windaddict/font-design-skill/tree/HEAD

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Schriftdesign?

Version 0.2.0 – die alleinige Quelle der Wahrheit ist die Datei VERSION im Repository-Stamm; diese Zeile, die Frontmatter und das README-Abzeichen werden von tests/test_versions_and_skill.py dagegen geprüft. Nenne diese Versionsnummer, wenn du beginnst, damit der Operator weiß, welche Kopie antwortet.

Diese Fähigkeit erstellt eine Schriftart so, wie Bract (hopsafari.com, 2026-11-15) erstellt wurde: die neun Phasen unten, einmal vollständig durchlaufen. Der Generator und viele der Regeln stammen von einer früheren Schrift, Driftwood (movingavg.com, 2026-11-14), die erstellt wurde, bevor der Prozess niedergeschrieben wurde, durch eine statische Union-Pipeline in fünf CFF-Dateien; ihre Lehren und die drei später darin gefundenen Fehler haben die Fähigkeit geprägt, aber sie durchlief diese Phasen nicht. Beide sind Entwürfe von John Knox (NOTICE.md). Die Form der Arbeit ist: Prüfe die Website, leite Richtlinien ab, wähle ein Design über drei Runden Konzeptseiten aus, plane den Bau und lasse den Plan unabhängig überprüfen, baue mit Selbstprüfungen, überprüfe die gebaute Schrift auf echten Seiten, bis eine Runde nichts mehr findet, lasse die abgeschlossene Änderung unabhängig überprüfen, veröffentliche. Die Fähigkeit läuft mit wenig Überwachung zwischen den Gates und hält an jedem Gate an.

Inhalt

  1. Vorbereitung
  2. Die neun Phasen (jede mit ihrem Gate)
  3. Arbeiten mit wenig Überwachung
  4. Veröffentlichungssperren
  5. Was die Werkzeuge sind und was jedes beweist
  6. Referenzindex

1. Vorbereitung

  1. Nenne die Version (oben) und klassifiziere die Änderung. Eine siteweite Display-Schrift ist eine wesentliche Änderung: Sie betrifft öffentliche Seiten und ist schwer rückgängig zu machen, sobald sie verlinkt und gecacht ist. Befolge die vollständige Reihenfolge: Plan → unabhängige Überprüfung → Bau → unabhängige Überprüfung. Eine Parameteranpassung innerhalb eines bereits überprüften Konzepts ist Routine: Bau, Test, eine Designrunde.
  2. Prüfe die Werkzeuge und nenne, welche vorhanden sind. Führe die Prüfung aus, geh nicht davon aus:
    • node --version (≥ 20); die eigene venv der Fähigkeit unter <Schriftverzeichnis>/.venv, erstellt mit python3 -m venv .venv && .venv/bin/pip install -r requirements.txt im Fähigkeitsverzeichnis (fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2); Chrome ($CHROME oder der Standard pro Betriebssystem, den scripts/shoot.py durchsucht); die Fähigkeit Impasse (~/.claude/skills/impasse); das frontend-design-Plugin; und das stärkste Modell, das das Agent-Werkzeug bietet (in dieser Repo-Aufzeichnung „Fable“ genannt; verwende, was immer bei dir am stärksten ist).
    • Jeder Python-Befehl in dieser Fähigkeit läuft auf dem Interpreter dieser venv, und der Befehl schreibt ihn aus. Schreibe .venv/bin/python3 scripts/<tool>.py ..., niemals ein bloßes python oder python3, was auf einem Homebrew-Mac ein anderer Interpreter ohne fonttools ist. Kein Befehl darf von einer Variable oder einem Verzeichnis abhängen, die in einem früheren Bash-Aufruf gesetzt wurden: Auf den meisten Hosts merkt sich ein Aufruf nicht den letzten. „Das Fähigkeitsverzeichnis finden“ unten sagt, wie man die kurze Form in einen Befehl umwandelt, der von jedem Verzeichnis aus ausgeführt wird.
    • Führe zuerst .venv/bin/python3 scripts/check-env.py aus. Es listet die Plattform, Python ≥ 3.10, die vier Anforderungen in ihren festgelegten Versionen, Node ≥ 20, Chrome und Bash als gefunden oder fehlend auf, gibt den genauen Reparaturbefehl für jede fehlende Komponente aus und beendet sich mit 1, wenn etwas fehlt. (Bevor die venv existiert, führe das gleiche Skript mit einem beliebigen Python 3 aus: Es verwendet nur die Standardbibliothek und gibt den venv-Befehl aus.) macOS und Linux werden unterstützt; natives Windows wird nicht unterstützt (Bash-Skripte, POSIX-venv-Pfade); unter Windows führe die gesamte Fähigkeit in WSL aus.
    • Führe bash scripts/smoke.sh vor der ersten Verwendung der Fähigkeit auf einem Rechner und nach jedem Update der Fähigkeit aus, bevor du ein Projekt startest: Es baut die drei Test-Fonts, führt die Suite und die Mutationen aus, führt das FontBakery-Gate aus (übersprungen, und so angegeben, wenn FontBakery nicht installiert ist) und baut die Konzeptseiten (--full fügt die Browser-Schritte und die Umgebungsprüfung hinzu).
    • Für alles Fehlende lies references/fallbacks.md bevor du fortfährst; überspringe niemals ein Gate stillschweigend und lasse niemals den eigenen Kontext des Erbauers der Prüfende sein.
  3. Stelle die Eröffnungsfragen, in einer Nachricht, und notiere die Antworten wörtlich im Plan: das Ziel in den Worten des Operators (dieser Satz wird jedem Prüfer zitiert); welche Site und welche Seiten; die Brotschrift, neben der sie stehen muss; Markenquellen (Logo, Farben, Materialien, Geschichte); Schriftschnitte und ob eine Kursivschrift gewünscht ist; Namensvorschläge; den Besitzer und die Lizenz der Namenstabelle (kein Standard – jedes Mal fragen) und die Einbettungserlaubnis der Schrift, names.fs_type (kein Standard: 4, Vorschau & Druck, ist die übliche Einstellung für eine proprietäre Schrift und 0, installierbar, für eine offene; 2, Eingeschränkt, lässt einige Werkzeuge die Schrift ablehnen; Browser ignorieren das Feld für Webfonts); das Größenbudget; ob die Konzeptseiten als claude.ai-Artefakte veröffentlicht werden dürfen; Zustimmung, Artefakte an Impasse (einen Drittanbieter) zu senden; wer bereitstellt und wann. Entscheide, wo die Projektdateien leben werden (die Konvention ist tools/<Schrift>/ im Site-Repository), aber erstelle noch nichts: Jede Datei wird in der Phase erstellt, die ihre Eingaben hervorbringt — requirements.json in Phase 2, concepts.js in Phase 3, font.json und die Kopie von scripts/ in Phase 7, sobald der Plan von Phase 6 die Master und Achsen festgelegt hat. Während eines Projekts wird nichts in das installierte Fähigkeitsverzeichnis geschrieben: Arbeitsdateien (der Export des Plans, die Zeichensatzvorprüfung, Messungen) gehen unter tools/<Schrift>/work/ des Projekts, was die .gitignore der Site benennt.

Das Fähigkeitsverzeichnis finden

Jeder Pfad zu scripts/, references/ und templates/ in dieser Datei ist relativ zu dem Verzeichnis, das diese SKILL.md enthält, dem Fähigkeitsverzeichnis. Finde seinen absoluten Pfad einmal pro Bash-Aufruf, abhängig vom Host:

  • Claude Code: ${CLAUDE_SKILL_DIR}, das Claude Code für die laufende Fähigkeit bereitstellt. Wo es leer ist, das Installationsverzeichnis ~/.claude/skills/font-design.
  • Codex: der absolute Pfad, den Codex in seiner Liste der verfügbaren Fähigkeiten anzeigt. Verwende diesen Pfad, kein erratenes Installationsverzeichnis.
  • Jeder andere Host: der absolute Pfad des Verzeichnisses, das die geladene SKILL.md enthält. Lies ihn von dort, wo der Host die Datei geladen hat; wähle nicht zwischen Installationsverzeichnissen danach aus, welches existiert.

Jeder Befehl in dieser Datei ist in der kurzen Form geschrieben, die vom Fähigkeitsverzeichnis aus eingegeben wird, .venv/bin/python3 scripts/<tool>.py .... Um einen aus einem anderen Verzeichnis auszuführen, setze den absoluten Pfad des Fähigkeitsverzeichnisses vor sowohl .venv/bin/python3 als auch scripts/, oder beginne den Bash-Aufruf mit cd "<Fähigkeitsverzeichnis>" &&; gib die eigenen Dateien des Projekts (font.json, das Site-Stammverzeichnis) als absolute Pfade an. Eine projekteigene Kopie der Skripte, tools/<Schrift>/scripts/, wird auf die gleiche Weise ausgeführt, mit dem Interpreter der Fähigkeit: <Fähigkeitsverzeichnis>/.venv/bin/python3 tools/<Schrift>/scripts/....

2. Die neun Phasen

Jede Phase nennt ihre Referenzdatei, was sie hervorbringt und das Gate, an dem der Operator entscheidet. Übergehe kein Gate eigenständig.

Phase 1 – Prüfe zuerst die Site (references/site-audit.md)

Eine Schrift, die für Seiten gezeichnet wird, die sich bald ändern, wird für die falschen Seiten gezeichnet. Fotografiere die gebaute Site mit .venv/bin/python3 scripts/shoot.py OUT --serve <static Verzeichnis> --pages index.html <page>.html --widths 500 1280 1600 --scales 1 2. Chrome Headless layoutet bei 500 px Minimum, also fotografiere für die 360 px Ansicht scripts/narrow.html, was shoot.py unter __fd/ ausliefert und was die scrollWidth der inneren Seite gegen ihre clientWidth in einem Iframe meldet: .venv/bin/python3 scripts/shoot.py OUT --serve <static Verzeichnis> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<page>.html --query width=360. Lies die ausgegebene .dom.html: Die Seite besteht nur, wenn <html> data-fd-overflow="false" und data-fd-narrow-stage="fonts" trägt (die Messung nachdem die Webfonts geladen sind; eine "load"-Phasenmessung wurde vor ihnen durchgeführt und zählt nicht). Führe den ästhetischen Durchlauf mit dem frontend-design-Plugin durch, wenn installiert; ansonsten verwende die Kalibrierungsliste in site-audit.md. Liste die „KI-Indizien“ auf (Labels, die die Überschrift darunter wiederholen, Box-Karten, die bei Hover schweben, Regeln als Dekoration, zwei Navs oder zwei Datumsformate, wiederholter oder rätselhafter Text, Chrome lauter als Inhalt), sage für jedes, was es für die Schrift ändert, und schlage vor, welche vor dem Zeichnen der Schrift behoben werden sollen. Notiere die Prüfung mit templates/reviewer-brief-audit.md. Phase 1 prüft und schlägt vor; nichts wird behoben vor dem Gate.

Gate: Der Operator wählt aus, welche Elemente vor der Schrift behoben werden und welche warten. Dann implementiere die ausgewählten Korrekturen auf einem Branch, jede bewacht durch einen Test, der beim Scheitern beobachtet wird, und committe sie als eigenen Commit vor Phase 2 (Bract: hop-safari 2daac34, vor 90a085c der Schrift): Sie sind Site-Design-Änderungen, die der Operator an diesem Gate bewertet hat, und die Konzepte werden auf diesen Seiten bewertet. Die Schriftänderung selbst beginnt nach ihnen und bleibt uncommittet bis Phase 9; „nichts committen“ in Phase 7 bedeutet die Schriftänderung.

Phase 2 – Richtlinien von der Site (references/guidelines.md)

Finde jedes Element, das die Display-Schrift setzt, bevor du analysierst. Gib beiden Werkzeugen --family <die aktuelle Display-Familie> (mine-sizes.py <css> --family 'Bodoni Moda'; mine-charset.py --html <gebautes Seitenverzeichnis> --css <css> --family 'Bodoni Moda'): Jede Regel, deren font-family sie zuerst nennt, gibt ihre Selektoren, @media-Blöcke inbegriffen, und die Liste wird ausgegeben. Ein handgeschriebenes h1,h2,.plate-title auf der Test-Site übersah .frontis-title, .wordmark und ein 15,2 px .num, was den Boden von 44,6 auf 49,3 Einheiten verschob. Die Grenze: Ein Selektor, der die Schrift von body erbt, wird nicht gefunden (eine Site, deren Überschriften und Fließtext eine Schrift teilen), und eine Schrift, die durch die Kurzschreibweise font: oder eine benutzerdefinierte Eigenschaft gesetzt wird, wird nicht gelesen; dann nenne die Selektoren von Hand aus den Vorlagen und füge --selectors für jedes Element hinzu, das die Schriftregel übersieht. Führe .venv/bin/python3 scripts/mine-sizes.py <css> --family <aktuelle Display-Schriftfamilie> --root 100 150 für die Größen aus, denen die Schrift bei einer 16 px Basis und einer vergrößerten Basis des Lesers standhalten muss, und die Haarstrich-Untergrenze (ein CSS-Px bei der kleinsten Größe ist 1000/Größe Einheiten; ein Haarstrich sollte bei etwa 0,75 px bleiben, --floor-px), und .venv/bin/python3 scripts/mine-charset.py --html <gebautes Seitenverzeichnis> --css <css> --family <aktuelle Display-Schriftfamilie> für den Zeichensatz des Textes, den diese Selektoren in den gebauten Seiten setzen, und seine Fallstricke (geschützte Leerzeichen in Titeln, Apostrophe als ASCII ' getippt, #, +, *, akzentuierte Buchstaben und die Großbuchstaben, die eine text-transform-Regel den Browser zeichnen lässt, auf dem Selektor, auf einem Nachfahren oder auf einer Klasse innerhalb des Textes, was nur --css sehen kann). Was es nicht sieht, weshalb die Menge nicht exakt ist: Text, der in der Schrift durch einen Inline-Stil, durch Skript oder durch einen Selektor gesetzt ist, den es nicht lesen kann (references/guidelines.md Abschnitt 6 listet sie auf); nenne diese von Hand. --titles <Datei> liest einen Titel pro Zeile anstelle von gebauten Seiten, und --json auf einer der Optionen gibt die maschinenlesbare Form. Schreibe die Richtlinien: Größen, Boden, die zwei Achsen des Kontrasts mit der Brotschrift, Schriftschnitte, Großschreibung, Zeichensatz, Präzedenzfall-Lehren.

Erstelle jetzt requirements.json aus templates/requirements.example.json. Es ist die überprüfte Erwartung, gegen die die Tests die Schrift vergleichen, und sie ändert sich nur mit dem Operator (Finden F002 in docs/plan.md). Woher jedes Feld kommt, und wann:

FeldQuelleWann
required_characters, titlesmine-charset.py --json: required_characters wörtlich; die Titel aus seinem Bericht zum längsten Titel und die echten Titel der Sitejetzt
cmapder Wert der Vorlage: der Glyphensatz des Generators plus die Anführungszeichen- und Leerraumglyphen des Erbauers, was für jedes Projekt gleich ist; eine Glyphe, die in extra-glyphs.js hinzugefügt wird, wird auch hier hinzugefügtjetzt, nur bearbeitet, wenn eine Glyphe hinzugefügt wird
namesdie Eröffnungsfragen (Abschnitt 1, Punkt 3): Besitzer, Lizenz, Lieferantjetzt; wenn der Operator nicht geantwortet hat, bleibt das Feld als Platzhalter der Vorlage und Phase 7 kann nicht beginnen (font.json names wird aus denselben Antworten gefüllt)
groups.*.axes, masters, instances, avar, interpolated_checkder Plan aus Phase 6Phase 6, bevor font.json existiert
groups.*.hairline_floorsder erste export.js-Lauf von Phase 7 (minStrokeWidth pro Master, abgerundet), und jeder Master, der die kleinste Displaygröße bedient, muss bei oder über dem Ziel messen, das mine-sizes.py ausgegeben hat (1000 × 0.75 / kleinste px); ein gemessenes Minimum unter diesem Ziel ist ein Designbefund (thin verdicken, oder die kleinsten Elemente zur Brotschrift verschieben, Gate-Entscheidung 3), kein Boden, der notiert wird. Bracts 15,2 px Zahlen lasen 0,70 px gegenüber dem 0,75 Ziel und seine Aufzeichnung führt das als offenen Punkt, nicht als Bestehen. Die Zahlen der Vorlage sind die der fiktiven BeispielschriftPhase 7, der erste Export
groups.*.word_space, hand_kernsderselbe erste Export (sein Wortabstand pro Master) und die handgesetzten Paare des PlansPhase 7
size_budget_bytes, fold_units, gaspdie Eröffnungsfragen (Budget) und die Werte der Vorlagejetzt
names.fs_type, tables (code_page_range1, prep_hex, mac_names)die Eröffnungsfragen (die Einbettungserlaubnis) und die Werte der Vorlagejetzt
groups.*.vertical_metrics (ascender, descender, line_gap)die „vertical metrics written“-Selbstprüfzeile des ersten Baus, dann überprüft: Es ist der line-height: normal der Schrift, wo eine Plattform hhea oder typo liest (Win-Metriken sind nicht abgedeckt)Phase 7, der erste Bau
accepted_qa_findings ([{id, reason, codes?}]; codes begrenzt die akzeptierten Meldungscodes)der erste Lauf des FontBakery-Gates, jeder Eintrag gelesen, bevor er akzeptiert wird; [] bis dahinPhase 7

Es gibt keinen sizes-Schlüssel: Die Größen leben in den Richtlinien und in font.json review.sizes.

Gate: Richtlinien geschrieben und gezeigt, und drei Entscheidungen explizit erfragt, eine Frage jeweils, und in den Richtlinien und requirements.json notiert, bevor ein Konzept gezeichnet wird:

  1. **Jedes Zeichen, das der Generator...

Verwandte Skills