Communitygithub.com

craft-ui

Habilidad de diseño. Crea diseños a partir de referencias, capturando el estilo y la estructura de imágenes, enlaces o descripciones, solo después de entender el producto y la solicitud.

¿Qué es craft-ui?

Craft UI es una habilidad especializada para agentes de IA (como Claude Code, Cursor o Codex) que se centra en crear interfaces de usuario de alta calidad basadas en evidencias reales, evitando el 'slop' de IA (diseños genéricos y sin sustancia). A diferencia de otros enfoques, esta habilidad impone una barrera estricta: ningún código se escribe hasta que se genera un 'Contrato de Diseño'. Este contrato es el resultado de la fusión de tres agentes de descubrimiento que trabajan en paralelo para analizar el sitio en producción, la solicitud del usuario y las referencias proporcionadas, así como para enrutar las habilidades auxiliares necesarias. El flujo de trabajo asegura que cada decisión visual y estructural se justifique con evidencia, priorizando contenido real sobre marcadores de posición, y promoviendo la creación de layouts responsivos con animaciones memorables y un alto estándar profesional. La habilidad también incluye un robusto proceso de verificación visual y protocolos para pulir sitios existentes, lo que la convierte en una herramienta ideal para desarrolladores que buscan una calidad de diseño profesional, consistente y basada en datos.

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

Preguntar en tu IA favorita

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

Documentación

Craft UI

Referencia visual, layout funcional — pero solo después de entender el producto y la solicitud.

El fallo que esta habilidad busca prevenir: una página de apariencia plausible hecha de secciones aleatorias, texto de relleno, degradados por defecto y bandas vacías. Ocurre cuando un agente diseña a partir de hábitos de género en lugar de evidencia. Aquí, cada decisión estructural y visual debe rastrearse hasta una de tres fuentes: el producto real, la solicitud del usuario o una referencia realmente vista. Si falta una fuente, recopílala o pídela. Nunca llenes el vacío con un valor por defecto.

Reglas innegociables

  1. Sin código antes del Contrato de Diseño (paso 2). Sin excepción para páginas "rápidas": discovery: lite acorta el contrato, no lo elimina. La economía la maneja el enrutador, no saltando el contexto.
  2. Evidencia sobre valores por defecto. Cada token, sección y línea de texto cita de dónde proviene. "Típico para páginas de aterrizaje" no es una fuente.
  3. La estructura es una columna vertebral, no un bufé. Las secciones existen solo si responden a una pregunta del visitante o a un objetivo de la solicitud. Consulta references/anti-ai-slop.md.
  4. Contenido real. El nombre del producto, etiquetas, datos e idioma provienen del sitio/solicitud. Sin lorem ipsum, sin logos falsos, sin métricas inventadas, sin "Tu producto aquí" a menos que el usuario haya aprobado un marcador de posición.
  5. Responde en el idioma del usuario y construye la UI en el idioma del producto (un producto en pt-BR recibe texto en pt-BR).
  6. Una animación memorable, no un fade-up en cada sección.
  7. Tokens antes que componentes. Los colores, radios, tipografía, espaciado, sombras y easing viven en variables CSS; los componentes solo leen esas variables.
  8. La economía es una decisión. El enrutador establece la verbosidad y qué habilidades se ejecutan. Lee solo las secciones de referencia que apliquen.
  9. Estándar de calidad profesional. references/quality-bar.md es la definición de completado: contenido, fidelidad visual, responsive, WCAG AA, rendimiento y entrega. terse lo verifica en silencio; nunca se omite.

Flujo de trabajo

0. Triaje (agente principal, segundos)

  • Captura la solicitud del usuario textualmente; anota cualquier URL, archivo adjunto, restricción "no quiero" y pistas de verbosidad ("solo el código", "rápido", "explícame").
  • Verifica qué está disponible: herramienta de subagente/Task, navegador o fetch web, repositorio local, lista de habilidades/MCP.
  • Si la solicitud es un pequeño ajuste a un archivo existente (un color, un valor de espaciado), indícalo al enrutador — puede que establezca discovery: lite. Una página nueva o un rediseño siempre obtienen discovery: full.
  • Si el usuario dice que el layout existente es "amateur", "necesita mejorar", "arregla esta landing page" o señala un sitio en vivo con código, lee references/polish-existing-site.md y sigue esa ruta: pulido aditivo del código base real, no una reconstrucción. Ejecuta git status antes de tocar archivos.

