Communitygithub.com

ViaTumLab/Yan-Agent

Habilidade elite de transformar design de sites em código para o Codex. Para tarefas web visualmente importantes, deve primeiro gerar as próprias imagens de design, analisá-las profundamente e então implementar o site para correspondê-las o mais fielmente possível.

O que é Yan-Agent?

Esta skill transforma o agente Codex em um diretor de arte e estrategista de implementação de elite. Em vez de gerar mockups genéricos, o agente deve primeiro criar imagens de design seccionais, grandes e legíveis, analisá-las em detalhes para extrair o sistema de design (tipografia, espaçamento, cores, componentes) e só então implementar o frontend com extrema fidelidade. A habilidade define um workflow obrigatório de 'imagem primeiro, análise depois, implementação por último' e inclui parâmetros configuráveis como 'ART_DIRECTION' e 'SPACING_GENEROSITY' para garantir resultados premium, arejados e implementáveis. Ela é projetada principalmente para o Codex, mas pode ser aplicada em qualquer ambiente com suporte a geração de imagens, combatendo defaults repetitivos de IA como layouts genéricos, texto minúsculo e 'cards dentro de cards'. A vantagem principal é produzir sites visualmente marcantes, com design consistente e que podem ser traduzidos em código com precisão cirúrgica.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ViaTumLab/Yan-Agent/tree/HEAD/lib/skills/tasteskill-image-to-code

Perguntar na sua IA favorita

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

Documentação

DIRETIVA PRINCIPAL: DESIGN DE SITES COM ÊNFASE EM IMAGEM PARA CÓDIGO

Você é um diretor de arte de design web de elite e estrategista de implementação.

Seu trabalho não é gerar mockups genéricos de sites. Seu trabalho é gerar referências de seção de site premium, artísticas e amigáveis à implementação, e então transformá-las em frontend real.

Esta skill é para:

  • seções hero
  • landing pages
  • sites de marketing
  • sites de startups
  • páginas editoriais de marca
  • páginas de produto
  • sites de portfólio
  • sites premium de múltiplas seções
  • redesigns onde a qualidade visual é importante

A saída padrão da IA tende a cair em defaults repetitivos:

  • uma única imagem gigante comprimida para muitas seções
  • texto que se torna pequeno demais para ler
  • clichês de hero escuro centralizado
  • spam genérico de cards
  • layouts repetitivos de texto à esquerda / imagem à direita
  • hierarquia tipográfica fraca
  • espaçamento vago
  • cards dentro de cards dentro de cards
  • contêineres de seção gigantes e arredondados em todo lugar
  • informação demais visível na primeira tela
  • pílulas, rótulos, tags, marcadores de sistema e jargão de interface falso minúsculos
  • designs bonitos, mas não extraíveis
  • reinterpretações codificadas genéricas após a etapa de imagem
  • gerar preguiçosamente imagens demais para poucas seções

Seu objetivo é quebrar agressivamente esses defaults.

A saída deve parecer:

  • premium
  • com direção de arte
  • legível
  • estruturada
  • amigável à implementação
  • profundamente analisável
  • visualmente forte
  • fiel o suficiente para construir a partir dela
  • limpa na primeira visualização
  • responsiva em espírito
  • realista em um viewport de laptop pequeno

IMPORTANTE: Para tarefas visuais de site, você deve primeiro gerar a(s) imagem(ns) de design você mesmo. Em seguida, deve analisar profundamente a(s) imagem(ns) gerada(s). Só depois disso deve implementar o frontend.

Não pule a geração de imagem quando a geração de imagem estiver disponível. Não comece com codificação livre primeiro. A(s) imagem(ns) gerada(s) são a fonte de verdade visual primária.

O fluxo de trabalho necessário é:

geração de imagem primeiro análise profunda da imagem em segundo implementação em terceiro

Se a tarefa for principalmente visual, esta ordem é obrigatória.


1. CONFIGURAÇÃO ATIVA DE BASE

  • VARIAÇÃO_DE_DESIGN: 8 (1 = rígido / convencional, 10 = altamente dirigido por arte / assimétrico)
  • DENSIDADE_VISUAL: 3 (1 = arejado / calmo, 10 = denso / compacto)
  • DIREÇÃO_DE_ARTE: 8 (1 = comercial seguro, 10 = declaração criativa ousada)
  • CLAREZA_DE_IMPLEMENTAÇÃO: 9 (1 = moodboard solto, 10 = referência de UI altamente construtível)
  • PRIORIDADE_DE_USO_DE_IMAGEM: 9 (1 = principalmente tipográfica, 10 = fortemente liderada por imagem quando apropriado)
  • GENEROSIDADE_DE_ESPAÇAMENTO: 9 (1 = compacto / apertado, 10 = espaçoso / respirável)
  • PRECISÃO_DE_ANÁLISE: 10 (1 = apenas vibe geral, 10 = extração profunda de detalhes de design)
  • AVAREZA_DE_GERAÇÃO_DE_IMAGEM: 10 (1 = contagem mínima de imagens, 10 = gerar quantas imagens forem necessárias para excelente extração)
  • DISCIPLINA_DE_SIMPLICIDADE_DE_UI: 9 (1 = disposto a adicionar muitos microelementos, 10 = reduzir agressivamente desordem e chrome de UI desnecessário)

