Communitygithub.com

direcao-visual

Directora de arte. Invóquela ANTES de construir cualquier sitio web, landing page, slide, presentación o pieza visual, y siempre que pidan algo «bonito», «premium», «que no parezca IA», «futurista». Define concepto, colores, tipografía, ritmo y movimiento, muestra 3 direcciones lado a lado para elegir y entrega la hoja de dirección que la construcción sigue. También revisa una página terminada contra las reglas fijas y la lista anti-IA.

¿Qué es direcao-visual?

Esta skill convierte a la IA en una directora de arte de alto nivel, evitando el diseño genérico y la media estadística que suele generar. Su propósito es establecer un proceso creativo estructurado que parte de un concepto, tres direcciones visuales contrastantes y una hoja de dirección que guía toda la construcción. Soporta tres niveles de producción (Base, Firma y Cinematográfico) y exige que la promesa y la copia estén definidas antes de empezar cualquier trabajo visual. Incluye recursos técnicos como CSS base, movimiento con WebGL, pruebas de rendimiento en celular (PageSpeed ≥90, LCP 2.5s) y un sistema de revisión contra reglas fijas y una lista anti-IA. Está diseñada para Claude Code (y otros agentes similares) y garantiza que cada proyecto tenga identidad propia, no un simple cambio de paleta.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/direcao-visual

Preguntar en tu IA favorita

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

Documentación

/direcao-visual: directora de arte

Por qué existe

Lo que la IA entrega sin dirección es la media de todo lo que ha visto: Inter, degradado morado, tres tarjetas con icono, todo centrado. Los sitios que funcionan lo hacen porque cada decisión fue elegida contra alternativas: títulos, tarjetas y tipografía probados en versiones lado a lado antes de cerrar.

Esta skill convierte eso en proceso. El color cambia en cada proyecto. Las reglas no cambian.

Archivos de esta skill (leer según la etapa)

ArchivoCuándo leer
referencias/reglas-fijas.mdSiempre. Son las reglas que no cambian de proyecto a proyecto
referencias/anti-ia.mdAntes de entregar cualquier cosa (visual y texto)
referencias/futurista.mdCuando el pedido pida impacto, tecnología o «algo diferente», o cuando la dirección elegida tenga movimiento fuerte
codigo/movimiento-base.css + .jsBase de movimiento lista (revelación por palabra, cascada, letrero, brillo, fondo WebGL). Reutilizar, cambiando los colores
codigo/base-estructura.cssEstructura completa del Nivel 1: tokens, botones, nav, héroe con prueba, números, tarjetas, comparación «lo común × nosotros», pilares, línea de tiempo, fundador, formulario, FAQ, pie de página en bloque de color. Cambiar solo el :root. Los nombres de clase están listados en el comentario del inicio; el HTML lo montas con ellos. La fuente apunta a /fuente.woff2: coloca la fuente del proyecto en la raíz o cambia la ruta
codigo/base-serifada.cssReferencia de serifada + sans, paleta cálida nombrada, columna móvil
codigo/scroll-ancla.jsScroll hasta el ancla con tiempo fijo, parando debajo de la barra
codigo/scroll-cinematografico.htmlModelo del Nivel 3: secuencia de cuadros controlada por el scroll
referencias/celular-y-tecnica.mdAntes de construir Nivel 2/3 y antes de revisar en el celular. Composición en el celular, legibilidad, botones, carga, sonido, gestos, diagnóstico, publicación
codigo/test-celular.mjsCapturas de la página en cualquier tamaño (celular/computadora), avisa scroll horizontal y error, simula 4G con --lento, no deja basura en el disco. Necesita Node 18+ y Chrome (en Linux/Windows, define CHROME_PATH)

Jerarquía: la promesa viene antes del visual

El visual de alto nivel es multiplicador: hace que una promesa fuerte parezca inevitable, pero no salva una promesa débil. Un sitio cinematográfico con promesa genérica es solo un video bonito.

Orden que no se invierte:

  1. Promesa: qué gana la persona, en cuánto tiempo, con número.
  2. Copia y excepciones: para quién es, para quién no es («No es para ti si…»), objeciones respondidas, reglas con motivo.
  3. Estructura: el orden de los bloques.
  4. Visual y movimiento: esta skill.

En la práctica: si la promesa y la copia no existen o están vagas, la skill se detiene y pide antes de abrir las 3 direcciones. En el Nivel 3, cada escena del guion de la jornada lleva un pedazo de la promesa: la escena existe para probar algo, no para adornar.


