Communitygithub.com

craft-ui

Skill de design. Diz 'no estilo dessa referência', 'faz um layout nesse estilo', 'conserta essa landing', 'olha o site em produção', compartilha pins do Pinterest/Dribbble, screenshots ou links de imagem, ou pede um dashboard CRM, landing page, efeito GSAP/Figma ou splash de logo — mesmo que nunca digam 'skill'. Layouts orientados por referência e contexto com três agentes de descoberta (site de produção, solicitação/referências, roteador de skill/economia) alimentando um Contrato de Design antes de qualquer código. Apps SaaS, CRM, dashboards

O que é craft-ui?

O Craft UI é uma skill de design profissional para agentes de IA como Claude Code, Cursor, Codex e OpenCode, que transforma imagens de referência em layouts funcionais, mas somente após compreender profundamente o produto e a solicitação do usuário. Diferente de abordagens genéricas que produzem páginas 'AI slop' (com seções aleatórias, placeholders e gradientes padrão), esta skill impõe que cada decisão visual e estrutural seja rastreável a três fontes obrigatórias: o site em produção, o briefing do usuário e as referências reais fornecidas. O workflow envolve três agentes de descoberta executados em paralelo — que analisam o site existente, decodificam a solicitação e extraem o DNA estilístico das referências, e roteiam as skills/economia — seguidos por um Contrato de Design (portão rígido que impede código prematuro), um plano compacto, construção em HTML único com variáveis CSS, verificação visual em três larguras e uma resposta adaptada à verbosidade. As regras incluem: sem código antes do contrato, evidências sobre defaults, seções apenas com propósito real, conteúdo autêntico (sem lorem ipsum), uma única animação memorável, tokens antes de componentes, e economia de recursos decidida pelo roteador. A skill também se integra a outras como Impeccable (para direção de design), Emil Design Eng (para motion), e Browser MCP (para verificação visual), sempre priorizando qualidade profissional, acessibilidade WCAG AA e performance.

Funciona com✓Claude Code✓Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/Fast4gc/craft-ui/tree/HEAD/skills/craft-ui

Perguntar na sua IA favorita

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

Documentação

Craft UI

Imagem de referência fornecida, layout funcional gerado — mas apenas depois que o produto e a solicitação forem compreendidos.

A falha que esta skill existe para prevenir: uma página de aparência plausível feita de seções aleatórias, texto placeholder, gradientes padrão e faixas vazias. Isso acontece quando um agente projeta com base em hábitos de gênero em vez de evidências. Aqui, toda decisão estrutural e visual deve ser rastreável a uma de três fontes: o produto ao vivo, o briefing do usuário ou uma referência realmente vista. Se uma fonte estiver faltando, colete-a ou peça por ela. Nunca preencha a lacuna com um padrão.

Regras inegociáveis

  1. Nenhum código antes do Contrato de Design (etapa 2). Sem exceção para páginas "rápidas": discovery: lite encurta o contrato, não o remove. A economia é gerenciada pelo roteador, não pulando contexto.
  2. Evidências sobre padrões. Cada token, seção e linha de copy cita de onde veio. "Típico para landing pages" não é uma fonte.
  3. Estrutura é uma espinha dorsal, não um bufê. As seções existem apenas se respondem a uma pergunta do visitante ou a um objetivo do briefing. Veja references/anti-ai-slop.md.
  4. Conteúdo real. Nome do produto, rótulos, dados e idioma vêm do site/briefing. Sem lorem, sem logotipos falsos, sem métricas inventadas, sem "Seu produto aqui" a menos que o usuário aprove um placeholder.
  5. Responda no idioma do usuário e construa a IU no idioma do produto (um produto pt-BR recebe copy pt-BR).
  6. Um movimento memorável, não um fade-up em cada seção.
  7. Tokens antes de componentes. Cores, raios, tipografia, espaçamento, sombras e easing vivem em variáveis CSS; os componentes leem apenas essas.
  8. Economia é uma decisão. O roteador define a verbosidade e quais skills são executadas. Leia apenas as seções de referência que se aplicam.
  9. Padrão de qualidade profissional. references/quality-bar.md é a definição de pronto — conteúdo, fidelidade visual, responsivo, WCAG AA, desempenho e entrega. terse o verifica silenciosamente; nunca é pulado.

