Communitygithub.com

omd-shader-hero

Un héroe de lanzamiento a sangre completa en dos tintas extraídas del DESIGN.md del proyecto: el color base y exactamente un color de marca, como un campo de tramado ordenado (Bayer) que se pliega lentamente (o, con data-shape="ripple", ondula) — un aspecto de impresión/riso, no un gradiente genérico. Dos tintas planas nunca se mezclan, por lo que no hay barro. El texto se asienta sobre un recorte duro de la tinta base, por lo que tanto el titular como el subtítulo superan 4,5:1 por construcción, y un script de verificación lo mide en toda la línea de tiempo. Lee tokens de Core v2 (y frontmatter compatible con Google), se niega a inventar una paleta, incluye un respaldo de póster de semitono CSS, respeta prefers-reduced-motion, ~7 KiB gzip de JS de librería. Úsalo para una página de lanzamiento, héroe de producto, lista de espera, evento o primera pantalla de cambio de marca que necesite movimiento en el color de marca. Disparadores: '셰이더 히어로', '런칭 히어로', '디더링 배경', '리소 느낌 히어로', '브랜드 컬러 배경 애니메이션', 'dither hero', 'shader hero from DESIGN.md', 'launch hero background', 'riso print hero', 'シェーダーのヒーロー', '著陸頁主視覺 shader'. Landing completo nativo de scroll → omd-landing / omd-aphrodite. Efecto de tinta para titulares CJK → omd-cjk-type-shader. Si faltan tokens de marca → omd-init primero.

¿Qué es omd-shader-hero?

omd-shader-hero es una skill para crear un héroe de lanzamiento (hero) de página completa, utilizando exactamente dos tintas planas (color base y un único color de marca) extraídas directamente del archivo DESIGN.md del proyecto. A diferencia de los degradados mesh, que tienden a mezclar colores complementarios y generar tonos sucios, esta skill emplea un campo de tramado ordenado (Bayer) que pliega lentamente, imitando el aspecto de una impresión risográfica. El texto se coloca sobre un recorte opaco del color base, garantizando un contraste mínimo de 4.5:1 sin necesidad de ajustes manuales. La skill está diseñada para lanzamientos, productos, listas de espera, eventos o cambios de marca que requieran movimiento en el color de marca. Soporta tanto WebGL2 (con la librería ligera @paper-design/shaders, ~7 KiB gzip) como un respaldo CSS de semitono sin JavaScript. Incluye un script de verificación que mide el contraste, cuenta las tintas y confirma que el héroe funcione correctamente en GPU real, con soporte para prefers-reduced-motion. No se permite inventar colores ni usar más de dos tintas. Se integra con el ecosistema omd: omd-landing para historias de scroll completas y omd-cjk-type-shader para tipografía CJK.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-shader-hero/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

omd-shader-hero — una escena, dos tintas de marca

Un héroe de lanzamiento recibe una sola impresión de alguien que no te debe nada. Los degradados mesh son el aspecto de shader más genérico de la web, y mezclar dos tonos de marca complementarios los vuelve marrones. Esta skill hace lo contrario: dos tintas planas, el color base y un color de marca, impresas como un campo de tramado ordenado que se pliega lentamente como la luz a través de una serigrafía. Cada píxel es una tinta u la otra, por lo que nada se mezcla y nada se vuelve turbio. El texto se asienta sobre un recorte de bordes duros en la tinta base, como un panel recortado en un póster riso.

El script elige ambas tintas, el color del texto y el contraste desde DESIGN.md. Ningún color se elige por gusto.

Ejemplo funcional: examples/hero.html, completado con el ficticio examples/DESIGN.example.md. Scripts: scripts/tokens.mjs (tintas + contraste), scripts/verify.mjs (verificación de renderizado real).

1. Cuándo usarlo / cuándo no

Úsalo cuando:

  • una página de lanzamiento, producto, lista de espera, evento o cambio de marca necesite una primera pantalla con movimiento;
  • el proyecto tenga un DESIGN.md con un color de marca y una base oscura (o clara) (tokens de Core v2 Foundations, pares de Foundations prose, o frontmatter colors: compatible con Google);
  • un aspecto gráfico, impreso y seguro encaje con la marca.