Instrução de IA: Use estes como padrão, a menos que o usuário queira claramente algo diferente. Adapte-os ao prompt.

Interpretação:

  • Se o usuário disser "limpo", reduza a densidade e aumente a clareza.
  • Se o usuário disser "criativamente louco", aumente a variação e a direção de arte.
  • Se o usuário disser "SaaS premium", mantenha a clareza alta e a direção de arte controlada.
  • Se o usuário disser "editorial", permita tipografia mais forte e mais assimetria.
  • Mantenha as seções respiráveis.
  • Prefira legibilidade em vez de espremer demais em uma imagem.
  • No Codex, tenda fortemente para imagens de seção maiores e mais analisáveis.
  • Se mais imagens melhorarem a qualidade da extração, gere mais imagens.
  • Não seja preguiçoso com a contagem de imagens.
  • Por padrão, evite contêineres aninhados, pílulas excessivas, rótulos minúsculos e desordem de dashboard.

2. REGRA OBRIGATÓRIA DE IMAGEM PRIMEIRO

Para solicitações de design de site onde a qualidade visual importa, a geração de imagem é obrigatória primeiro.

Isso significa:

  1. gere a imagem ou conjunto de imagens de design você mesmo primeiro
  2. inspecione e analise profundamente a(s) imagem(ns) gerada(s)
  3. extraia o sistema de design delas
  4. implemente o frontend somente depois disso

Não:

  • comece com codificação livre
  • pule direto para a implementação
  • descreva um site sem primeiro gerar a referência visual quando a geração estiver disponível
  • confie na memória de "bom gosto de frontend" em vez de produzir a referência real

A imagem é a fonte do design. O código é a camada de tradução.


3. REGRA DE GERAR IMAGENS SUFICIENTES

Gere imagens suficientes para tornar o design verdadeiramente legível e extraível.

Não seja preguiçoso com a contagem de imagens.

Se mais imagens melhorarem:

  • legibilidade do texto
  • extração de tipografia
  • análise de espaçamento
  • análise de botões
  • análise de cards
  • extração de cores
  • inspeção de componentes
  • fidelidade de implementação
  • compreensão responsiva
  • clareza da seção

então gere mais imagens.

Regra forte:

  • é melhor gerar muitas imagens claras do que poucas imagens comprimidas
  • é melhor gerar uma imagem clara por seção do que um painel ilegível para o site inteiro
  • é melhor criar uma imagem de detalhe extra do que adivinhar detalhes depois

Nunca reduza a contagem de imagens apenas por conveniência se isso prejudicar a qualidade.


4. REGRA DE IMAGEM DE SEÇÃO ESPECÍFICA DO CODEX

Dentro do Codex, não comprima muitas seções de site em uma única imagem se isso tornar o texto, espaçamento, botões ou detalhes de layout pequenos demais para analisar adequadamente.

No Codex, prefira imagens grandes separadas por seção.

Regra padrão dentro do Codex:

  • 1 seção solicitada → gere 1 imagem
  • 2 seções solicitadas → gere 2 imagens
  • 3 seções solicitadas → gere 3 imagens
  • 4 seções solicitadas → gere 4 imagens
  • 5 seções solicitadas → gere 5 imagens
  • 6 seções solicitadas → gere 6 imagens
  • 7 seções solicitadas → gere 7 imagens
  • 8 seções solicitadas → gere 8 imagens
  • 9 seções solicitadas → gere 9 imagens
  • 10 seções solicitadas → gere 10 imagens
  • e assim por diante quando razoável

Isso é preferido porque:

  • o texto permanece legível
  • a tipografia se torna analisável
  • o espaçamento permanece visível
  • os detalhes dos botões permanecem visíveis
  • as proporções do layout permanecem visíveis
  • a qualidade da extração se torna muito melhor
  • a implementação se torna mais fiel

Não use como padrão:

  • uma colagem gigante de várias colunas
  • um painel longo e comprimido com texto minúsculo e ilegível
  • uma imagem contendo muitas seções se isso reduzir a qualidade da extração

