Communitygithub.com

Extrator de Estilos de Frontend

Habilidade de design. Extraia e documente um sistema de design frontend portátil a partir de um aplicativo web existente ou site acessível.

O que é Extrator de Estilos de Frontend?

O Extrator de Estilos de Frontend é uma habilidade especializada para Agentes de IA (como Claude Code, Cursor, Codex) que automatiza a engenharia reversa do design de um aplicativo web existente em um pacote de sistema de design portátil e neutro em relação a frameworks. Ele analisa o CSS, componentes e layout da fonte para produzir tokens de design, regras de tipografia, padrões de layout, especificações de componentes e regras interativas/responsivas, tudo documentado como um contrato de entrega claro para a habilidade parceira 'frontend-style-adapter'. A habilidade segue um fluxo de trabalho rigoroso: orientação no repositório sem modificações, amostragem representativa de UI, verificação de proveniência e hierarquia de regras, e geração de um bundle de sistema de design validado. Ela impõe restrições rígidas, como não alterar o código fonte, não copiar ativos licenciados e não inferir valores não verificados. A saída é um conjunto de arquivos estruturados (manifest, tokens, regras, etc.) que capturam a intenção do design, permitindo que desenvolvedores recriem estilos consistentes em novos projetos sem depender do framework original.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

Perguntar na sua IA favorita

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

Documentação

O que Extrator de Estilos de Frontend faz?

Objetivo

Produzir um Pacote de Sistema de Design Portátil v1.0.0 baseado em evidências e neutro em relação a frameworks, a partir de um frontend fonte. A saída é um contrato de entrega para frontend-style-adapter, NÃO é código fonte copiado e NÃO é um clone pixel-perfect.

Leia references/CONTRACT.md antes de escrever o pacote. Leia references/INSPECTION_CHECKLIST.md durante a inspeção. Não invente valores de estilo nem represente padrões inferidos como fatos observados.

Entradas

  • Fonte: raiz do repositório / espaço de trabalho, diretórios selecionados ou um site renderizado acessível.
  • Opcional: páginas/componentes específicos, temas, breakpoints, fidelidade de design, caminho de saída.
  • Padrões: fonte = repositório atual; escopo = UI compartilhada representativa + rotas/páginas detectáveis no repositório; saída = design-system/portable/ dentro do repositório fonte (a menos que o usuário solicite outro local).
  • Uma URL pública sem CSS fonte acessível ou estilos computados é uma fonte apenas visual. Marque medições exatas de pixel/cor/espaçamento como inferidas, a menos que sejam mensuráveis por ferramentas. Se o ambiente não puder abrir o site, explique a limitação em vez de fabricar a análise.

Fluxo de Trabalho

  1. Oriente-se sem alterar a fonte. Verifique status do git, estrutura do projeto, manifesto de pacotes, framework e pilha de estilização, estrutura de rotas/páginas, estilos globais, provedores de tema, bibliotecas de componentes e tokens de design. Respeite AGENTS.md e instruções do repositório. Nunca leia .env, segredos ou dados irrelevantes.
  2. Execute o inventário heurístico opcional (apenas stdlib; não é um parser CSS autoritativo): python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json Use um caminho temporário fora do repositório, se possível. Leia o resumo; verifique afirmações importantes diretamente no código/UI renderizada.
  3. Amostre a UI representativa: shell global, navegação, títulos/texto, botões, campos/formulários, cards, tabelas, modais, alertas, estados de carregamento/vazio/erro; inspecione desktop e mobile, hover/foco/desabilitado, claro/escuro se suportado. Amostre tanto rotas comuns quanto incomuns. Registre superfícies inspecionadas vs ignoradas.
  4. Resolva hierarquia de regras: tokens explícitos/configuração → componentes compartilhados → padrões de página repetidos → exceções isoladas. Não confunda o layout de uma única página com uma regra global. Preserve tokens semânticos e aliases (ex. var(--brand-primary)) quando significativos; declare valores resolvidos reais apenas se verificados.
  5. Registre proveniência: cada token e cada regra estruturada precisa de origin, confidence e evidence concreta. Prefira caminho de arquivo + linha/símbolo, observação de estilo computado ou referência de screenshot/viewport. Qualquer inferência não suportada deve ser rotulada como tal. Indique limitações, páginas não inspecionadas, incertezas sobre licenciamento de dependências/ativos.
  6. Elabore o pacote no caminho de saída escolhido. Arquivos obrigatórios: manifest.json, tokens.json, rules.json, README.md, typography.md, layout-rules.md, component-rules.md, interaction-rules.md, responsive-rules.md. Opcional: assets.md para considerações sobre ícones/imagens/fontes. Veja references/CONTRACT.md e assets/example-bundle/ para formato; substitua TODO o conteúdo de exemplo por observações específicas da fonte. Use linguagem portátil (contratos de componente e intenção de design) em vez de implementação específica de framework como única descrição.
  7. Valide: python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Corrija todos os erros. Inspecione manualmente itens desconhecidos/de baixa confiança. Não afirme que a fidelidade visual foi testada se nenhuma comparação de navegador/captura de tela foi realizada.
  8. Relate: fonte e superfícies inspecionadas, framework/método de estilização, caminho de saída, contagens de tokens/regras, cobertura/incertezas, resultado do validador e instruções de uso: invoque frontend-style-adapter com o caminho do sistema de design.

Restrições rígidas

  • Extraia linguagem de design, não lógica de negócio, cópia, ativos proprietários ou detalhes de implementação interna.
  • Não modifique o código fonte do aplicativo, instale pacotes, reescreva configuração ou faça commit automaticamente. Criar o pacote solicitado é permitido.
  • Não copie logotipos, binários de fontes, imagens/ícones licenciados para o pacote, a menos que o usuário autorize explicitamente e os direitos estejam claros; em vez disso, descreva sua aparência, referências originais e ressalvas de licenciamento.
  • Não transfira .env, credenciais, dados de usuário, respostas de API ativas ou segredos.
  • Preserve temas escuro/claro separados e regras responsivas se existirem; não os achate em um único estilo.
  • Detalhes exatos de implementação pertencem a evidence/notas; requisitos devem permanecer portáteis entre frameworks.
  • Prefira clareza a volume: padrões documentados de alto valor superam centenas de tokens não suportados.
  • Se nenhuma UI/navegador executável estiver disponível, reporte visualVerification: "not_performed" no manifesto.

Pronto quando

O pacote valida; cada fato exportado é rastreável; regras globais estão separadas de exceções; estados de acessibilidade/responsividade são abordados; e o relatório indica lacunas conhecidas.

Habilidades Relacionadas