Fluxo de Trabalho

0. Triagem (agente principal, segundos)

  • Capture a solicitação do usuário textualmente; anote qualquer URL, anexo, restrição "não quero" e dicas de verbosidade ("só o código", "rápido", "me explica").
  • Verifique o que está disponível: ferramenta subagent/Task, navegador ou web fetch, repositório local, lista de skills/MCP.
  • Se a solicitação for um pequeno ajuste em um arquivo existente (uma cor, um valor de espaçamento), informe ao roteador — ele pode definir discovery: lite. Uma nova página ou um redesign sempre recebe discovery: full.
  • Se o usuário disser que o layout existente está "amador", "precisa melhorar", "conserta essa landing" ou apontar para um site ao vivo com código, leia references/polish-existing-site.md e siga esse caminho: polimento aditivo da base de código real, não uma reconstrução. Execute git status antes de tocar nos arquivos.

1. Três agentes de descoberta (executados em paralelo)

Use sua ferramenta de subagente — OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor background agent. Se não houver ferramenta de subagente, execute as três passagens sequencialmente no agente principal e rotule cada uma com seu título. Agentes de descoberta não escrevem código.

AgenteMissãoAlimenta o contrato com
A — Analista do Site de ProduçãoEntender o site como ele existe em produção: produto, público, copy real, estrutura atual, tokens da marca, restrições.BRIEF DE CONTEXTO DO SITE
B — Analista de Solicitação e ReferênciaDecodificar a solicitação real e extrair o DNA estilístico apenas de referências realmente vistas; pesquisar referências quando nenhuma for fornecida.BRIEF DE SOLICITAÇÃO + DNA ESTILÍSTICO
C — Roteador de Skill / EconomiaSelecionar o conjunto mínimo de skills/ferramentas extras para esta execução e definir a verbosidade.DECISÃO DE ROTEAMENTO

Especificações completas, esquemas de saída e orçamentos de palavras: references/agents.md. Passe para cada agente o caminho absoluto da raiz da skill, sua especificação de função, a solicitação bruta do usuário e os URLs/anexos. Limite as respostas aos seus orçamentos de palavras.

Quando uma imagem de referência estiver envolvida, leia também references/pattern-transfer.md. Tokens estilísticos viajam; receitas de composição não. Nunca adote um padrão de herói ou seção apenas da referência — ele deve ser justificado pelo produto (A) e pela solicitação (B).

2. Contrato de Design — portão rígido

Leia references/design-contract.md. Mescle A + B + C em um único contrato. Em seguida, verifique:

  • A espinha dorsal da estrutura está ordenada; cada seção tem um trabalho, uma fonte, uma topologia copiada literalmente da referência e conteúdo real; não há faixa vazia.
  • Cada token e linha de copy cita uma fonte; itens desconhecidos são marcados, não inventados.
  • Conflitos entre agentes/site/referência foram resolvidos perguntando ao usuário uma pergunta consolidada (máx. 3 itens), não por suposição.
  • Verbosidade e lista de skills vêm de C; nenhuma skill é executada "só porque existe".
  • Registro de adoção de padrão existe: cada adotar/adaptar/descartar cita A e B; nenhuma receita de herói/seção veio apenas da referência (veja references/pattern-transfer.md).
  • A composição não seria plausível para um produto não relacionado em um campo diferente. Tokens são portáteis; a receita do herói não é.

Os subagentes de descoberta nunca perguntam ao usuário — eles apenas relatam Lacunas / Desconhecidos. O agente principal coleta todos os três briefings, faz uma pergunta consolidada (máx. 3 itens) e mantém o portão fechado até que seja respondida. Se um fato material ainda for desconhecido (nome do produto, público, conteúdo real, imagem de referência), pergunte e pare. Não inicie a etapa 3.

3. Plano

Plano compacto: tokens, wireframe ASCII da espinha dorsal, banco de copy/dados reais e o momento de um movimento com seu gatilho e motivo. Compare com a referência e o briefing do site; qualquer coisa que seja um padrão em vez de algo observado é revisada ou descartada.