No lo uses cuando:

  • no haya DESIGN.md o ningún color de marca. tokens.mjs sale con código 3 y te detienes; ejecuta omd-init o pregunta. Nunca elijas colores "bonitos" para llenar el vacío (desconocido significa ausente);
  • la marca sea suave, fotográfica o de lujo tranquilo. Un campo de tramado es ruidoso. Usa la fotografía del brief en su lugar (tf-shaders "photo first");
  • la página necesite varias escenas de shader. Una escena, más a lo sumo un pequeño acento en otro lugar (regla de tf-shaders). Para una historia de scroll completa, usa omd-landing.

2. Procedimiento

  1. Lee los tokens, no los elijas.
    node <skill>/scripts/tokens.mjs DESIGN.md                 # imprime la decisión como JSON
    node <skill>/scripts/tokens.mjs DESIGN.md --scheme light  # base clara en lugar de oscura
    
    El script lee tres formatos, en este orden: tokens - **color.<role>**: \#hex`, pares Name (=`#hex`) dentro de la sección Foundations, luego frontmatter colors:. Luego:
    • descarta roles de estado y utilidad (danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active);
    • toma el token más oscuro como tinta base (el más claro para light);
    • toma una tinta de marca: el rol llamado primary/brand si existe, si no, el color de marca más saturado, saltando cualquier color demasiado cercano a la base.
  2. El color del texto se calcula. El script verifica los candidatos de texto (tokens de tinta/neutral en el extremo opuesto del esquema) contra ambas tintas y su punto medio, y elige el mejor. El texto se asienta sobre un recorte opaco de tinta base, por lo que la barra que debe superar es el token de texto sobre la tinta base. Con el fixture, eso es 18.8:1. Si incluso eso está por debajo de 4.5:1, el script advierte: elige otro token de texto.
  3. Escribe el héroe. Copia examples/hero.html (o transpórtalo, ver §6) y complétalo:
    node <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html
    
    Eso reescribe el bloque CSS #hero-vars (--hero-c0 base, --hero-c1 marca, --hero-text, --hero-scrim, --hero-scrim-a) y el JSON #hero-tokens.
  4. El texto es real. Titular + una oración + un CTA. Usa la línea de producto real del usuario. Nunca inventes métricas, clientes o inversores (tf-shaders §0).
  5. Verifica en una GPU real (§5) y mira los fotogramas a tamaño completo.

3. La escena y sus dos parámetros

ditheringFragmentShader de Paper: type = 4x4 (Bayer ordenado), colorBack = tinta base, colorFront = tinta de marca, y una de dos formas de campo elegidas con data-shape en .hero-scene:

data-shapeCampoSe lee como
warp (predeterminado)pliegues diagonales lentos de luz de marca, escala 1un póster riso, energía en dos esquinas
rippleanillos concéntricos centrados en el héroe, detrás del texto, escala 0.5una impresión con centro de gravedad: el texto se sitúa en el ojo

La forma es una elección de composición, no un tercer parámetro: la escala de cada forma está fija para que sus celdas se lean a px 2–6, y un valor desconocido recurre a warp. Ambas formas permanecen como dos tintas planas (verificado por recuento de píxeles, §5). Otras formas de tramado de Paper y sus otros shaders quedaron fuera: la mayoría mezcla los dos colores en sus bordes, lo que rompe la regla para la que existe esta skill.

ParámetroRangoPredeterminadoQué hace
speed (data-speed)0–10.3Deriva de los pliegues. Por encima de ~0.6 se lee como un protector de pantalla. 0 congela el campo.
px (data-px)2–6 CSS px3Tamaño de la celda de tramado. 2 = pantalla fina, 3 = riso, 5–6 = impresión gruesa.

