CommunityImagemgithub.com

Hyliox Pixel Perfect

Transforma capturas de tela de UI em especificações de reconstrução fiéis aos pixels, prontas para agentes de codificação de IA como Cursor, v0.dev, Lovable, Codex e Claude Code.

O que é Hyliox Pixel Perfect?

Este skill traduz capturas de tela de interfaces de usuário (landing pages, telas de aplicativos, dashboards, mockups) em uma especificação de reconstrução detalhada e prescritiva, otimizada para máxima fidelidade visual. O output é um arquivo Markdown longo (~1000 linhas) seguindo um template fixo de 21 seções, que cobre desde a pilha tecnológica (Next.js 16 App Router, Tailwind CSS, shadcn/ui, Framer Motion) até tokens de design, animações, hierarquia visual e detalhes precisos de cópia. Diferente de ferramentas de feedback estético, o Hyliox Pixel Perfect é estritamente para reconstrução: ele extrai cada elemento visível na imagem — incluindo cores, tipografia, logotipos e até erros de digitação — e os organiza em um formato que agentes de IA possam consumir diretamente como um prompt de construção. O skill se destaca pela sua rigidez: não inventa conteúdo, não pula seções e não oferece sugestões de melhoria, garantindo que o desenvolvedor ou agente tenha um guia preciso e acionável para clonar o design exato.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/ys-sites/video/tree/HEAD/hyliox-pixel-perfect

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 Hyliox Pixel Perfect faz?

Traduza capturas de tela de UI em especificações de construção longas, densas e prescritivas para agentes frontend. Otimizado para máxima fidelidade, não para brevidade.

Filosofia

Este skill produz uma especificação fixa de 21 seções, com cerca de ~1000 linhas, pronta para copiar e colar no Cursor / v0 / Lovable / Codex / Claude Code. É prescritivo, não adaptativo: as mesmas 21 seções aparecem em cada saída, na mesma ordem. Se uma seção não tiver conteúdo para uma determinada imagem (ex.: sem animações visíveis), declare explicitamente "Não visível nesta captura de tela — implemente como estático" em vez de pulá-la. Estrutura previsível supera inteligência variável.

O skill é uma engenharia reversa de duas saídas de referência padrão ouro (assets/gold-standard-kraken.md e assets/gold-standard-agentai.md). Em caso de dúvida sobre formato, extensão ou granularidade, leia os padrões ouro primeiro. Eles são a verdade absoluta.

Fidelidade sobre interpretação. Descreva o que está na imagem. Não invente seções, texto, recursos ou melhorias. Se a imagem mostrar três cartões de recurso, descreva três. Se um logotipo for repetido na faixa de marcas, repita-o. Se houver um erro de digitação na navegação ("Why Karken"), preserve-o (e ofereça ao reconstrutor a escolha de corrigir).

Granularidade sobre prosa. Cada propriedade visual — posição, tamanho, cor, padding, peso da fonte — ganha seu próprio bloco de código txt rotulado. Código inline em prosa não é suficiente. A especificação é um artefato de copiar e colar, não um ensaio.

Pilha tecnológica padrão

  • Next.js 16.2 (App Router + Turbopack) + React 19 + TypeScript
  • Tailwind CSS (config em tailwind.config.ts)
  • shadcn/ui primitivos quando útil
  • Framer Motion (motion/react)
  • lucide-react para ícones
  • Ativos estáticos em /public/images/ e /public/icons/
  • Variáveis CSS no formato HSL (convenção shadcn: 0 0% 100% bruto, sem wrapper hsl() dentro da variável)

Nota sobre adaptação dos padrões ouro. Os dois exemplos de padrão ouro têm como alvo React + Vite. Este skill gera Next.js 16 App Router. As regras de conversão são simples, mas devem ser aplicadas consistentemente:

  • index.css → app/globals.css
  • Caminhos de ativos referenciam /public/... a partir de <Image> ou <img> como URLs relativas à raiz (/images/foo.png)
  • Componentes que usam Framer Motion, hooks do React (useState, useEffect, useScroll, useInView), manipuladores de eventos, controles de <video> ou APIs do navegador (hls.js) devem declarar 'use client' no topo
  • Componentes de layout puro / conteúdo estático permanecem como Server Components (sem 'use client')
  • A estrutura da página mostra a árvore de arquivos do App Router (app/layout.tsx, app/page.tsx, app/globals.css, app/components/...)
  • Use next/image para imagens estáticas com dimensões conhecidas; use <img> bruto para GIFs, conteúdo dinâmico ou animado