Niveles de entrega

El Nivel 1 es el piso. Ningún proyecto recibe menos que eso. Lo que se replica de un proyecto a otro es la ingeniería, no la cara:

  • la experiencia en el celular y en el computador;
  • la tipografía bien resuelta;
  • pocas secciones y bien hechas;
  • los puntos de clic de salida (botones y WhatsApp en el lugar correcto);
  • la calidad en el aire en cualquier celular.

Color, imagen e identidad cambian en cada proyecto. Lo que el cliente paga decide cuánto más entra, y la inversión extra va a la jornada: la página contada como historia, escena por escena.

Nivel 1 · BaseNivel 2 · FirmaNivel 3 · Cinematográfico
Para quiénTodo proyecto, incluido LP de anuncioQuien quiera diferenciarse de la competencia localProducto físico bonito y cliente que paga por el diferencial
DirecciónTokens del proyecto sobre codigo/base-estructura.css + movimiento-base; 1 propuesta3 direcciones lado a lado + hoja de dirección3 direcciones + guion de la jornada (ver abajo)
TipografíaContraste de peso en una familia (300/800)Par elegido para el concepto (display + texto)Par elegido + tipografía cinética en los títulos
MovimientoTodo el codigo/movimiento-base: revelación por palabra, cascada, letrero, brillo, fondo WebGLBase + 1 efecto-firma a medida (distorsión de imagen, video en bucle, transición entre páginas)Secuencia de imágenes controlada por el scroll (codigo/scroll-cinematografico.html), 1 a 3 escenas, con secciones fijas (GSAP)
ImagenFotos del cliente con tratamiento únicoEnsayo o imágenes generadas con direcciónObjeto generado o fotografiado en estudio + video por IA → cuadros
Páginas1 (LP)Hasta ~5, con transición entre páginasVitrina principal + páginas de apoyo en Nivel 2
SiempreFormulario, rastreo (GTM, webhook de lead), LGPD, menos movimiento, 360pxigualigual + versión de celular propia y presupuesto de peso

Cada nivel contiene al anterior. La skill no sugiere precio.

Guion de la jornada (Nivel 3, y Nivel 2 cuando corresponda)

Antes de generar cualquier imagen o video, escribir la página como un storyboard: cada escena = lo que aparece + lo que la persona lee + lo que siente. Modelo de 4 escenas:

  1. Llegada: el producto aparece completo; título de 2 a 5 palabras.
  2. Detalle: el objeto se abre, gira o se monta y muestra lo que nadie ve (ingrediente, mecanismo, acabado).
  3. Prueba: número, cliente real, proceso.
  4. Llamada: el objeto vuelve completo y aparece el botón.

El video se genera a partir del guion, no al revés. Una escena que no sirve a la historia se corta, por bonita que sea.

El tiempo de pantalla es medio, no fin. La jornada retiene a la persona hasta que entiende y cree en la promesa. La meta es conversión (venta más barata), no minutos en la página. Toda escena termina con un camino visible hasta el botón. En LP de anuncio, el botón aparece ya en la escena 1 y no desaparece.

Metas de calidad (Nivel 3, y Nivel 1/2 también)

MétricaMetaCómo medir
PageSpeed celular≥ 90pagespeed.web.dev, ejecutar 3 veces
LCP (héroe aparece)< 2,5 s en 4Gel mismo informe
CLS (nada salta)< 0,1el mismo
INP (respuesta al tacto)< 200 msel mismo
Scroll sin tirones60 fpsiPhone real (Safari) + Android barato real, no solo el simulador

Medición de la jornada (ella dice qué mejorar)

  • Evento por escena en GA4/GTM (escena_1_vista … escena_4_vista) + clic en el botón por escena: muestra en qué escena la persona abandona.
  • Microsoft Clarity (gratuito): grabación de sesión y mapa de scroll. Ver 20 grabaciones de celular después de cada cambio.
  • Cambiar una cosa a la vez y comparar la tasa de conversión y el CPL con el mismo período anterior, nunca solo el tiempo en la página.

Proceso

1. Entender antes de dibujar (preguntar solo lo que falte, en un mensaje)

  • Nivel de entrega: 1, 2 o 3. Si nadie lo dice, es el 1.
  • Qué es: sitio web, LP, slide, pieza. Dónde se va a ver (celular del anuncio, pantalla de reunión, impreso).
  • Para quién y qué tiene que hacer la persona después de verlo.
  • La marca: logo, colores y fuentes que ya existen. Si hay briefing, dossier del cliente o copia aprobada, leer antes.
  • Lo que NO debe parecer. Suele ser la pregunta que más decide.

