O que font-design faz?
Versão 0.2.0 — a fonte única da verdade é o arquivo VERSION na raiz do repositório; esta linha, o
frontmatter e o badge do README são verificados contra ele por tests/test_versions_and_skill.py. Diga
este número de versão quando começar, para que o operador saiba qual cópia respondeu.
Este skill cria uma fonte da mesma forma que Bract (hopsafari.com, 2026-11-15) foi criada: as nove fases
abaixo, executadas uma vez por completo. O gerador e muitas das regras vêm de uma fonte anterior, Driftwood
(movingavg.com, 2026-11-14), que foi construída antes do processo ser documentado, por um pipeline de união estática
em cinco arquivos CFF; suas lições e os três bugs encontrados posteriormente moldaram o skill, mas
ela não passou por essas fases. Ambas são designs de John Knox (NOTICE.md). A forma do
trabalho é: auditar o site,
derivar diretrizes, escolher um design em três rodadas de páginas de conceito, planejar a construção e ter o
plano revisado de forma independente, construir com auto-verificações, revisar a fonte construída em páginas reais até que uma rodada
não encontre nada, ter a alteração finalizada revisada de forma independente, enviar. O skill é executado com pouca
supervisão entre os portões e para em cada portão.
Conteúdo
- Antes de começar
- As nove fases (cada uma com seu portão)
- Trabalhando com pouca supervisão
- Bloqueadores de publicação
- O que as ferramentas são e o que cada uma prova
- Índice de referência
1. Antes de começar
- Informe a versão (acima) e classifique a mudança. Uma fonte de exibição em todo o site é uma mudança significativa: ela afeta páginas públicas e é difícil de reverter depois de vinculada e armazenada em cache. Siga a ordem completa: planejar → revisão independente → construir → revisão independente. Um ajuste de parâmetro dentro de um conceito já revisado é rotineiro: construir, testar, uma rodada de design.
- Verifique as ferramentas e informe quais estão presentes. Execute a verificação, não presuma:
node --version(≥ 20); o venv próprio do skill em<diretório do skill>/.venv, criado compython3 -m venv .venv && .venv/bin/pip install -r requirements.txtno diretório do skill (fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2); Chrome ($CHROMEou o padrão por SO quescripts/shoot.pyprocura); o skill Impasse (~/.claude/skills/impasse); o pluginfrontend-design; e o modelo mais forte que a ferramenta Agente oferece (chamado "Fable" neste repositório; use o que for mais forte onde você estiver).- Todo comando Python neste skill usa o interpretador desse venv, e o comando o escreve por extenso.
Escreva
.venv/bin/python3 scripts/<ferramenta>.py ..., nunca umpythonoupython3simples, que em um Mac com Homebrew é um interpretador diferente sem fonttools. Nenhum comando pode depender de uma variável ou de um diretório definido em uma chamada Bash anterior: na maioria dos hosts, uma chamada não se lembra da anterior. "Encontrando a pasta do skill" abaixo explica como transformar a forma abreviada em um comando que é executado de qualquer diretório. - Execute
.venv/bin/python3 scripts/check-env.pyprimeiro. Ele lista a plataforma, Python ≥ 3.10, os quatro requisitos com suas versões fixadas, Node ≥ 20, Chrome e bash como encontrados ou ausentes, imprime o comando de correção exato para cada um ausente e sai com código 1 se algum estiver faltando. (Antes do venv existir, execute o mesmo script com qualquer Python 3: ele usa apenas a biblioteca padrão e imprime o comando do venv.) macOS e Linux são suportados; Windows nativo não é (scripts bash, caminhos de venv POSIX); no Windows execute todo o skill dentro do WSL. - Execute
bash scripts/smoke.shantes do primeiro uso do skill em uma máquina e após cada atualização do skill, antes de iniciar um projeto: ele constrói as três fixtures, executa a suíte e as mutações, executa o portão do FontBakery (ignorado, e assim informado, quando o FontBakery não está instalado) e constrói as páginas de conceito (--fulladiciona as etapas do navegador e a verificação de ambiente). - Para qualquer item ausente, leia
references/fallbacks.mdantes de continuar; nunca pule um portão silenciosamente, e nunca deixe o próprio contexto do construtor ser o revisor.
- Faça as perguntas iniciais, em uma única mensagem, e registre as respostas textualmente no plano:
o objetivo nas palavras do operador (esta frase é citada para todo revisor); qual site e
quais páginas; a fonte de texto que deve acompanhar; fontes da marca (marca, cores, materiais, histórico);
pesos e se uma itálica é desejada; candidatos a nome; o proprietário e a licença na tabela de nomes (sem valor
padrão — pergunte sempre) e a permissão de incorporação da fonte,
names.fs_type(sem padrão: 4, Visualização e Impressão, é a configuração usual para uma fonte proprietária e 0, instalável, para uma aberta; 2, Restrita, faz algumas ferramentas recusarem a fonte; os navegadores ignoram o campo para fontes web); o orçamento de tamanho; se as páginas de conceito podem ser publicadas como artefatos do claude.ai; consentimento para enviar artefatos para Impasse (um provedor terceiro); quem implanta e quando. Decida onde os arquivos do projeto vão ficar (a convenção étools/<fonte>/no repositório do site), mas não crie nada ainda: cada arquivo é criado na fase que produz suas entradas —requirements.jsonna fase 2,concepts.jsna fase 3,font.jsone a cópia descripts/na fase 7, uma vez que o plano da fase 6 tenha definido os mestres e eixos. Durante um projeto, nada é escrito na pasta do skill instalada: arquivos temporários (a exportação do plano, a pré-verificação do conjunto de caracteres, medições) vão paratools/<fonte>/work/do projeto, que o.gitignoredo site nomeia.
Encontrando a pasta do skill
Todo caminho scripts/, references/ e templates/ neste arquivo é relativo à pasta que
contém este SKILL.md, a pasta do skill. Encontre seu caminho absoluto uma vez por chamada Bash, de acordo com o
host:
- Claude Code:
${CLAUDE_SKILL_DIR}, que o Claude Code fornece para o skill que está sendo executado. Onde estiver vazio, a pasta de instalação~/.claude/skills/font-design. - Codex: o caminho absoluto que o Codex mostra em sua lista de skills disponíveis. Use esse caminho, não uma pasta de instalação adivinhada.
- Qualquer outro host: o caminho absoluto do diretório que contém o
SKILL.mdque foi carregado. Leia-o de onde o host carregou o arquivo; não escolha entre pastas de instalação por qual existe.
Todo comando neste arquivo é escrito na forma abreviada digitada a partir da pasta do skill,
.venv/bin/python3 scripts/<ferramenta>.py .... Para executar um a partir de outro diretório, coloque o caminho absoluto
da pasta do skill na frente de .venv/bin/python3 e scripts/, ou comece a chamada Bash com
cd "<pasta do skill>" &&; forneça os arquivos próprios do projeto (font.json, a raiz do site) como caminhos
absolutos. Uma cópia dos scripts do projeto, tools/<fonte>/scripts/, é executada da mesma forma, com o interpretador
do skill: <pasta do skill>/.venv/bin/python3 tools/<fonte>/scripts/....
2. As nove fases
Cada fase nomeia seu arquivo de referência, o que produz e o portão no qual o operador decide. Não passe por um portão por conta própria.
Fase 1 — Audite o site primeiro (references/site-audit.md)
Uma fonte desenhada para páginas que estão prestes a mudar é desenhada para as páginas erradas. Capture o site
construído com .venv/bin/python3 scripts/shoot.py SAIDA --serve <diretório estático> --pages index.html <pagina>.html --widths 500 1280 1600 --scales 1 2.
Chrome headless faz o layout com largura mínima de 500 px, então para a leitura de 360 px, capture scripts/narrow.html,
que shoot.py serve em __fd/ e que relata o scrollWidth da página interna contra seu
clientWidth dentro de um iframe:
.venv/bin/python3 scripts/shoot.py SAIDA --serve <diretório estático> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<pagina>.html --query width=360.
Leia o .dom.html descartado: a página passa apenas quando <html> carrega data-fd-overflow="false"
e data-fd-narrow-stage="fonts" (a leitura obtida após as fontes web se estabelecerem; uma leitura de estágio "load"
foi obtida antes delas e não conta). Execute a passagem estética com o
plugin frontend-design quando instalado; caso contrário, use a lista de calibração em site-audit.md. Liste
os "indícios de IA" (rótulos que repetem o título abaixo deles, cartões em caixa que levantam ao passar o mouse, regras como
decoração, dois menus de navegação ou dois formatos de data, texto repetido ou enigmático, chrome mais alto que o conteúdo),
diga para cada um o que muda para a fonte e proponha quais corrigir antes da fonte ser desenhada. Registre a auditoria
com templates/reviewer-brief-audit.md. A Fase 1 audita e propõe; nada é corrigido antes do
portão.
Portão: o operador seleciona quais itens são corrigidos antes da fonte e quais esperam. Em seguida, implemente
as correções selecionadas em um branch, cada uma guardada por um teste observado para falhar, e faça commit delas como seu próprio
commit antes da fase 2 (Bract: hop-safari 2daac34, antes do commit da fonte 90a085c): são mudanças de design do site
que o operador julgou neste portão, e os conceitos são julgados nessas páginas. A mudança
na fonte em si começa depois delas e permanece sem commit até a fase 9; "não commitar nada" na fase
7 significa a mudança na fonte.
Fase 2 — Diretrizes a partir do site (references/guidelines.md)
Encontre cada elemento que a fonte de exibição define antes de minerar. Forneça a ambas as ferramentas --family <a fonte de exibição em uso hoje> (mine-sizes.py <css> --family 'Bodoni Moda'; mine-charset.py --html <diretório de páginas construídas> --css <css> --family 'Bodoni Moda'): cada regra cujo font-family a nomeia primeiro fornece seus seletores,
blocos @media incluídos, e a lista é impressa. Um h1,h2,.plate-title digitado manualmente no
site de fixture perdeu .frontis-title, .wordmark e um .num de 15.2 px, que moveu o piso de 44,6
para 49,3 unidades. O limite: um seletor que herda a fonte de body não é encontrado (um site
cujos títulos e corpo compartilham uma família), e uma família definida através da abreviação font: ou de uma propriedade
personalizada não é lida; então, nomeie os seletores manualmente a partir dos modelos e adicione --selectors para
qualquer elemento que a regra da família perca. Execute
.venv/bin/python3 scripts/mine-sizes.py <css> --family <a fonte de exibição de hoje> --root 100 150 para os tamanhos
que a fonte deve suportar com uma raiz de 16 px e uma raiz ampliada pelo leitor, e o piso de traço fino (um
px de CSS no menor tamanho é 1000/unidades de tamanho; um traço fino deve ficar em cerca de 0,75 px, --floor-px),
e .venv/bin/python3 scripts/mine-charset.py --html <diretório de páginas construídas> --css <css> --family <a fonte de exibição de hoje>
para o conjunto de caracteres do texto que esses seletores definem nas páginas construídas e suas armadilhas (espaços
inquebráveis em títulos, apóstrofos digitados como ASCII ', #, +, *, letras acentuadas e as maiúsculas que uma
regra text-transform faz o navegador desenhar, no seletor, em um descendente ou em uma classe dentro do
texto, o que apenas --css pode ver). O que ela não vê, portanto o conjunto não é exato: texto definido na
fonte por um estilo inline, por script ou por um seletor que ela não pode ler (references/guidelines.md
seção 6 os lista); nomeie esses manualmente. --titles <arquivo> lê um título por linha em vez de
páginas construídas, e --json em qualquer um fornece a forma legível por máquina. Escreva as diretrizes:
tamanhos, piso, os dois eixos de contraste com a fonte de texto, pesos, caixa alta/baixa, conjunto de caracteres, lições de precedentes.
Crie requirements.json agora a partir de templates/requirements.example.json. É a expectativa
revisada contra a qual os testes comparam a fonte, e só muda com o operador (encontrando F002 em
docs/plan.md). De onde vem cada campo e quando:
| Campo | Fonte | Quando |
|---|---|---|
required_characters, titles | mine-charset.py --json: required_characters textualmente; os títulos do seu relatório de título mais longo e dos títulos reais do site | agora |
cmap | o valor do modelo: o conjunto de glifos do gerador mais os glifos de aspas e espaço do construtor, que é o mesmo para todos os projetos; um glifo adicionado em extra-glyphs.js é adicionado aqui também | agora, editado apenas quando um glifo é adicionado |
names | as perguntas iniciais (seção 1, item 3): proprietário, licença, fornecedor | agora; se o operador não respondeu, o campo permanece como o placeholder do modelo e a fase 7 não pode começar (font.json names é preenchido a partir das mesmas respostas) |
groups.*.axes, masters, instances, avar, interpolated_check | o plano da fase 6 | fase 6, antes de font.json existir |
groups.*.hairline_floors | a primeira execução de export.js da fase 7 (minStrokeWidth por mestre, arredondado para baixo), e cada mestre que serve o menor tamanho de exibição deve medir igual ou acima do alvo que mine-sizes.py imprimiu (1000 × 0.75 / menor px); uma medição mínima abaixo desse alvo é uma constatação de design (engrossar thin, ou mover os menores elementos para a fonte de texto, decisão do portão 3), não um piso a registrar. Os números de 15.2 px do Bract mediram 0,70 px contra o alvo de 0,75 e seu registro carrega isso como um item em aberto, não uma aprovação. Os números do modelo são os da fonte fictícia Exemplo | fase 7, a primeira exportação |
groups.*.word_space, hand_kerns | a mesma primeira exportação (seu espaço entre palavras por mestre) e os pares manuais do plano | fase 7 |
size_budget_bytes, fold_units, gasp | as perguntas iniciais (orçamento) e os valores do modelo | agora |
names.fs_type, tables (code_page_range1, prep_hex, mac_names) | as perguntas iniciais (a permissão de incorporação) e os valores do modelo | agora |
groups.*.vertical_metrics (ascender, descender, line_gap) | a linha de auto-verificação vertical metrics written da primeira construção, depois revisada: é o line-height: normal da fonte onde uma plataforma lê hhea ou typo (as métricas do Windows não são cobertas) | fase 7, a primeira construção |
accepted_qa_findings ([{id, reason, codes?}]; codes limita os códigos de mensagem aceitos) | a primeira execução do portão do FontBakery, cada entrada lida antes de ser aceita; [] até então | fase 7 |
Não há chave sizes: os tamanhos vivem nas diretrizes e em font.json review.sizes.
Portão: diretrizes escritas e mostradas, e três decisões perguntadas explicitamente, uma pergunta cada,
e registradas nas diretrizes e em requirements.json antes de qualquer conceito ser desenhado:
- Cada caractere que o gerador
... [truncado para tradução]