Communitygithub.com

craft

Use quando for solicitado a projetar, criar, simular ou redesenhar uma ou mais páginas, telas, fluxos ou elementos de UI, ou quando o usuário executa /craft (/craft:craft no plugin do Claude Code).

O que é craft?

O skill 'craft' é a porta de entrada para a criação visual no Claude Code, transformando solicitações como 'projete a página de preços' em um design completo e revisado. Ele opera a partir do brief do projeto, cobre todos os estados da interface, oferece opções apenas quando a direção do design está em aberto e utiliza exclusivamente as peças do sistema de design existente. O skill executa uma verificação automática (self-check) antes de exibir o resultado e orquestra habilidades auxiliares em pontos fixos, como 'craft-states' para listar estados, 'craft-explore' para explorar opções e 'craft-critique' para revisão. Suporta ferramentas de design via adaptadores (referenciados em `references/adapters/`), e quando não há ferramenta disponível, constrói em HTML. É essencial para manter a consistência do design, evitar decisões arbitrárias e garantir que todas as alterações sejam registradas no arquivo `DESIGN.md` para rastreabilidade futura.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft

Perguntar na sua IA favorita

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

Documentação

O que craft faz?

Visão Geral

A porta de entrada para criar qualquer coisa visual. Ele transforma "projete a página de preços" em um design finalizado e revisado. Funciona a partir do brief do projeto, cobre todos os estados, oferece opções apenas quando a direção está em aberto, usa apenas as peças do sistema de design e verifica seu próprio trabalho antes de exibi-lo. Ele chama as outras habilidades de design em pontos fixos; não as substitui.

Quando usar

  • "Projetar / criar / simular / redesenhar a <página, tela, fluxo, elemento>", /craft (/craft:craft no plugin do Claude Code).
  • Várias páginas de uma vez ("projete a integração: boas-vindas, cadastro, verificação").

Quando NÃO usar

  • Uma pequena alteração que a pessoa descreveu exatamente (um valor, um rótulo, um tamanho): faça diretamente.
  • Apenas uma revisão ("o que há de errado nisso?"): craft-critique. Apenas opções: craft-explore.

Antes de começar

  • Se nenhum adaptador em references/adapters/ corresponder à sua ferramenta, faça os mesmos verbos em sua ferramenta e diga quais você mapeou manualmente. Sem nenhuma ferramenta de design, construa em HTML (html.md). Se tudo o que você tem é uma imagem, diga que os valores lidos dela são estimativas.

Paradas são reais

Uma parada significa: termine sua vez com a pergunta e aguarde. Você sempre pode fazer isso, mesmo em uma sessão one-shot ou headless, onde sua mensagem final é a pergunta. Nunca decida uma parada pela pessoa porque a sessão "não pode esperar" ou "para economizar uma viagem de ida e volta". Decidir por conta própria transforma uma resposta de cinco segundos em horas de retrabalho.