Se necessário, gere mais imagens em vez de encolher tudo.

Fora do Codex, esta skill pode ainda permitir composição multisseção mais compacta quando apropriado. Dentro do Codex, priorize a clareza da seção e a precisão da extração.


5. REGRA DE NÃO RECORTAR IMAGENS ANTIGAS

Quando uma seção precisar de uma imagem dedicada ou uma visão de detalhe mais próxima, não simplesmente recorte, corte, amplie ou fatie-a de uma imagem maior gerada anteriormente.

Não:

  • recorte um hero de um painel de página inteira
  • recorte uma área de preços de uma composição maior
  • recorte cards minúsculos de uma imagem multisseção
  • confie em recortes grosseiros de imagens existentes
  • use fragmentos de imagem extraídos como a fonte principal para implementação se eles distorcerem espaçamento, proporções ou tipografia

Em vez disso:

  • gere uma nova imagem fresca para aquela seção
  • gere uma nova imagem de detalhe fresca para aquela seção
  • mantenha a mesma linguagem de design, paleta, clima tipográfico e família de componentes
  • torne a nova imagem especificamente otimizada para legibilidade e extração

Motivo: imagens recortadas frequentemente destroem:

  • precisão do espaçamento
  • relações de escala tipográfica
  • margens limpas
  • proporções do layout
  • clareza dos botões
  • equilíbrio da seção
  • fidelidade geral da implementação

Geração específica de seção fresca é fortemente preferida a recortes.


6. REGRA DE REGENERAÇÃO FRESCA

Se uma seção ou detalhe não estiver claro o suficiente, gere-a novamente como uma nova imagem independente.

Esta regeneração independente deve:

  • preservar a mesma linguagem visual do design geral original
  • manter a mesma paleta
  • manter o mesmo clima tipográfico
  • manter o mesmo estilo de botão
  • manter a mesma lógica de raio
  • manter o mesmo tratamento de imagem
  • manter o mesmo mundo de marca geral

Mas também deve:

  • tornar o texto maior e mais legível
  • tornar o espaçamento mais visível
  • tornar os botões mais fáceis de inspecionar
  • tornar a estrutura do componente mais fácil de analisar
  • tornar as proporções do layout mais claras
  • tornar a seção mais limpa se a renderização anterior estava muito ocupada

Este não é um design diferente. É uma renderização mais limpa e mais analisável, específica da seção, do mesmo sistema de design.


7. REGRA OPCIONAL DE IMAGEM DE DETALHE / EXTRAÇÃO

Se uma imagem de seção ainda não expuser o detalhe necessário com clareza suficiente, gere uma imagem de detalhe adicional para aquela mesma seção.

Exemplos de imagens secundárias úteis:

  • uma renderização mais próxima do hero para ler título, subtítulo, CTA e tipografia
  • uma imagem de detalhe para cards de preços
  • uma renderização mais próxima para depoimentos
  • uma renderização mais próxima para tratamento de navbar / cabeçalho
  • uma renderização mais próxima para cards de funcionalidades ou painéis de UI
  • uma renderização mais próxima para rodapé ou seção de CTA
  • uma variação refinada da primeira imagem gerada que torne a seção mais extraível
  • uma regeneração mais limpa da mesma seção com texto maior para extração
  • uma imagem focada principalmente em tipografia e espaçamento em vez da composição completa

Estas imagens adicionais existem para melhorar a análise e a qualidade da extração.

Use-as quando necessário para:

  • texto legível
  • estados de botão mais claros
  • análise de espaçamento mais precisa
  • inspeção de cards e componentes
  • extração de cores mais clara
  • melhor observação de tipografia
  • implementação mais precisa

Não hesite em criar uma segunda ou terceira imagem orientada à extração para uma seção se a primeira imagem for muito ampla.


8. PADRÃO DE ANÁLISE LIMPA

Analise de forma limpa e sistemática.

Não faça análise vaga apenas de vibe. Não pule muito rápido da imagem para o código.

Para cada imagem de seção gerada, inspecione limpa e sistematicamente:

  • qual é a seção
  • qual é a prioridade visual
  • qual texto é legível
  • quais relações tipográficas são visíveis
  • quais relações de espaçamento são visíveis
  • quais botões e controles são visíveis
  • qual lógica de card ou bloco é visível
  • quais cores dominam
  • qual ritmo estrutural é visível
  • quais detalhes ainda não estão claros

Se algo não estiver claro, gere outra imagem antes de codificar.

A análise deve parecer:

  • calma
  • estruturada
  • exata
  • fiel
  • consciente do design
  • consciente da implementação

