Communitygithub.com

dirección-de-arte-web

Muestra a un agente cómo dirigir y construir una «dirección de arte web» para que el resultado concreto sea un logotipo y una pequeña hoja de marca. El procedimiento avanza a través de Dirección de arte web, Herramientas, Proceso. Úsalo cuando un nuevo encargo requiera este oficio.

¿Qué es dirección-de-arte-web?

Esta habilidad capacita al agente para ejercer dirección de arte en proyectos web, produciendo un logotipo y una hoja de marca reducida. Se enfoca en componer la identidad visual del sitio: concepto, primera pantalla, ritmo de secciones, tipografía, color, imágenes y texto; luego ejecuta un bucle de crítica hasta que el resultado esté listo para enviar. Funciona con el servidor MCP `design-refs` (usa `refs_api` y `refs_run`) y puede leer referencias locales si se configura `DESIGN_REFS_DIR`. El proceso guía al agente desde la recopilación del brief y la consulta de lecciones pasadas, pasando por la selección de referencias (tres A del tema, dos A aleatorias de otras categorías y dos C a evitar), hasta la redacción de un contrato de dirección de arte con tesis, movimientos para la primera pantalla y secciones, y estrategias de tipo, color e imágenes. Luego construye la página usando fuentes e imágenes reales, la captura con una herramienta de screenshot, y entra en un bucle de crítica con un agente crítico especializado que devuelve `rebuild`, `fix` o `ship`; se repite hasta un máximo de tres rondas. Finalmente informa al usuario la tesis, el veredicto, las lecciones aprendidas y los placeholders que requieren contenido auténtico.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TFFy1/web-art-direction/tree/HEAD/skills/web-art-direction

Preguntar en tu IA favorita

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

Documentación

Dirección de arte web

Los componentes deciden si una página funciona. La composición decide si alguien la recuerda. Esta habilidad gestiona la composición: concepto, primera pantalla, ritmo de secciones, tipo, color, imágenes y texto. Luego un crítico revisa el resultado hasta que se envía.

Herramientas

El servidor MCP design-refs expone refs_api y refs_run (modo código). Llama a refs_api una vez por sesión para cargar la API. Si esas herramientas faltan, dile al usuario que el servidor design-refs no está conectado y dirígelo al README del plugin. Si DESIGN_REFS_DIR está definido, lee refs/index.json, lessons.json y las imágenes de esa carpeta en su lugar.

Carga estos archivos solo cuando llegue su paso:

Proceso

1. Brief

Averigua para quién es la página, qué deben creer, la única acción y qué activos reales existen (logotipo, fotos, producto, texto, precios). Si falta alguno y no se puede inferir, pregunta una vez, con un máximo de tres preguntas. Nunca inventes clientes, logotipos, reseñas, precios ni estadísticas. Usa placeholders marcados y enuméralos al final.

2. Memoria

Ejecuta lessons.list() y lee cada lección. Provienen de críticas pasadas y son vinculantes a menos que el brief anule una. Nombra las lecciones que aplican a esta página.

3. Referencias

En una llamada refs_run:

  • tres referencias de nivel A de la categoría de la página,
  • dos referencias de nivel A elegidas al azar (Math.random) de otras categorías. Son desafiantes contra el valor predeterminado de la categoría,
  • dos referencias de nivel C de la categoría, como lo que evitar.

Mira sus primeras pantallas. Mide la más relevante en vivo con refs.measure(url). Para cada una, escribe una línea sobre lo que tomas de ella: una decisión, no un diseño. Si el usuario nombra sitios que le gustan, captúralos primero con refs.capture() y etiquétalos.

4. Dirección

Lee moves.md. Escribe:

  • La rutina: la página que esta categoría siempre envía y la versión anti-slop de ella (p. ej., fondo crema + serifa + terracota). Ambas están prohibidas a menos que el brief las fije.
  • Tesis: una oración que nombre la única idea que esta página posee.
  • Primera pantalla: un movimiento de primera pantalla y exactamente qué va dónde, a qué escala.
  • Secciones: de cuatro a seis movimientos de sección en orden, con el ritmo (denso o tranquilo, contenedor, escala) de cada una.
  • Tipo, color, imágenes: un movimiento de tipo, una estrategia de color con valores hex y el plan de imágenes con fuentes reales.

Pon este contrato en un comentario HTML al inicio de la página. Si alguna línea suena a estado de ánimo en lugar de una decisión, aún no está decidida.

5. Construcción

Lee page.md y slop.md, luego construye el contrato con compromiso total: fuentes reales, imágenes reales (verifica que cada URL cargue), texto real. Usa la habilidad ui-libraries-no-ai-look para componentes interactivos. Arregla el héroe primero, luego todo lo que está debajo.

6. Captura

node <this-skill-dir>/scripts/shoot.mjs <page.html-or-url> <out-dir>

Esto escribe desktop.jpg, slices de escritorio, mobile.jpg, mobile-full.jpg y report.json con indicios mecánicos (cejas, texto degradado, degradados morados, filas de tarjetas iguales, frases hechas, h1 tímido, imágenes rotas, desbordamiento). Arregla cada indicio que el brief no justifique antes de la crítica.

7. Bucle de crítica

Genera al crítico con un contexto nuevo, nunca una bifurcación de esta conversación:

  • si el tipo de agente web-art-director está disponible (viene con este plugin), úsalo;
  • de lo contrario, genera un agente de propósito general cuyo prompt comience con el texto completo de agents/web-art-director.md de este plugin.

Envíale estas entradas:

  • el brief y las respuestas del usuario,
  • el contrato,
  • la ruta de la página,
  • la carpeta de capturas y report.json,
  • los ids de referencia del paso 3.

Devuelve rebuild, fix o ship, con arreglos ordenados, y registra lecciones él mismo a través de lessons.add.

  • rebuild: vuelve al paso 4 para las regiones nombradas.
  • fix: aplica cada arreglo en un lote, vuelve a capturar y envía las nuevas capturas al mismo crítico (continúa, no generes uno nuevo) para un veredicto.
  • Repite hasta ship, como máximo tres rondas. Si la ronda tres aún no es ship, muestra al usuario los elementos abiertos y deja que decida.

Informa el veredicto del crítico exactamente como lo escribió, nunca una versión más suave.

8. Cierre

Dile al usuario:

  • la tesis,
  • el veredicto final,
  • las lecciones que se agregaron o reforzaron,
  • qué placeholders necesitan contenido real.

Paneles y UI de aplicación

La usabilidad supera a la expresión aquí. Usa movimientos solo para la identidad del shell (tipo, color, un detalle de firma). Deja que ui-libraries-no-ai-look impulse los componentes y aún así ejecuta los pasos 2, 6 y 7.

Skills relacionados