1. Tres agentes de descubrimiento (ejecutar en paralelo)

Usa tu herramienta de subagente — OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor background agent. Si no hay herramienta de subagente, ejecuta las tres pasadas secuencialmente en el agente principal y etiqueta cada una con su encabezado. Los agentes de descubrimiento no escriben código.

AgenteMisiónAlimenta el contrato con
A — Analista del sitio en producciónEntender el sitio tal como existe en producción: producto, audiencia, texto real, estructura actual, tokens de marca, restricciones.BRIEF DE CONTEXTO DEL SITIO
B — Analista de solicitud y referenciasDecodificar la solicitud real y extraer ADN de estilo solo de referencias realmente vistas; buscar referencias cuando no se haya dado ninguna.BRIEF DE SOLICITUD + ADN DE ESTILO
C — Enrutador de habilidades / economíaElegir el conjunto mínimo de habilidades/herramientas extra para esta ejecución y establecer la verbosidad.DECISIÓN DE ENRUTAMIENTO

Especificaciones completas, esquemas de salida y presupuestos de palabras: references/agents.md. Pasa a cada agente la ruta raíz absoluta de la habilidad, su especificación de rol, la solicitud sin procesar del usuario y las URLs/archivos adjuntos. Limita las respuestas a sus presupuestos de palabras.

Cuando una imagen de referencia esté involucrada, lee también references/pattern-transfer.md. Los tokens de estilo viajan; las recetas de composición no. Nunca adoptes un patrón de héroe o sección solo de la referencia — debe estar justificado por el producto (A) y la solicitud (B).

2. Contrato de Diseño — puerta estricta

Lee references/design-contract.md. Fusiona A + B + C en un solo contrato. Luego verifica:

  • La columna vertebral de la estructura está ordenada; cada sección tiene un trabajo, una fuente, una topología copiada literalmente de la referencia y contenido real; no hay bandas vacías.
  • Cada token y línea de texto cita una fuente; los valores desconocidos están marcados, no inventados.
  • Los conflictos entre agentes/sitio/referencia se resolvieron preguntando al usuario una pregunta consolidada (máx. 3 elementos), no adivinando.
  • La verbosidad y la lista de habilidades provienen de C; ninguna habilidad se ejecuta "solo porque existe".
  • Existe un registro de adopción de patrones: cada adoptar/adaptar/descartar cita A y B; ninguna receta de héroe/sección provino solo de la referencia (ver references/pattern-transfer.md).
  • La composición no sería plausible para un producto no relacionado en un campo diferente. Los tokens son portátiles; la receta del héroe no lo es.

Los subagentes de descubrimiento nunca preguntan al usuario — solo informan Brechas / Desconocidos. El agente principal recopila los tres briefs, hace una pregunta consolidada (máx. 3 elementos) y mantiene la puerta cerrada hasta que se responda. Si un hecho material sigue siendo desconocido (nombre del producto, audiencia, contenido real, imagen de referencia), pregunta y detente. No comiences el paso 3.

3. Planificar

Plan compacto: tokens, wireframe ASCII de la columna vertebral, banco de texto/datos real y el momento de la animación única con su disparador y motivo. Compara con la referencia y el brief del sitio; cualquier cosa que sea un valor por defecto en lugar de algo observado se revisa o descarta.

4. Construir

  • Un solo archivo HTML autónomo por defecto (variables CSS como tokens, Google Fonts con fallbacks reales). Usa el React/Tailwind existente del proyecto solo si el proyecto del usuario ya lo usa.
  • Recetas de animación: references/motion-and-effects.md. GSAP desde una versión fija de cdnjs.
  • Mantén el código limpio: sin bibliotecas ni abstracciones que el layout no necesite.
  • Responsive en 1440 / 768 / 390, estados de foco visibles, respeta prefers-reduced-motion.
  • Vuelve a leer references/anti-ai-slop.md mientras construyes — especialmente las filas de bandas vacías y bufé de secciones.