Reglas de diseño:

  • Recorte, no velo. El cuadro de texto se asienta sobre un panel opaco de tinta base con bordes duros (inset 2rem × 2.5rem alrededor del texto). Un velo translúcido o un borde difuminado colocaría base sobre puntos de marca y recrearía el barro. El texto pequeño (la etiqueta de pie de página) tiene su propio recorte.
  • Contraste: 4.5:1 para el titular y el subtítulo. El titular es lo suficientemente grande como para que WCAG aceptaría 3:1, pero esta skill no se basa en eso. verify.mjs falla por debajo de 4.5:1 para cualquiera de los dos.
  • El texto del héroe se pinta en el primer fotograma: sin opacity: 0, sin esperar al canvas. El canvas aparece gradualmente en 600ms sobre un póster CSS ya completo.
  • El póster también es de dos tintas. Sigue la forma (esquinas para warp, anillos para ripple, dispuestos después del fotograma fijo) y obtiene su tono del tamaño del punto en dos bandas de bordes duros (cuadrados 4×4 en los núcleos, 2×2 en los hombros), nunca de alpha: una máscara desvanecida mezclaría marca sobre base. Puntos cuadrados en píxeles enteros, como las celdas Bayer.
  • El texto coreano sigue /hangul: keep-all + overflow-wrap: anywhere, interlineado 1.3, tracking -0.02em (nunca por debajo de -0.03em), text-wrap: balance, font-synthesis: none.
  • Fondo en html, nunca en body (un fondo de body se pinta sobre una escena con z negativa; error común de tf-shaders).
  • El radio, la escala tipográfica y el espaciado también provienen de DESIGN.md. El fixture no define radio, por lo que el CTA es cuadrado.

4. Librería, licencia, presupuesto, respaldo

Librería: @paper-design/shaders 0.0.82 (vanilla ShaderMount + ditheringFragmentShader), WebGL2. 0.0.82 (2026-10-21) cambia solo shader-mount.js: dispose() ahora libera el contexto WebGL. Licencias verificadas el 2026-10-13 desde los archivos LICENSE de los tarballs npm, metadatos npm y la API de licencias de GitHub:

@paper-design/shaders 0.0.81shaders 4.0.4 (shaders.com)
LicenciaApache 2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper")MIT (© 2026 Shader Effects Inc.); dep typegpu 0.12.3 MIT
Tiempo de ejecuciónWebGL2, casi universalSolo WebGPU; canvas transparente y sin registro cuando no es compatible
JS para esta escena23.7 KiB min / 7.0 KiB gzip (esbuild); CDN por archivo +esm 5.0 + 2.9 KiB gzip2,535 KiB min / 710 KiB gzip (Shader + MeshGradient)
Telemetríaningunaactivada por defecto (muestreo del 5% a shaders.com/api/telemetry); si debes usarlo, pasa disableTelemetry
Descargas semanales npm (2026-10-05..11)1,104,377 (-react)287,493

Paper gana en alcance, peso y telemetría. shaders es la ruta de actualización solo para un proyecto que ya incluya escenas WebGPU. Allí, mantén esta canalización de tokens, el recorte y el respaldo, y pasa disableTelemetry. Ambas licencias permiten su uso en skills y plantillas. El ejemplo importa Paper desde una URL CDN fija y no lo provee. Si provees los archivos de Paper, copia su NOTICE con ellos.

Presupuesto:

  • JS: 7.0 KiB gzip de librería + 1.1 KiB gzip de código de escena.
  • GPU: un quad de ventana completa, dos colores, tramado ordenado. minPixelRatio: 1 y maxPixelCount 1920×1080, ya que el tamaño de celda es la resolución. Paper se pausa fuera de pantalla y en pestañas ocultas.
  • Sin imágenes, sin video, sin fuente más allá de la cara de la interfaz de usuario.

Respaldo (parte del diseño, no una ocurrencia tardía):

  • Póster de semitono CSS debajo del canvas: puntos de la tinta de marca sobre la tinta base (radial-gradient celdas de 6px), enmascarados hacia dos esquinas. Es la primera pintura, la ruta sin WebGL2 (ShaderMount lanza una excepción sin contexto; la página prueba getContext('webgl2') primero), y el estado cuando la CDN no está disponible. verify.mjs fuerza esta ruta.
  • prefers-reduced-motion: reduce: velocidad 0 en un fotograma fijo (STILL_FRAME, 8000ms). Esa es una composición fija sin bucle rAF.

5. Verificar en una GPU real

npm i -D playwright-core && npx playwright-core install chromium   # Playwright Chromium fresco, no tu propio Chrome
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all

