CommunityImagemgithub.com

font-design

Projete, construa e entregue uma fonte de exibição personalizada como uma fonte variável auto-hospedada para a web — um desenho paramétrico criado para a marca, selecionado através de três rodadas de páginas de conceito.

O que é font-design?

Este skill capacita um agente de IA a projetar e construir uma fonte de exibição personalizada e exclusiva para um site, desde a auditoria inicial até a entrega final como uma fonte variável auto-hospedada. Ele é acionado sempre que o operador deseja criar uma fonte sob medida para a marca, em vez de escolher uma já existente em catálogos como Google Fonts. O skill segue um processo rigoroso de nove fases, com portões de revisão em cada etapa, garantindo que a fonte seja desenhada com base no design do site, nas necessidades de conteúdo e nas preferências do operador. Ele suporta plataformas como Claude Code e Codex, e utiliza ferramentas como Node.js, Python (com fonttools), Chrome e scripts de verificação de ambiente para garantir a qualidade e a consistência do resultado final.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. Antes de começar
  2. As nove fases (cada uma com seu portão)
  3. Trabalhando com pouca supervisão
  4. Bloqueadores de publicação
  5. O que as ferramentas são e o que cada uma prova
  6. Índice de referência

1. Antes de começar

  1. 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.
  2. 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 com python3 -m venv .venv && .venv/bin/pip install -r requirements.txt no diretório do skill (fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2); Chrome ($CHROME ou o padrão por SO que scripts/shoot.py procura); o skill Impasse (~/.claude/skills/impasse); o plugin frontend-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 um python ou python3 simples, 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.py primeiro. 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.sh antes 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 (--full adiciona as etapas do navegador e a verificação de ambiente).
    • Para qualquer item ausente, leia references/fallbacks.md antes de continuar; nunca pule um portão silenciosamente, e nunca deixe o próprio contexto do construtor ser o revisor.
  3. 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.json na fase 2, concepts.js na fase 3, font.json e a cópia de scripts/ 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 para tools/<fonte>/work/ do projeto, que o .gitignore do 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.md que 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:

CampoFonteQuando
required_characters, titlesmine-charset.py --json: required_characters textualmente; os títulos do seu relatório de título mais longo e dos títulos reais do siteagora
cmapo 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émagora, editado apenas quando um glifo é adicionado
namesas perguntas iniciais (seção 1, item 3): proprietário, licença, fornecedoragora; 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_checko plano da fase 6fase 6, antes de font.json existir
groups.*.hairline_floorsa 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 Exemplofase 7, a primeira exportação
groups.*.word_space, hand_kernsa mesma primeira exportação (seu espaço entre palavras por mestre) e os pares manuais do planofase 7
size_budget_bytes, fold_units, gaspas perguntas iniciais (orçamento) e os valores do modeloagora
names.fs_type, tables (code_page_range1, prep_hex, mac_names)as perguntas iniciais (a permissão de incorporação) e os valores do modeloagora
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ãofase 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:

  1. Cada caractere que o gerador

... [truncado para tradução]

Habilidades Relacionadas