5. Verificar visualmente

Renderiza y compara lado a lado con la referencia y el brief del sitio. Usa una herramienta de navegador cuando esté disponible (enrutada por C). Ejecuta el protocolo de verificación en references/quality-bar.md: capturas de pantalla de página completa en 1440 / 768 / 390, orden de secciones y presencia de contenido, sin bandas vacías ni texto recortado, sin desplazamiento horizontal, contraste de píxeles reales, foco de teclado, movimiento reducido y errores de consola. Verifica jerarquía, ritmo de espaciado, consistencia de radio/sombra, densidad e idioma. Rondas de corrección: 1 cuando la verbosidad es terse, hasta 3 cuando es full; corrige la diferencia visual más grande primero y detente cuando la lista de verificación pase.

6. Responder

Formato según la verbosidad de C. terse: 3–5 líneas — qué se construyó, evidencia utilizada, resultado de la verificación. full: también lista qué rasgos de referencia se tomaron de dónde, habilidades utilizadas/omitidas y un cambio sugerido a continuación. Sigue los criterios de entrega en references/quality-bar.md, indica las limitaciones conocidas una vez y escribe siempre en el idioma del usuario.

Uso de otras habilidades

El agente C decide esto por ejecución; primero verifica qué está realmente disponible en la sesión. Habilidad faltante → usa el plan de contingencia y menciónalo una vez al final.

FaseSi C dice usarPlan de contingencia
Planificar / dirección de diseñoImpeccable (/impeccable shape, luego craft); ejecuta su paso de contexto una vez por sesiónfrontend-design, o el plan del paso 3
Revisar y pulirImpeccable critique, polish, auditAuto-revisión contra el contrato
Calidad de animaciónemil-design-eng para easing, duración, springs, hover/pressreferences/motion-and-effects.md
Verificación visualBrowser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome): captura de pantalla en 3 anchos, verifica consolaDescribe las verificaciones y pide al usuario una captura de pantalla
Logo u objeto 3Dimg2threejs solo si la referencia contiene un objeto 3D que valga la pena reconstruir; indica su límite: una imagen no puede revelar lados ocultosSVG plano o CSS
Mantener código pequeñoponytail antes de agregar cualquier dependenciaCSS simple + una línea de tiempo de GSAP

Solo llama a una habilidad cuando su fase aplique. Una página de aterrizaje estática no necesita img2threejs.

Originalidad y seguridad

  • Recrea patrones, no activos. Nunca reutilices el logotipo, ilustraciones, nombre de marca o texto exacto de una referencia. Usa la marca del usuario y el contenido real de A/B.
  • Muchos pins enlazan a kits de UI comerciales. Iguala solo estilo y estructura.
  • La apariencia de una referencia es un punto de partida. Si perjudica la usabilidad (bajo contraste, texto pequeño), mantén el estado de ánimo, corrige el problema y dilo.

Archivos

  • references/agents.md — los tres agentes de descubrimiento, esquemas y presupuestos.
  • references/design-contract.md — plantilla de fusión y puerta estricta.
  • references/anti-ai-slop.md — síntomas y correcciones para layouts genéricos, apilados y vacíos.
  • references/quality-bar.md — definición profesional de completado y protocolo de verificación.
  • references/pattern-transfer.md — evita que las imágenes de referencia trasplanten la misma receta de héroe a productos no relacionados.
  • references/polish-existing-site.md — flujo de trabajo aditivo cuando la tarea es elevar un layout de producción existente.
  • references/categories.md — líneas base de género (viabilidad mínima, no menús de secciones).
  • references/style-dna.md — plantilla de lectura de referencias; requiere evidencia.
  • references/motion-and-effects.md — efectos CSS y recetas de GSAP.
  • assets/refs.json — enlaces de referencia conocidos (aún requieren visualización).

Skills relacionados