--shape warp|ripple|all establece data-shape antes de que se ejecute el módulo de la página. Para cada forma ejecuta cuatro pases (GPU 1440px, móvil 390px, movimiento reducido, sin WebGL) con --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS), y para cada uno:

  • registra el renderizador WebGL, para que sepas si una GPU real o SwiftShader dibujó los fotogramas;
  • avanza el reloj del shader de manera determinista a lo largo de 12s y guarda fotogramas (ffmpeg → demo GIF/MP4);
  • mide el contraste: oculta el texto, muestrea la escena detrás del titular y el subtítulo en cada fotograma, y toma la peor proporción contra el color del texto. Falla por debajo de 4.5:1 para cualquiera de los dos;
  • cuenta las tintas: fuera de los recortes, cada píxel del canvas y del póster CSS debe ser la tinta base o la tinta de marca (twoInksScene, twoInksPoster);
  • póster antes que canvas, desde el propio reloj de la página: un script de inicio muestrea cada fotograma renderizado y registra el primer fotograma en que el póster está en pantalla y el primer fotograma en que el canvas ha dibujado y no es transparente, además del tiempo de pintura y LCP;
  • tiempo de fotograma en el pase GPU: intervalos rAF durante 3 s mientras el campo se ejecuta, mediana y p95;
  • verifica que el canvas (no el póster) está en pantalla, que el campo se mueve, que el titular está a opacidad completa al cargar, que el movimiento reducido está estático, y que sin WebGL se muestra el póster sin canvas.

Medido el 2026-11-06 con el fixture (Chromium sin cabeza, ANGLE Metal Renderer: Apple M5 Pro), todas las comprobaciones pasaron para ambas formas:

FormaPeor titular / subtítuloPíxeles de otra tinta (escena / póster)Fotograma de póster → fotograma de canvas (pase GPU)ms por fotograma (mediana / p95)
warp18.81 / 18.81 en los cuatro pases0 / 062 → 112 ms8.3 / 9.2
ripple18.81 / 18.81 en los cuatro pases0 / 044 → 127 ms8.3 / 9.2

6. Port a Next.js / React

Renderiza la sección, el texto, el recorte y el póster como HTML/CSS plano (el póster no necesita JS). Genera las variables CSS en tiempo de compilación desde tokens.mjs --json, no en tiempo de ejecución. Monta la escena en una hoja 'use client':

useEffect(() => {
  if (!probeWebGL2() || !ref.current) return;           // el póster se queda; nada que limpiar
  let m: { dispose(): void } | undefined;
  (async () => {
    const { ShaderMount, ditheringFragmentShader } = await import('@paper-design/shaders');
    try { m = new ShaderMount(ref.current!, ditheringFragmentShader, uniforms, undefined, reduce ? 0 : speed, 8000, 1, 1920 * 1080); }
    catch { /* mantener el póster */ }
  })();
  return () => m?.dispose();
}, []);

7. Atribución

Del experimento tf-shaders del propietario (skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10): una escena más a lo sumo un acento, el presupuesto JS declarado, el póster CSS debajo de cada canvas, fondo en html, estado silencioso detrás del tipo, contraste verificado en el peor fotograma, texto del héroe en el primer fotograma, movimiento reducido como un cambio de estado y el bucle de captura de pantalla en GPU real. Esta skill añade la canalización de tokens, el tramado de dos tintas, el recorte, el contraste medido y la elección del tiempo de ejecución WebGL2.

No hacer

  • No añadas un tercer color ni mezcles las dos tintas (degradados, superposiciones translúcidas, paneles difuminados). Dos tintas planas son el punto central; una mezcla entre tonos complementarios es barro.
  • No uses un color que no sea un token de DESIGN.md, y nunca uses un color de estado (rojo de danger como tinta de marca).
  • No pongas texto directamente sobre el campo de tramado. El texto va sobre el recorte; el texto pequeño tiene el suyo propio.
  • No cambies shaders por punto de interrupción ni animes propiedades de tiempo de compilación. Cambiar un valor de tinta o px es una escritura de uniforme y está bien.
  • No apiles el héroe sobre un fondo de body, ni desvanezcas el titular.
  • No cargues Paper y shaders en la misma página.

Skills relacionados