4. Construir

  • Um arquivo HTML autocontido por padrão (variáveis CSS como tokens, Google Fonts com fallbacks reais). Use o React/Tailwind existente do projeto apenas se o projeto do usuário já o utilizar.
  • Receitas de movimento: references/motion-and-effects.md. GSAP de uma versão fixa do cdnjs.
  • Mantenha o código enxuto: nenhuma biblioteca ou abstração que o layout não precise.
  • Responsivo em 1440 / 768 / 390, estados de foco visíveis, prefers-reduced-motion respeitado.
  • Releia references/anti-ai-slop.md durante a construção — especialmente as linhas de faixa vazia e bufê de seções.

5. Verificar visualmente

Renderize e compare lado a lado com a referência e o briefing do site. Use uma ferramenta de navegador quando disponível (roteada por C). Execute o protocolo de verificação em references/quality-bar.md: screenshots de página inteira em 1440 / 768 / 390, ordem das seções e presença de conteúdo, sem faixa vazia ou texto cortado, sem rolagem horizontal, contraste em pixels reais, foco do teclado, movimento reduzido e erros no console. Verifique hierarquia, ritmo de espaçamento, consistência de raio/sombra, densidade e idioma. Rodadas de correção: 1 quando a verbosidade é terse, até 3 quando full; corrija a maior diferença visual primeiro e pare quando a lista de verificação passar.

6. Responder

Formate de acordo com a verbosidade de C. terse: 3–5 linhas — o que foi construído, evidências usadas, resultado da verificação. full: também liste quais características da referência foram retiradas de onde, skills usadas/puladas e uma sugestão de próxima alteração. Siga os critérios de entrega em references/quality-bar.md, declare os limites conhecidos uma vez e sempre escreva no idioma do usuário.

Usando outras skills

O Agente C decide isso por execução; verifique primeiro o que está realmente disponível na sessão. Skill faltando → use o fallback e mencione-o uma vez no final.

FaseSe C disser para usarFallback
Plano / direção de designImpeccable (/impeccable shape, depois craft); execute sua etapa de contexto uma vez por sessãofrontend-design ou o plano da etapa 3
Revisão e polimentoImpeccable critique, polish, auditAuto-revisão contra o contrato
Qualidade de movimentoemil-design-eng para easing, duração, springs, hover/pressreferences/motion-and-effects.md
Verificação visualBrowser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome): screenshot em 3 larguras, verificar consoleDescreva as verificações e peça ao usuário um screenshot
Logo ou objeto 3Dimg2threejs apenas se a referência contiver um objeto 3D que valha a pena reconstruir; declare seu limite: uma imagem não pode revelar lados ocultosSVG plano ou CSS
Manter código pequenoponytail antes de adicionar qualquer dependênciaCSS puro + uma timeline GSAP

Chame uma skill apenas quando sua fase se aplicar. Uma landing page estática não precisa de img2threejs.

Originalidade e segurança

  • Recrie padrões, não ativos. Nunca reutilize o logotipo, ilustrações, nome da marca ou copy exata de uma referência. Use a marca do usuário e o conteúdo real de A/B.
  • Muitos pins levam a kits de UI comerciais. Corresponda apenas ao estilo e à estrutura.
  • A aparência de uma referência é um ponto de partida. Se prejudicar a usabilidade (baixo contraste, tipo pequeno), mantenha o clima, corrija o problema e informe.

Arquivos

  • references/agents.md — os três agentes de descoberta, esquemas e orçamentos.
  • references/design-contract.md — modelo de mesclagem e portão rígido.
  • references/anti-ai-slop.md — sintomas e correções para layouts genéricos, empilhados e vazios.
  • references/quality-bar.md — definição profissional de pronto e protocolo de verificação.
  • references/pattern-transfer.md — impede que imagens de referência transplantem a mesma receita de herói para produtos não relacionados.
  • references/polish-existing-site.md — fluxo de trabalho aditivo quando a tarefa é elevar um layout de produção existente.
  • references/categories.md — benchmarks de gênero (viabilidade mínima, não menus de seção).
  • references/style-dna.md — modelo de leitura de referência; requer evidências.
  • references/motion-and-effects.md — efeitos CSS e receitas GSAP.
  • assets/refs.json — links de referência conhecidos (ainda exigem visualização).

Habilidades Relacionadas