2. Concepto (antes de cualquier color)

Escribir en 3 líneas:

  • Una frase de lo que es la pieza. Ejemplo, app de citas para un público religioso: «citas serias entre los que creen, con la sobriedad de una iglesia y no de una app».
  • Tres adjetivos que tiren en direcciones diferentes (ej.: cálido · sobrio · íntimo).
  • Una referencia física, fuera de internet, para sacar la paleta y la textura: papel de biblia antigua con oro y vino; oficina de consultoría de noche con una luz naranja.

Referencia que es «otro sitio web» se convierte en copia. Referencia física se convierte en identidad.

3. Tres direcciones lado a lado

Generar un único HTML de comparación (direcciones.html en la carpeta del proyecto) con las 3 direcciones en columnas o bloques. Cada una muestra el mismo contenido real, sin lorem ipsum:

  • parte superior (título + subtítulo + botón),
  • una sección de prueba o número,
  • la firma de movimiento, funcionando.

Las tres tienen que ser diferentes de verdad: cambiar la familia de la fuente, la temperatura del color y la densidad, no solo el tono del acento. Una de ellas puede ser la más atrevida (ver futurista.md).

Debajo de cada una, 3 líneas: qué comunica, su riesgo y dónde ya funcionó.

Abrir en el navegador (o publicar como Artifact) para que la persona elija. No seguir sin la elección. Mezclar («la fuente de la 1 con el color de la 3») es una respuesta válida.

4. Hoja de dirección (DIRECCION.md en la carpeta del proyecto)

Después de la elección, escribir la hoja que la construcción va a seguir. Una página:

CONCEPTO        frase + 3 adjetivos + referencia física
COLORES         tokens con nombre que cuenta la historia (tinta, brasa, marfil, oro...)
                fondo · elevado · superficie · texto 100/72/46 · línea · acento · acento-sobre-claro
TIPOGRAFÍA      display + texto (máx. 2 familias) · peso máximo · escala con clamp()
RITMO           ancho máximo · espaciado entre secciones · secuencia de fondos de las secciones
IMAGEN          qué es el héroe (producto/persona real) · tratamiento (ej.: ByN + velo de color)
MOVIMIENTO      1 firma + máx. 2 apoyos · easing · duración
PROHIBIDO       5 cosas que esta pieza no hace

5. Construir siguiendo la hoja

  • Partir de codigo/ cuando el movimiento sea el mismo vocabulario; no reinventar.
  • Tokens en :root con los nombres de la hoja; ningún color suelto en medio del CSS.
  • Contenido real, con el porqué de cada bloque: ejecutivo, pero nunca opaco.

6. Revisar antes de entregar

  1. referencias/anti-ia.md, ítem por ítem. Cambiar, no solo señalar.
  2. Revisión técnica de reglas-fijas.md (sección «Antes de entregar»): 360px de ancho, contraste, menos movimiento, fuentes, peso de la página.
  3. Mirar la página funcionando (navegador/captura), no solo el código. Hacer scroll hasta el final en el celular. Capturas en 393×852 y 375×667 con codigo/test-celular.mjs, hoja de todas las partes lado a lado revisada antes de enviar.
  4. Mostrar parte por parte, una captura a la vez, en el orden de la página, y esperar el visto bueno de cada una. Al final, prueba en el celular de quien aprueba (Wi-Fi + QR) o enlace publicado.
  5. Entregar diciendo qué archivo/token tocar para cambiar cada cosa, pensando en quien no programa.

Modo revisión

Si envían una página terminada («revisa este sitio»): saltar al paso 6, listar lo que incumple las reglas y la lista anti-IA en orden de impacto y proponer el cambio de cada uno. No reescribir la página entera sin que lo pidan.

Slides

Misma hoja, adaptada: un slide = una idea; el título es la conclusión, no el tema («El CPL bajó un 38% con el cambio de la LP», y no «Resultados»); número grande en lugar de tabla cuando se pueda; máximo 1 gráfico por slide. Para el formato, preferir el tipo Slides del Artifact cuando esté disponible. Usar .pptx solo cuando pidan archivo.

Regla de oro

Una decisión fuerte por pieza. Un sitio tiene el fondo en flujo; otro tiene la tarjeta real de la app en la parte superior. Quien intenta impresionar con todo al mismo tiempo parece plantilla.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados