CommunityImagengithub.com

hyliox-pixel-perfect

Traduce una captura de pantalla de UI (página de aterrizaje, pantalla de app, dashboard, maqueta) en una especificación de reconstrucción fiel a píxeles, lista para agentes de codificación de IA (Cursor, v0.dev, Lovable, Codex, Claude Code) orientada a Next.js 16 App Router + Tailwind + shadcn/ui + Framer Motion. La salida es una especificación larga en Markdown (~1000 líneas) con una plantilla fija de 21 secciones.

¿Qué es hyliox-pixel-perfect?

Este skill transforma capturas de pantalla de interfaces de usuario en especificaciones técnicas detalladas y prescriptivas para agentes de codificación de IA como Cursor, v0.dev, Lovable, Codex y Claude Code. Está optimizado para Next.js 16 App Router, Tailwind CSS, shadcn/ui y Framer Motion, y genera un documento Markdown de aproximadamente 1000 líneas que sigue una plantilla fija de 21 secciones. Cada sección cubre un aspecto crucial del desarrollo: stack tecnológico, tokens de diseño, configuración de Tailwind, animaciones, jerarquía visual, estructura de página y más. El skill prioriza la fidelidad absoluta sobre la interpretación: extrae cada palabra visible de la imagen, descompone fondos complejos en capas explícitas y nombra los tokens de sombra y color según el contexto de la marca. Es ideal para desarrolladores que necesitan reconstruir diseños pixel a pixel sin perder tiempo en interpretaciones subjetivas.

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

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Hyliox Pixel Perfect

Traduce capturas de pantalla de UI en especificaciones de construcción largas, densas y prescriptivas para agentes de frontend. Optimizado para máxima fidelidad, no para brevedad.

Filosofía

Este skill produce una especificación fija de 21 secciones, de aproximadamente 1000 líneas de extensión, lista para copiar y pegar en Cursor / v0 / Lovable / Codex / Claude Code. Es prescriptiva, no adaptativa: las mismas 21 secciones aparecen en cada salida, en el mismo orden. Si una sección no tiene contenido para una imagen determinada (por ejemplo, sin animaciones visibles), se indica explícitamente "No visible en esta captura de pantalla — implementar como estático" en lugar de omitirla. La estructura predecible es mejor que la inteligencia variable.

El skill se ha obtenido mediante ingeniería inversa de dos salidas de referencia de oro (assets/gold-standard-kraken.md y assets/gold-standard-agentai.md). En caso de duda sobre el formato, la extensión o la granularidad, lea primero las referencias de oro. Son la verdad fundamental.

Fidelidad sobre interpretación. Describa lo que está en la imagen. No invente secciones, texto, características o mejoras. Si la imagen muestra tres tarjetas de características, describa tres. Si un logotipo se repite en la fila de marcas, repítalo. Si hay un error tipográfico en la navegación ("Why Karken" en lugar de "Why Kraken"), consérvelo (y ofrezca al reconstrictor la opción de corregirlo).

Granularidad sobre prosa. Cada propiedad visual (posición, tamaño, color, relleno, peso de fuente) tiene su propio bloque de código txt etiquetado. El código en línea dentro de la prosa no es suficiente. La especificación es un artefacto para copiar y pegar, no un ensayo.

Stack tecnológico predeterminado

  • Next.js 16.2 (App Router + Turbopack) + React 19 + TypeScript
  • Tailwind CSS (configuración en tailwind.config.ts)
  • shadcn/ui primitivos cuando sea útil
  • Framer Motion (motion/react)
  • lucide-react para iconos
  • Activos estáticos en /public/images/ y /public/icons/
  • Variables CSS en formato HSL (convención de shadcn: 0 0% 100% sin procesar, sin envoltorio hsl() dentro de la variable)

Nota sobre la adaptación de las referencias de oro. Los dos ejemplos de referencia de oro están orientados a React + Vite. Este skill genera Next.js 16 App Router en su lugar. Las reglas de conversión son simples pero deben aplicarse de manera consistente:

  • index.css → app/globals.css
  • Las rutas de activos hacen referencia a /public/... desde <Image> o <img> como URL relativas a la raíz (/images/foo.png)
  • Los componentes que usan Framer Motion, hooks de React (useState, useEffect, useScroll, useInView), manejadores de eventos, controles de <video> o APIs del navegador (hls.js) deben declarar 'use client' al principio
  • Los componentes de diseño puro / contenido estático permanecen como Componentes de Servidor (sin 'use client')
  • La estructura de página muestra el árbol de archivos del App Router (app/layout.tsx, app/page.tsx, app/globals.css, app/components/...)
  • Use next/image para imágenes estáticas con dimensiones conocidas; use <img> sin procesar para GIFs, contenido dinámico o animado

Todo lo demás (utilidades CSS, familias de vidrio, helper fadeUp, patrones de animación, fondos en capas, truco de bordes finos) se transfiere de manera idéntica.

Flujo de trabajo

Cuando el skill se active, ejecute estos pasos en orden. No omita pasos.

Paso 1 — Lea las referencias y una referencia de oro

Antes de escribir cualquier cosa, cargue:

  1. references/section-templates.md — la plantilla de 21 secciones con el rol, las reglas de contenido y el formato para cada sección
  2. references/idiom-library.md — fragmentos CSS canónicos (familia de vidrio, borde fino, fondos en capas, fadeUp, movimiento flotante)
  3. references/writing-patterns.md — patrón de bloque de código etiquetado, cobertura sobre ambigüedad, formato de antipatrones
  4. Una referencia de oro como referencia concreta para la extensión, densidad y tono:
    • Si la imagen de entrada es oscura/cinemática/de estilo agencia → assets/gold-standard-agentai.md
    • Si la entrada es producto/SaaS/fintech/pagos → assets/gold-standard-kraken.md
    • Si no está seguro → assets/gold-standard-kraken.md (cobertura de sección más diversa)

Estos archivos son grandes. Léalos una vez al principio; no los vuelva a leer durante la generación.

Paso 2 — Analice la imagen

Antes de escribir, haga un inventario interno:

  • Clasificación en tres ejes (tipo de interfaz, dirección artística, registro de estado de ánimo) — consulte la sección "Pre-escritura" en references/section-templates.md para obtener el vocabulario completo de etiquetas. La clasificación determina el preajuste de fuente, la dirección de los tokens de diseño y la lista de "debería sentirse como" de apertura.
  • Nombre de la marca y logotipo (visible en la navegación)
  • Metáfora visual que define la página (Kraken: colgantes de criptomonedas. AgentAI: medusa bioluminiscente roja. Intente siempre nombrar el alma visual de la página en una oración).
  • Lista de secciones de arriba a abajo (barra de navegación, hero, prueba, fila de logotipos, servicios, etc.)
  • Paleta de colores — color de fondo principal, color(es) de acento, superficie de tarjeta
  • Combinación tipográfica — sans-serif para titulares, sans-serif para cuerpo, serif opcional para acentos en cursiva
  • Todo el texto visible — extraído textualmente, incluidos errores tipográficos y repeticiones
  • Tratamientos de vidrio / desenfoque / ruido / grano
  • Indicios de animación — cualquier cosa que implique movimiento (elementos flotantes, resplandores de halo, indicios de hover)

Si algo está parcialmente oscurecido o es ilegible, planee marcarlo en la especificación con lenguaje de cobertura ("...con sus clientes" — extienda si el usuario quiere una oración completa, de lo contrario mantenga textual).

Paso 3 — Escriba la especificación en un archivo

Produzca la especificación como un solo archivo Markdown en /mnt/user-data/outputs/<slug>-spec.md, donde <slug> es kebab-case derivado de la marca visible en la imagen (por ejemplo, kraken-spec.md, agentai-spec.md, bloom-spec.md). Use ui-rebuild-spec.md solo si no se puede identificar ninguna marca.

El archivo sigue la plantilla fija de 21 secciones de references/section-templates.md. Objetivo de extensión: 800–1300 líneas. Menos de 800 significa que omitió granularidad; más de 1300 significa que añadió redundancia.

Paso 4 — Presente el archivo y responda de manera concisa en el chat

Llame a present_files con la ruta de la especificación. La respuesta en el chat tiene un máximo de 3 a 6 líneas:

  • Qué secciones se cubrieron (o cuáles se marcaron como "No visible en esta captura de pantalla")
  • Cualquier incertidumbre o suposición marcada en la especificación
  • Cualquier decisión explícita que el reconstrictor deba tomar (por ejemplo, conservación de errores tipográficos, logotipos repetidos)

No duplique la especificación en el chat. No la resuma. El archivo es el entregable.

Reglas estrictas de fidelidad

Estas no son negociables. Anulan la conveniencia, la brevedad y la cortesía.

Texto textual. Cada palabra visible en la imagen (titulares, botones, etiquetas, pie de página, microtexto) aparece en la especificación exactamente como está escrita, en el idioma original, incluidos errores tipográficos, peculiaridades de puntuación y contenido repetido. Cuando se conserva un error tipográfico, ofrezca opcionalmente al reconstrictor la opción ("Use Why Karken solo si reproduce exactamente la captura de pantalla visible; de lo contrario, use Why Kraken").

Antipatrones explícitos. La sección VISUAL DETAILS TO MATCH siempre incluye una lista de antipatrones: qué evitar, qué NO hacer, direcciones de color a omitir. Ejemplo: "Evite azul, verde, naranja o gradientes multicolor. Mantenga la paleta estrictamente limitada a negro, púrpura, lavanda, blanco y gris. No lo haga caricaturesco."

Sin invención. No añada secciones, características, prueba social, testimonios ni ningún contenido no visible en la imagen. Si la imagen termina a mitad de una sección (recortada en la parte inferior), describa solo lo que es visible y note el truncamiento.

Cobertura sobre lo ilegible. Cuando el texto está cortado, parcialmente oscurecido o genuinamente ambiguo, no lo fabrique. Márquelo: "esta tarjeta está parcialmente cortada en la parte inferior de la captura de pantalla; el cuerpo mostrado es lo que está visible — extienda naturalmente con '...' si el usuario quiere una oración completa, de lo contrario mantenga textual."

Fondos en capas descompuestos. Cada fondo complejo se divide en N capas absolutas explícitas (color base, gradientes radiales, superposición de ruido, viñeta, etc.) con su orden de apilamiento. No agregue ("cuadrícula de puntos + resplandor violeta + piso de píxeles"); enumere cada capa con su propio fragmento.

Nomenclatura de familia de vidrio. No imponga un solo nombre como "vidrio-líquido". Nombre las utilidades de vidrio según su uso en la imagen: .glass-nav, .glass-card, .glass-card-soft, .glass-pill, .glass-panel. La imagen guía la nomenclatura.

Espacio de nombres de color de marca. Cuando el diseño tenga una paleta de marca fuerte, asigne un espacio de nombres a la extensión de Tailwind: colors: { kraken: { black, panel, purple, ... } } o colors: { redai: { DEFAULT, dark, soft } }. Esto hace que la especificación se sienta intencional en lugar de genérica.

Box-shadow como tokens nombrados. Defina boxShadow: { 'red-glow': '...', 'glass': '...' } en la configuración de Tailwind en lugar de cadenas shadow-[...] en línea en todas partes. Luego haga referencia como shadow-red-glow.

Cuándo consultar las referencias de oro durante la generación

Si está a punto de escribir una sección y no está seguro de qué tan densa, granular o formateada debería ser, deténgase y relea la sección equivalente en la referencia de oro correspondiente. La referencia de oro define el estándar. Ejemplos:

  • A punto de escribir la sección HERO pero no sabe cuántas subsecciones (2a, 2b, 2c)? Mire cómo la referencia de oro correspondiente estructura su hero.
  • A punto de escribir SPACING AND LAYOUT DETAILS pero no sabe qué claves pertenecen al JSON? Copie la estructura de la referencia de oro y adapte los valores a su imagen.
  • A punto de escribir VISUAL DETAILS TO MATCH pero solo tiene 5 elementos? Las referencias de oro tienen 15-25. Encuentre más.

Las referencias de oro son la herramienta de calibración. Úselas.

Lista de verificación de formato antes de la entrega

Antes de llamar a present_files, revise el borrador una vez:

  • La extensión es de 800 a 1300 líneas (menos = subespecificado; más = relleno)
  • Comienza con una oración "Construye un..." que indique el stack tecnológico y la estética central
  • Las 21 secciones están presentes en orden, incluso si algunas dicen "No visible en esta captura de pantalla"
  • La metáfora visual se indica en la apertura o en GLOBAL PAGE DIRECTION
  • Stack tecnológico adaptado a Next.js 16 App Router (no Vite)
  • Recordatorios de 'use client' en componentes animados/interactivos
  • Todo el texto visible extraído textualmente, en el idioma original
  • Los acentos en cursiva con serif en los titulares se detectan y se mencionan
  • Las utilidades CSS se nombran según su uso, no según un genérico "vidrio-líquido"
  • Espacio de nombres de color de marca en la configuración de Tailwind
  • Tokens de box-shadow nombrados en la configuración de Tailwind
  • Fondos descompuestos en N capas absolutas (no agregadas)
  • Cada propiedad visual en su propio bloque de código txt etiquetado (Style:, Position:, Implementation:)
  • EXACT VISUAL HIERARCHY clasifica los elementos por peso visual (lista numerada)
  • SPACING AND LAYOUT DETAILS incluye un bloque JSON con geometría de píxeles
  • VISUAL DETAILS TO MATCH incluye antipatrones ("Evite X, no haga Y")
  • COPYWRITING CONTENT reagrupa todo el texto en un bloque escaneable
  • Se aplica cobertura a cualquier contenido recortado, ambiguo o ilegible
  • Sin crítica, sin sugerencias de mejora, sin preámbulo
  • Especificación escrita en /mnt/user-data/outputs/<slug>-spec.md
  • La respuesta en el chat tiene un máximo de 3 a 6 líneas

Skills relacionados