Todo o resto (utilitários CSS, famílias glass, helper fadeUp, padrões de animação, backgrounds em camadas, truque de borda fina) é transferido de forma idêntica.

Fluxo de trabalho

Quando o skill for acionado, execute estas etapas em ordem. Não pule etapas.

Etapa 1 — Leia as referências e um padrão ouro

Antes de escrever qualquer coisa, carregue:

  1. references/section-templates.md — o template de 21 seções com função, regras de conteúdo e formato para cada seção
  2. references/idiom-library.md — trechos CSS canônicos (família glass, borda fina, backgrounds em camadas, fadeUp, movimento flutuante)
  3. references/writing-patterns.md — padrão de bloco de código rotulado, hedging em ambiguidade, formato de antipadrões
  4. Um padrão ouro como referência concreta para extensão, densidade e tom:
    • Se a imagem de entrada for escura/cinemática/estilo agência → assets/gold-standard-agentai.md
    • Se a entrada for produto/SaaS/fintech/pagamentos → assets/gold-standard-kraken.md
    • Se não tiver certeza → assets/gold-standard-kraken.md (cobertura de seção mais diversa)

Estes arquivos são grandes. Leia-os uma vez no início; não os releia no meio da geração.

Etapa 2 — Analise a imagem

Antes de escrever, faça um inventário interno:

  • Classificação em três eixos (tipo de interface, direção de arte, registro de humor) — veja a seção "Pré-escrita" em references/section-templates.md para o vocabulário completo de rótulos. A classificação orienta a predefinição de fonte, a direção dos tokens de design e a lista de abertura "deve parecer com".
  • Nome da marca e logotipo (visível na navegação)
  • Metáfora visual que define a página (Kraken: pingentes de criptomoeda pendurados. AgentAI: água-viva bioluminescente vermelha. Sempre tente nomear a alma visual da página em uma frase.)
  • Lista de seções de cima para baixo (navbar, hero, prova, faixa de logotipos, serviços, etc.)
  • Paleta de cores — fundo primário, cor(es) de destaque, superfície do cartão
  • Par de tipografia — sem serifa display para títulos, sem serifa body para texto, serifa opcional para acentos itálicos
  • Todo o texto visível — extraído literalmente, incluindo erros de digitação e repetições
  • Tratamentos glass / desfoque / ruído / granulação
  • Pistas de animação — qualquer coisa que implique movimento (elementos flutuantes, brilhos de auréola, affordances de hover)

Se algo estiver parcialmente oculto ou ilegível, planeje sinalizá-lo na especificação com linguagem de hedging ("…com seus clientes" — estenda se o usuário quiser uma frase completa, caso contrário, mantenha literalmente).

Etapa 3 — Escreva a especificação em um arquivo

