Que fait font-design ?
Version 0.2.0 — la source unique de vérité est le fichier VERSION à la racine du dépôt ; cette ligne, le frontmatter et le badge README sont vérifiés par tests/test_versions_and_skill.py. Indiquez ce numéro de version lorsque vous commencez, pour que l'opérateur sache quelle copie répond.
Ce skill crée une police de caractères de la même manière que Bract (hopsafari.com, 2026-11-15) a été créée : les neuf phases ci-dessous, exécutées une fois en intégralité. Le générateur et de nombreuses règles proviennent d'une police antérieure, Driftwood (movingavg.com, 2026-11-14), qui a été construite avant que le processus ne soit formalisé, par un pipeline d'union statique en cinq fichiers CFF ; ses leçons et les trois bogues découverts plus tard ont façonné le skill, mais elle n'est pas passée par ces phases. Les deux sont des créations de John Knox (NOTICE.md). La forme du travail est : auditer le site, dériver des directives, choisir un design à travers trois séries de pages de concept, planifier la construction et faire réviser le plan de manière indépendante, construire avec des auto-vérifications, réviser la police construite sur des pages réelles jusqu'à ce qu'une série ne trouve rien, faire réviser le changement final de manière indépendante, livrer. Le skill fonctionne avec peu de supervision entre les portes et s'arrête à chaque porte.
Table des matières
- Avant de commencer
- Les neuf phases (chacune avec sa porte)
- Travailler avec peu de supervision
- Bloqueurs de publication
- Ce que sont les outils et ce que chacun prouve
- Index de référence
1. Avant de commencer
- Indiquez la version (ci-dessus) et classez le changement. Une police d'affichage à l'échelle du site est un changement significatif : elle touche les pages publiques et est difficile à annuler une fois liée et mise en cache. Suivez l'ordre complet : planification → révision indépendante → construction → révision indépendante. Une modification de paramètre à l'intérieur d'un concept déjà révisé est routinière : construire, tester, une série de design.
- Vérifiez les outils et indiquez lesquels sont présents. Exécutez la vérification, ne supposez pas :
node --version(≥ 20) ; le venv propre du skill dans<dossier du skill>/.venv, créé avecpython3 -m venv .venv && .venv/bin/pip install -r requirements.txtdans le répertoire du skill (fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2) ; Chrome ($CHROMEou le chemin par défaut par OS quescripts/shoot.pyrecherche) ; le skill Impasse (~/.claude/skills/impasse) ; le pluginfrontend-design; et le modèle le plus puissant offert par l'outil Agent (nommé "Fable" dans les enregistrements de ce dépôt ; utilisez le plus puissant là où vous êtes).- Chaque commande Python dans ce skill utilise l'interpréteur de ce venv, et la commande l'écrit explicitement. Écrivez
.venv/bin/python3 scripts/<outil>.py ..., jamais unpythonoupython3nu, qui sur un Mac Homebrew est un interpréteur différent sans fonttools. Aucune commande ne peut dépendre d'une variable ou d'un répertoire défini dans un appel Bash antérieur : sur la plupart des hôtes, un appel ne se souvient pas du précédent. "Trouver le dossier du skill" ci-dessous explique comment transformer la forme courte en une commande qui s'exécute depuis n'importe quel répertoire. - Exécutez
.venv/bin/python3 scripts/check-env.pyen premier. Il liste la plateforme, Python ≥ 3.10, les quatre dépendances à leurs versions épinglées, Node ≥ 20, Chrome et bash comme trouvés ou manquants, imprime la commande de correction exacte pour chaque élément manquant et se termine par 1 si quelque chose manque. (Avant que le venv n'existe, exécutez le même script avec n'importe quel Python 3 : il n'utilise que la bibliothèque standard et imprime la commande venv.) macOS et Linux sont pris en charge ; Windows natif ne l'est pas (scripts bash, chemins POSIX du venv) ; sur Windows, exécutez l'intégralité du skill dans WSL. - Exécutez
bash scripts/smoke.shavant la première utilisation du skill sur une machine et après chaque mise à jour du skill, avant de commencer un projet : il construit les trois fixtures, exécute la suite et les mutations, exécute la porte FontBakery (ignorée, et dit qu'elle l'est, lorsque FontBakery n'est pas installé) et construit les pages de concept (--fullajoute les étapes du navigateur et la vérification de l'environnement). - Pour tout élément manquant, lisez
references/fallbacks.mdavant de continuer ; ne sautez jamais une porte en silence, et ne laissez jamais le contexte du constructeur être le réviseur.
- Posez les questions d'ouverture, en un seul message, et enregistrez les réponses textuellement dans le plan :
l'objectif dans les mots de l'opérateur (cette phrase est citée à chaque réviseur) ; quel site et
quelles pages ; la police de corps à côté de laquelle elle doit se trouver ; les sources de la marque (marque, couleurs, matériaux, histoire) ;
les graisses et si une italique est souhaitée ; les suggestions de nom ; le propriétaire de la table des noms et la licence (pas de valeur par défaut — demandez à chaque fois) et la permission d'incorporation de la police,
names.fs_type(pas de valeur par défaut : 4, Aperçu et impression, est le réglage habituel pour une police propriétaire et 0, installable, pour une police ouverte ; 2, Restreint, fait refuser la police par certains outils ; les navigateurs ignorent ce champ pour les polices web) ; le budget de taille ; si les pages de concept peuvent être publiées en tant qu'artefacts claude.ai ; le consentement à envoyer des artefacts à Impasse (un fournisseur tiers) ; qui déploie et quand. Décidez où les fichiers du projet seront placés (la convention esttools/<police>/dans le dépôt du site), mais ne créez rien encore : chaque fichier est créé dans la phase qui produit ses entrées —requirements.jsondans la phase 2,concepts.jsdans la phase 3,font.jsonet la copie descripts/dans la phase 7, une fois que le plan de la phase 6 a fixé les maîtres et les axes. Pendant un projet, rien n'est écrit dans le dossier d'installation du skill : les fichiers temporaires (l'export du plan, la pré-vérification du jeu de caractères, les mesures) vont danstools/<police>/work/du projet, que le.gitignoredu site nomme.
Trouver le dossier du skill
Chaque chemin scripts/, references/ et templates/ dans ce fichier est relatif au dossier qui
contient ce SKILL.md, le dossier du skill. Trouvez son chemin absolu à chaque appel Bash, par hôte :
- Claude Code :
${CLAUDE_SKILL_DIR}, que Claude Code fournit pour le skill en cours d'exécution. Là où il est vide, le dossier d'installation~/.claude/skills/font-design. - Codex : le chemin absolu que Codex affiche dans sa liste des skills disponibles. Utilisez ce chemin, pas un dossier d'installation supposé.
- Tout autre hôte : le chemin absolu du répertoire contenant le
SKILL.mdqui a été chargé. Lisez-le à partir de l'endroit où l'hôte a chargé le fichier ; ne choisissez pas parmi les dossiers d'installation selon ceux qui existent.
Chaque commande dans ce fichier est écrite dans la forme courte tapée depuis le dossier du skill,
.venv/bin/python3 scripts/<outil>.py .... Pour en exécuter une depuis un autre répertoire, mettez le chemin absolu du dossier du skill devant à la fois .venv/bin/python3 et scripts/, ou commencez l'appel Bash par cd "<dossier du skill>" && ; donnez les fichiers propres du projet (font.json, la racine du site) en tant que chemins absolus. La copie des scripts d'un projet, tools/<police>/scripts/, s'exécute de la même manière, avec l'interpréteur du skill : <dossier du skill>/.venv/bin/python3 tools/<police>/scripts/....
2. Les neuf phases
Chaque phase nomme son fichier de référence, ce qu'elle produit et la porte à laquelle l'opérateur décide. Ne passez pas une porte par vous-même.
Phase 1 — Auditer d'abord le site (references/site-audit.md)
Une police dessinée pour des pages sur le point de changer est dessinée pour les mauvaises pages. Prenez des captures du site construit avec .venv/bin/python3 scripts/shoot.py OUT --serve <répertoire statique> --pages index.html <page>.html --widths 500 1280 1600 --scales 1 2. Chrome headless compose à 500 px minimum, donc pour la lecture à 360 px, utilisez scripts/narrow.html, que shoot.py sert à __fd/ et qui rapporte le scrollWidth de la page intérieure par rapport à son clientWidth dans une iframe :
.venv/bin/python3 scripts/shoot.py OUT --serve <répertoire statique> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<page>.html --query width=360. Lisez le .dom.html extrait : la page passe seulement lorsque <html> porte data-fd-overflow="false" et data-fd-narrow-stage="fonts" (la lecture prise après le chargement des polices web ; une lecture de stade "load" a été prise avant elles et ne compte pas). Exécutez le passage esthétique avec le plugin frontend-design lorsqu'il est installé ; sinon, utilisez la liste d'étalonnage dans site-audit.md. Listez les "signes IA" (étiquettes qui répètent le titre en dessous, cartes encadrées qui se soulèvent au survol, règles décoratives, deux navigations ou deux formats de date, copie répétée ou énigmatique, chrome plus fort que le contenu), dites pour chacun ce qu'il change pour la police, et proposez lesquels corriger avant que la police ne soit dessinée. Enregistrez l'audit avec templates/reviewer-brief-audit.md. La phase 1 audite et propose ; rien n'est corrigé avant la porte.
Porte : l'opérateur sélectionne quels éléments sont corrigés avant la police et lesquels attendent. Ensuite, implémentez les correctifs sélectionnés sur une branche, chacun protégé par un test surveillé pour échouer, et validez-les comme leur propre commit avant la phase 2 (Bract : hop-safari 2daac34, avant le 90a085c de la police) : ce sont des modifications de conception du site que l'opérateur a jugées à cette porte, et les concepts sont jugés sur ces pages. Le changement de police lui-même commence après elles et reste non validé jusqu'à la phase 9 ; "ne rien valider" dans la phase 7 signifie le changement de police.
Phase 2 — Directives à partir du site (references/guidelines.md)
Trouvez chaque élément que la police d'affichage définit avant de l'exploiter. Donnez aux deux outils --family <la police d'affichage utilisée aujourd'hui> (mine-sizes.py <css> --family 'Bodoni Moda' ; mine-charset.py --html <répertoire des pages construites> --css <css> --family 'Bodoni Moda') : chaque règle dont le font-family la nomme en premier donne ses sélecteurs, blocs @media inclus, et la liste est imprimée. Un h1,h2,.plate-title tapé à la main sur le site de fixture a raté .frontis-title, .wordmark et un .num de 15,2 px, ce qui a déplacé le plancher de 44,6 à 49,3 unités. La limite : un sélecteur qui hérite de la police de body n'est pas trouvé (un site dont les titres et le corps partagent une seule famille), et une famille définie via la propriété raccourcie font: ou une propriété personnalisée n'est pas lue ; alors nommez les sélecteurs à la main à partir des modèles, et ajoutez --selectors pour tout élément que la règle de famille manque. Exécutez
.venv/bin/python3 scripts/mine-sizes.py <css> --family <police d'affichage actuelle> --root 100 150 pour les tailles auxquelles la police doit survivre à une racine de 16 px et à une racine agrandie par le lecteur, et le plancher de filet (un px CSS à la plus petite taille est 1000/taille en unités ; un filet doit rester à environ 0,75 px, --floor-px), et .venv/bin/python3 scripts/mine-charset.py --html <répertoire des pages construites> --css <css> --family <police d'affichage actuelle> pour le jeu de caractères du texte que ces sélecteurs définissent dans les pages construites et ses pièges (espaces insécables dans les titres, apostrophes tapées comme ASCII ', #, +, *, lettres accentuées, et les capitales qu'une règle text-transform fait dessiner par le navigateur, sur le sélecteur, sur un descendant ou sur une classe à l'intérieur du texte, que seul --css peut voir). Ce qu'il ne voit pas, donc l'ensemble n'est pas exact : le texte défini dans la police par un style en ligne, par un script, ou par un sélecteur qu'il ne peut pas lire (references/guidelines.md section 6 les liste) ; nommez-les à la main. --titles <fichier> lit un titre par ligne au lieu des pages construites, et --json sur l'un ou l'autre donne la forme lisible par machine. Écrivez les directives : tailles, plancher, les deux axes de contraste avec la police de corps, graisses, casse, jeu de caractères, leçons des précédents.
Créez requirements.json maintenant à partir de templates/requirements.example.json. C'est l'attente révisée que les tests comparent à la police, et elle ne change qu'avec l'opérateur (trouver F002 dans docs/plan.md). D'où vient chaque champ, et quand :
| Champ | Source | Quand |
|---|---|---|
required_characters, titles | mine-charset.py --json : required_characters textuellement ; les titres de son rapport de titre le plus long et les vrais titres du site | maintenant |
cmap | la valeur du modèle : l'ensemble de glyphes du générateur plus les glyphes de guillemet et d'espace du constructeur, qui est le même pour chaque projet ; un glyphe ajouté dans extra-glyphs.js est ajouté ici aussi | maintenant, édité seulement lorsqu'un glyphe est ajouté |
names | les questions d'ouverture (section 1, point 3) : propriétaire, licence, vendeur | maintenant ; si l'opérateur n'a pas répondu, le champ reste comme l'espace réservé du modèle et la phase 7 ne peut pas commencer (font.json names est rempli à partir des mêmes réponses) |
groups.*.axes, masters, instances, avar, interpolated_check | le plan de la phase 6 | phase 6, avant que font.json n'existe |
groups.*.hairline_floors | la première exécution de export.js de la phase 7 (minStrokeWidth par maître, arrondi à l'inférieur), et chaque maître qui sert la plus petite taille d'affichage doit mesurer au-dessus ou à la cible que mine-sizes.py a imprimée (1000 × 0.75 / plus petit px) ; une mesure minimale en dessous de cette cible est une constatation de conception (épaissir thin, ou déplacer les plus petits éléments vers la police de corps, décision de porte 3), pas un plancher à enregistrer. Les 15,2 px de chiffres de Bract lisaient 0,70 px contre la cible de 0,75 et son enregistrement porte cela comme un élément ouvert, pas une réussite. Les nombres dans le modèle sont ceux de la police fictive Example | phase 7, la première exportation |
groups.*.word_space, hand_kerns | la même première exportation (son espace de mot par maître) et les paires manuelles du plan | phase 7 |
size_budget_bytes, fold_units, gasp | les questions d'ouverture (budget) et les valeurs du modèle | maintenant |
names.fs_type, tables (code_page_range1, prep_hex, mac_names) | les questions d'ouverture (la permission d'incorporation) et les valeurs du modèle | maintenant |
groups.*.vertical_metrics (ascender, descender, line_gap) | la ligne d'auto-vérification vertical metrics written de la première construction, puis révisée : c'est le line-height: normal de la police là où une plateforme lit hhea ou typo (les mesures win ne sont pas couvertes) | phase 7, la première construction |
accepted_qa_findings ([{id, reason, codes?}] ; codes limite les codes de message acceptés) | la première exécution de la porte FontBakery, chaque entrée lue avant d'être acceptée ; [] jusqu'alors | phase 7 |
Il n'y a pas de clé sizes : les tailles vivent dans les directives et dans font.json review.sizes.
Porte : directives écrites et montrées, et trois décisions demandées explicitement, une question chacune, et enregistrées dans les directives et requirements.json avant qu'un concept ne soit dessiné :
- **Chaque caractère que le générateur
… [tronqué pour la traduction]