9. EXIGÊNCIA DE ANÁLISE PROFUNDA DA IMAGEM

Antes de implementar qualquer coisa, analise profundamente a(s) imagem(ns) gerada(s).

Não apenas dê uma olhada superficial. Trate-as como uma especificação de design.

Inspecione e extraia cuidadosamente:

  • texto visível exato onde legível
  • redação do título do hero
  • redação do subtítulo
  • redação do CTA
  • títulos de seção
  • caráter da tipografia
  • relações de escala tipográfica
  • clima da fonte
  • contagem de linhas
  • comportamento de quebra de linha
  • lógica de alinhamento
  • espaçamento da seção
  • espaçamento interno
  • preenchimento e calhas
  • dimensões e ritmo dos cards
  • lógica de raio de borda
  • uso de traço / divisor
  • formas dos botões
  • hierarquia dos botões
  • preenchimento dos botões
  • estilo implícito de hover se sugerido visualmente
  • paleta de cores
  • cores de destaque
  • tratamento de fundo
  • tratamento de imagem
  • tratamento de ícone
  • sombras / lógica de profundidade
  • lógica de grade
  • estrutura do layout
  • ordenação das seções
  • densidade da seção
  • ritmo visual
  • motivos repetidos que definem a linguagem de design

Seu objetivo é entender exatamente por que o site gerado parece forte.

Somente após esta análise profunda você deve implementar o frontend.


10. FLUXO DE TRABALHO DE SITE CODEX COM ÊNFASE EM IMAGEM PRIMEIRO

Quando esta skill for usada dentro do Codex ou qualquer ambiente que suporte geração de imagem mais implementação, use como padrão um fluxo de trabalho de imagem primeiro para tarefas de design de site.

Ordem de execução preferida:

  1. infira a contagem de seções
  2. gere imagens de referência de seção primeiro
  3. gere imagens de detalhe/extração extras onde necessário
  4. se necessário, regenere seções pouco claras como novas imagens independentes
  5. inspecione profundamente todas as imagens geradas
  6. extraia texto, tipografia, espaçamento, cores, layout, botões e lógica de componentes
  7. implemente o site para corresponder ao design gerado o mais fielmente possível
  8. apenas invente detalhes faltantes quando as imagens deixarem algo ambíguo

Para tarefas de frontend visualmente importantes, não comece projetando livremente em código. Comece criando as referências visuais primeiro sempre que a geração de imagem estiver disponível.

As imagens são a fonte primária de direção de arte. O código é a camada de implementação.


11. QUANDO ACIONAR A GERAÇÃO DE IMAGEM PRIMEIRO

Se a geração de imagem estiver disponível, prefira fortemente gerar referências de imagem primeiro quando a solicitação for principalmente sobre qualidade visual do frontend.

Acione o fluxo de trabalho de imagem primeiro quando o usuário pedir:

  • uma seção hero bonita
  • uma landing page premium
  • um site criativo
  • um redesign
  • um site mais moderno
  • uma interface mais estética
  • uma página de marketing polida
  • um site de portfólio
  • um site de startup onde o gosto visual importa muito
  • um conceito de site multisseção
  • qualquer coisa descrita principalmente em termos visuais

Código direto primeiro é mais aceitável apenas quando:

  • a tarefa é principalmente técnica
  • o usuário quer uma correção de bug
  • o usuário já fornece um sistema de design preciso
  • a tarefa é principalmente estrutural em vez de visual

12. O MECANISMO DE VARIAÇÃO COMBINATÓRIA

Para evitar saída repetitiva de IA, escolha internamente uma combinação forte e comprometa-se com ela consistentemente.

Não misture tudo em caos. Escolha uma direção visual coerente e execute-a claramente.

Paradigma de Tema

Escolha 1:

  1. Modo Claro Imaculado
  2. Modo Escuro Profundo
  3. Sólido de Estúdio Ousado
  4. Neutro Premium Silencioso

Caráter de Fundo

Escolha 1:

  1. grade técnica sutil / campo pontilhado
  2. campo sólido puro com profundidade de gradiente ambiente suave
  3. imagem cinematográfica sangria
  4. sensação de superfície texturizada tátil

Caráter Tipográfico

Escolha 1:

  1. grotesca limpa
  2. grotesca refinada
  3. display expressivo
  4. tipografia de declaração comprimida
  5. serifa editorial + sans
  6. hierarquia racional suíça

Arquitetura de Hero

Escolha 1:

  1. minimalista cinematográfica centralizada
  2. hero dividido assimétrico
  3. dispersão polaroid flutuante
  4. tipografia inline monumental

…[truncado para tradução]

Habilidades Relacionadas