Produza a especificação como um único arquivo Markdown em /mnt/user-data/outputs/<slug>-spec.md, onde <slug> é kebab-case derivado da marca visível na imagem (ex.: kraken-spec.md, agentai-spec.md, bloom-spec.md. Recorra a ui-rebuild-spec.md apenas se nenhuma marca for identificável.

O arquivo segue o template fixo de 21 seções de references/section-templates.md. Alvo de extensão: 800–1300 linhas. Menos de 800 significa que você pulou granularidade; mais de 1300 significa que você preencheu com redundância.

Etapa 4 — Apresente o arquivo e responda de forma concisa no chat

Chame present_files com o caminho da especificação. A resposta no chat é de no máximo 3–6 linhas:

  • Quais seções foram cobertas (ou quais foram marcadas como "Não visível nesta captura de tela")
  • Qualquer incerteza ou suposição sinalizada na especificação
  • Qualquer decisão explícita que o reconstrutor precisará tomar (ex.: preservação de erro de digitação, logotipos repetidos)

Não duplique a especificação no chat. Não a resuma. O arquivo é a entrega.

Regras rígidas de fidelidade

Estas são inegociáveis. Elas substituem conveniência, brevidade e educação.

Texto literal. Cada palavra visível na imagem — títulos, botões, rótulos, rodapé, microtexto — aparece na especificação exatamente como escrito, no idioma original, incluindo erros de digitação, peculiaridades de pontuação e conteúdo repetido. Quando um erro de digitação for preservado, ofereça opcionalmente ao reconstrutor a escolha ("Use Why Karken apenas se estiver reproduzindo a captura de tela exata; caso contrário, use Why Kraken").

Antipadrões explícitos. A seção VISUAL DETAILS TO MATCH sempre inclui uma lista de antipadrões: o que evitar, o que NÃO fazer, direções de cores para pular. Exemplo: "Evite azul, verde, laranja ou gradientes multicoloridos. Mantenha a paleta estritamente limitada a preto, roxo, lavanda, branco e cinza. Não o torne cartunesco."

Sem invenção. Não adicione seções, recursos, prova social, depoimentos ou qualquer conteúdo não visível na imagem. Se a imagem terminar no meio de uma seção (cortada na parte inferior), descreva apenas o que está visível e observe o truncamento.

Hedging no ilegível. Quando o texto for cortado, parcialmente oculto ou genuinamente ambíguo, não o fabrique. Marque-o: "este cartão está parcialmente cortado na parte inferior da captura de tela; o corpo mostrado é o que está visível — estenda naturalmente com '…' se o usuário quiser uma frase completa, caso contrário, mantenha literalmente."

Backgrounds em camadas decompostos. Cada background complexo é dividido em N camadas absolutas explícitas (cor base, gradientes radiais, sobreposição de ruído, vinheta, etc.) com sua ordem de empilhamento. Não agregue ("dotted-grid + violet-glow + pixel-floor"); liste cada camada com seu próprio trecho.

Nomeação da família glass. Não imponha um nome único como "liquid-glass". Nomeie os utilitários glass pelo seu uso na imagem: .glass-nav, .glass-card, .glass-card-soft, .glass-pill, .glass-panel. A imagem orienta a nomeação.

Namespace de cores da marca. Quando o design tiver uma paleta de marca forte, crie namespace para a extensão do Tailwind: colors: { kraken: { black, panel, purple, ... } } ou colors: { redai: { DEFAULT, dark, soft } }. Isso faz a especificação parecer intencional em vez de genérica.

Box-shadow como tokens nomeados. Defina boxShadow: { 'red-glow': '...', 'glass': '...' } na configuração do Tailwind em vez de strings shadow-[...] inline em todos os lugares. Em seguida, referencie como shadow-red-glow.

Quando consultar os padrões ouro no meio da geração

Se você estiver prestes a escrever uma seção e não tiver certeza de quão densa, granular ou formatada ela deve ser — pare e releia a seção equivalente no padrão ouro correspondente. O ouro define a referência. Exemplos:

  • Prestes a escrever a seção HERO, mas não sabe quantas subseções (2a, 2b, 2c)? Veja como o padrão ouro correspondente estrutura seu hero.
  • Prestes a escrever SPACING AND LAYOUT DETAILS, mas não sabe quais chaves pertencem ao JSON? Copie a estrutura do ouro e adapte os valores à sua imagem.
  • Prestes a escrever VISUAL DETAILS TO MATCH, mas só tem 5 itens? Os ouros têm 15-25. Encontre mais.

Os ouros são a ferramenta de calibração. Use-os.

Lista de verificação de formato antes da entrega

Antes de chamar present_files, verifique o rascunho uma vez:

  • [] Extensão entre 800–1300 linhas (mais curto = subespecificado; mais longo = preenchido)
  • [] Abre com uma frase "Construa um..." informando a pilha tecnológica e a estética central
  • [] Todas as 21 seções presentes em ordem, mesmo que algumas digam "Não visível nesta captura de tela"
  • [] Metáfora visual mencionada na abertura ou em GLOBAL PAGE DIRECTION
  • [] Pilha tecnológica adaptada para Next.js 16 App Router (não Vite)
  • [] Lembretes de 'use client' em componentes animados/interativos
  • [] Todo o texto visível extraído literalmente, no idioma original
  • [] Acentos itálicos com serifa em títulos detectados e destacados
  • [] Utilitários CSS nomeados após seu uso, não após um genérico "liquid-glass"
  • [] Namespace de cores da marca na configuração do Tailwind
  • [] Tokens nomeados de box-shadow na configuração do Tailwind
  • [] Backgrounds decompostos em N camadas absolutas (não agregados)
  • [] Cada propriedade visual em seu próprio bloco de código txt rotulado (Style:, Position:, Implementation:)
  • [] EXACT VISUAL HIERARCHY classifica os elementos por peso visual (lista numerada)
  • [] SPACING AND LAYOUT DETAILS inclui um bloco JSON com geometria de pixels
  • [] VISUAL DETAILS TO MATCH inclui antipadrões ("Evite X, não faça Y")
  • [] COPYWRITING CONTENT reagrupa todo o texto em um bloco escaneável
  • [] Hedging aplicado a qualquer conteúdo cortado, ambíguo ou ilegível
  • [] Sem críticas, sem sugestões de melhoria, sem preâmbulo
  • [] Especificação escrita em /mnt/user-data/outputs/<slug>-spec.md
  • [] Resposta no chat com no máximo 3–6 linhas

Habilidades Relacionadas