Etapas

  1. Contexto.
    • Leia DESIGN.md na raiz do projeto. Se estiver faltando, ou não tiver seção de Produto (um registro apenas de sincronização) → SUB-HABILIDADE OBRIGATÓRIA: craft-setup, depois retorne aqui.
    • Leia o sistema de design (tokens, componentes, guia) e as telas relacionadas a esta.
    • Quando o brief e o código discordarem (o brief diz teal, os tokens dizem azul): siga o código, mencione em uma linha, adicione o conflito em DESIGN.md › Perguntas em aberto e ofereça-se para atualizar o que estiver errado. Nunca substitua tokens dentro do CSS de uma página.
    • Quando a guia da ferramenta de design e o código diferirem e existir um design-sync.json, não considere a guia desatualizada. Classifique com ela: código alterado → ofereça-se para atualizar a guia antes de desenhar; guia alterada → é a alteração da pessoa aguardando exportação, então desenhe com ela e mencione a exportação pendente.
  2. Escopo em palavras. Liste cada página ou elemento a ser criado, cada um com sua função e sua próxima ação única.
    • Palavras ambíguas recebem uma interpretação declarada claramente ("página de preços = a lista de preços da padaria, não planos de assinatura").
    • Pare e confirme a lista quando houver mais de um item ou a solicitação for vaga. Um item claro: prossiga.
  3. Para cada item, em ordem:
    1. SUB-HABILIDADE OBRIGATÓRIA: craft-states. Sua lista de estados escrita e sua parada vêm primeiro.
    2. Direção em aberto? Apenas quando a pessoa pediu ideias, ou quando dois layouts estruturalmente diferentes são plausíveis e nem o brief nem o sistema escolhem entre eles → SUB-HABILIDADE OBRIGATÓRIA: craft-explore antes de desenhar os estados. Para várias páginas, pergunte na parada de escopo qual página (se houver) receberá opções; nunca execute uma rodada de opções por página por padrão. Os estados são então desenhados na direção escolhida. Uma tela que segue um padrão existente vai direto para o desenho.
    3. Desenhe o estado principal, depois os outros estados, usando apenas as peças e tokens do sistema. Algo novo (um componente, uma cor, um tamanho que a escala não possui) → SUB-HABILIDADE OBRIGATÓRIA: craft-system (modo adicionar) antes de usá-lo. Um componente que existe no código mas não está desenhado na ferramenta ("apenas no código" no índice) → SUB-HABILIDADE OBRIGATÓRIA: craft-sync (importação de um componente), desenhando apenas esse componente primeiro. Se a pessoa recusou a importação (veja DESIGN.md), pergunte uma vez antes de importar; se ainda disser não, construa a partir dos valores do código no próprio board e anote. Nunca desenhe um similar, e nunca codifique um novo valor em uma página.
    4. SUB-HABILIDADE OBRIGATÓRIA: craft-critique no modo auto-verificação em cada board: renderize, corrija o que encontrar dentro do escopo desta tarefa e renderize novamente.
  4. Finalização.
    • Mostre o resultado com o resumo abaixo.
    • Anexe as decisões em DESIGN.md › Registro de decisões (data, decisão, motivo).
    • Mova qualquer pergunta que foi respondida para fora de Perguntas em aberto.

Resumo de finalização (a forma da sua mensagem final)

Feito: <páginas/elementos> — <onde: arquivos ou boards>
Decisões: <cada uma, uma linha com seu motivo> (também em DESIGN.md › Registro de decisões)
Alterações no sistema: <peças ou tokens adicionados/alterados> — afeta: <telas>
Corrigido na auto-verificação: <o que o craft-critique alterou antes de você ver>
Perguntas em aberto: <o que a pessoa ainda precisa decidir>

Regras

RegraPor quê
DESIGN.md primeiro, sempreSem o brief, cada tela inventa seu próprio estilo
Escopo confirmado antes do trabalho quando houver mais de um itemTrês páginas construídas com uma leitura errada são três páginas desperdiçadas
Lista de estados antes de desenhar (via craft-states)O caminho feliz é um estado entre muitos
Opções apenas quando a direção está em abertoOpções em um padrão resolvido desperdiçam a atenção da pessoa
Apenas peças e tokens do sistema; novos passam por craft-systemValores codificados em páginas são onde a divergência começa
O código vence um brief desatualizado; anote, não substituaOs tokens são o que é enviado; o brief é atualizado por decisão, não silenciosamente
Auto-verificação antes de mostrarA pessoa deve revisar o design, não pegar erros
Decisões vão para DESIGN.mdA próxima sessão de design começa a partir delas, não da memória

Concluído quando

Cada item no escopo confirmado tem seus estados desenhados e auto-verificados, qualquer alteração no sistema passou por craft-system, o resumo de finalização foi fornecido e o Registro de decisões de DESIGN.md foi atualizado.

Erros comuns

PensamentoRealidade
"Três páginas são claras o suficiente, vou construí-las"Confirme a lista primeiro. Custa uma mensagem.
"Vou fazer botões de 52px aqui; o token diz 44, mas esse público precisa de maior"Isso é uma decisão de sistema. Proponha via craft-system, depois use em todo lugar.
"O brief diz teal, então vou substituir o azul no CSS desta página"O código vence. Sinalize o conflito e pergunte; nunca corrija tokens localmente.
"Vou mostrar, eles me dirão o que está errado"Execute craft-critique em modo auto-verificação primeiro e diga o que foi corrigido.
"As decisões estão na minha mensagem, é suficiente"Mensagens desaparecem. Anexe-as a DESIGN.md.
"Esta sessão não pode esperar por respostas, então vou tomar as decisões eu mesmo e listá-las"Terminar sua vez com a pergunta é parar. Faça isso; não construa nada além da primeira parada em aberto.
"Para economizar uma viagem de ida e volta, vou colocar as duas paradas em uma mensagem"Tudo bem, se você então parar. Pergunte ambas, não construa nada, aguarde.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas