Communitygithub.com

omd-shader-hero — une scène, deux encres de marque

Un héros plein écran en deux encres extraites du DESIGN.md du projet : la couleur de base et exactement une couleur de marque, sous forme de champ de tramage ordonné (Bayer) qui se plie lentement (ou ondule avec data-shape="ripple") — un rendu d'impression risographique, pas un dégradé générique. Deux encres plates ne se mélangent jamais, donc pas de boue. Le texte repose sur un découpage net de l'encre de base, garantissant un contraste 4,5:1 ; un script de vérification le mesure sur toute la timeline. Lit les tokens Core v2 (et le frontmatter compatible Google), refuse d'inventer une palette, fournit un fallback CSS de poster tramé, respecte prefers-reduced-motion, ~7 KiB gzip de JS. À utiliser pour une page de lancement, un héros produit, une liste d'attente, un événement ou le premier écran d'un rebranding qui nécessite une animation dans la couleur de marque. Déclencheurs : '셰이더 히어로', '런칭 히어로', '디더링 배경', '리소 느낌 히어로', '브랜드 컬러 배경 애니메이션', 'dither hero', 'shader hero from DESIGN.md', 'launch hero background', 'riso print hero', 'シェーダーのヒーロー', '着陸頁主視覺 shader'. Landing page entière en défilement natif → omd-landing / omd-aphrodite. Effet d'encre pour titres CJK → omd-cjk-type-shader. Tokens de marque manquants → exécutez d'abord omd-init.

Qu'est-ce que omd-shader-hero — une scène, deux encres de marque ?

Ce skill crée une section hero de lancement en plein écran pour des pages web, en utilisant exactement deux encres plates (couleur de base et une couleur de marque) extraites du fichier `DESIGN.md` du projet. Il génère un champ de tramage ordonné (Bayer) animé – plis lents ou ondulations – qui imite un rendu d'impression risographique, évitant tout mélange de couleurs et donc toute teinte boueuse. Le texte (titre et sous-titre) est placé sur un découpage net de l'encre de base, garantissant un contraste d'au moins 4,5:1 mesuré sur toute l'animation. Le skill lit automatiquement les tokens de design Core v2 ou le frontmatter compatible Google, rejette toute couleur non présente dans le DESIGN.md, et intègre un fallback CSS de poster tramé pour les navigateurs sans WebGL2 ou lorsque l'utilisateur préfère une réduction de mouvement. Il utilise la bibliothèque `@paper-design/shaders` (Apache-2.0) pour un rendu WebGL2 très léger (environ 7 KiB gzip). Le skill inclut un pipeline de vérification complet via un script Playwright qui teste le contraste, le nombre d'encres, et les performances sur GPU réel, en s'assurant que seule l'encre de base et l'encre de marque apparaissent dans l'image. Idéal pour les pages de lancement, produits, listes d'attente ou événements nécessitant une première impression forte avec la couleur de marque, sans tomber dans les dégradés génériques.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait omd-shader-hero — une scène, deux encres de marque ?

Un héros de lancement reçoit une unique apparence de quelqu'un qui ne vous doit rien. Les dégradés maillés sont le rendu shader le plus générique du web, et mélanger deux teintes de marque complémentaires les transforme en marron. Ce skill fait l'inverse : deux encres plates, la couleur de base et une couleur de marque, imprimées comme un champ de tramage ordonné qui se plie lentement, telle la lumière à travers un écran de sérigraphie. Chaque pixel est soit une encre, soit l'autre, donc rien ne se mélange et rien ne devient boueux. Le texte repose sur un découpage net dans l'encre de base, comme un panneau découpé sur un poster riso.

Le script choisit les deux encres, la couleur du texte et le contraste à partir de DESIGN.md. Aucune couleur n'est choisie par goût.

Exemple fonctionnel : examples/hero.html, rempli à partir du fictif examples/DESIGN.example.md. Scripts : scripts/tokens.mjs (encres + contraste), scripts/verify.mjs (vérification de rendu réel).

1. Quand l'utiliser / quand ne pas l'utiliser

À utiliser quand :

  • une page de lancement, produit, liste d'attente, événement ou rebranding nécessite un premier écran avec animation ;
  • le projet possède un DESIGN.md avec une couleur de marque et une base sombre (ou claire) (tokens Core v2 Foundations, paires Foundations prose, ou frontmatter colors: compatible Google) ;
  • un look graphique, imprimé et affirmé correspond à la marque.

Ne pas utiliser quand :

  • il n'y a pas de DESIGN.md ou pas de couleur de marque. tokens.mjs se termine avec le code 3 et vous vous arrêtez ; exécutez omd-init ou demandez. Ne choisissez jamais des couleurs "sympas" pour combler le vide (inconnu signifie absent) ;
  • la marque est douce, photographique ou luxe discret. Un champ de tramage est bruyant. Utilisez plutôt la photographie du brief (tf-shaders "photo first") ;
  • la page a besoin de plusieurs scènes shader. Une scène, plus au maximum un petit accent ailleurs (règle tf-shaders). Pour une histoire complète en défilement, utilisez omd-landing.

2. Procédure

  1. Lisez les tokens, ne les choisissez pas.
    node <skill>/scripts/tokens.mjs DESIGN.md                 # affiche la décision en JSON
    node <skill>/scripts/tokens.mjs DESIGN.md --scheme light  # base claire au lieu de sombre
    
    Le script lit trois formats, dans cet ordre : - **color.<role>**: \#hex`tokens, les pairesName (`#hex`)dans la section Foundations, puis le frontmattercolors:`. Ensuite, il :
    • supprime les rôles d'état et d'interface (danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active) ;
    • prend le token le plus sombre comme encre de base (le plus clair pour light) ;
    • prend une encre de marque : le rôle nommé primary/brand s'il existe, sinon la couleur de marque la plus saturée, en ignorant toute couleur trop proche de la base.
  2. La couleur du texte est calculée. Le script vérifie les candidats de texte (tokens d'encre/neutres à l'opposé du schéma) par rapport aux deux encres et à leur point médian, et choisit la meilleure. La copie repose ensuite sur un découpage opaque de l'encre de base, donc la barre à franchir est le token de texte sur l'encre de base. Avec le jeu de tests, cela donne 18,8:1. Si même cela est inférieur à 4,5:1, le script émet un avertissement : choisissez un autre token de texte.
  3. Écrivez le héros. Copiez examples/hero.html (ou portez-le, voir §6) et remplissez-le :
    node <skill>/scripts/tokens.mjs DESIGN.md --write chemin/vers/hero.html
    
    Cela réécrit le bloc CSS #hero-vars (--hero-c0 base, --hero-c1 marque, --hero-text, --hero-scrim, --hero-scrim-a) et le JSON #hero-tokens.
  4. La copie est réelle. Titre + une phrase + un CTA. Utilisez la ligne de produit réelle de l'utilisateur. N'inventez jamais de métriques, clients ou investisseurs (tf-shaders §0).
  5. Vérifiez sur un vrai GPU (§5) et regardez les images en taille réelle.

3. La scène et ses deux paramètres

ditheringFragmentShader de Paper : type = 4x4 (Bayer ordonné), colorBack = encre de base, colorFront = encre de marque, et une des deux formes de champ choisies avec data-shape sur .hero-scene :

data-shapeChampInterprétation
warp (par défaut)plis diagonaux lents de la lumière de marque, échelle 1un poster riso, énergie à deux coins
rippleanneaux concentriques centrés sur le héros, derrière le texte, échelle 0,5une impression avec un centre de gravité : le texte est dans l'œil

La forme est un choix de composition, pas un troisième paramètre : l'échelle de chaque forme est fixe pour que ses cellules se lisent à une taille de px de 2 à 6, et une valeur inconnue utilise warp par défaut. Les deux formes restent deux encres plates (vérifié par comptage de pixels, §5). Les autres formes de tramage de Paper et ses autres shaders ont été laissés de côté : la plupart mélangent les deux couleurs à leurs bords, ce qui brise la règle pour laquelle ce skill existe.

ParamètrePlageDéfautEffet
speed (data-speed)0–10.3Dérive des plis. Au-dessus de ~0,6, cela ressemble à un économiseur d'écran. 0 fige le champ.
px (data-px)2–6 px CSS3Taille de cellule de tramage. 2 = trame fine, 3 = riso, 5–6 = impression grossière.

Règles de mise en page :

  • Découpage, pas de voile. Le bloc de texte repose sur un panneau opaque d'encre de base aux bords nets (inset 2rem × 2,5rem autour du texte). Un voile translucide ou un bord dégradé superposerait la base sur les points de la marque et recréerait la boue. Le petit texte (l'étiquette de pied de page) a également son propre découpage.
  • Contraste : 4,5:1 pour le titre et le sous-titre. Le titre est assez grand pour que WCAG accepterait 3:1, mais ce skill ne s'y fie pas. verify.mjs échoue en dessous de 4,5:1 pour l'un ou l'autre.
  • Le texte du héros s'affiche dès la première image : pas de opacity: 0, pas d'attente pour le canvas. Le canvas apparaît en fondu sur 600 ms au-dessus d'un poster CSS déjà complet.
  • Le poster est aussi en deux encres. Il suit la forme (coins pour warp, anneaux pour ripple, disposés après l'image fixe) et obtient sa tonalité par la taille des points dans deux bandes à bords nets (carrés 4×4 au centre, 2×2 sur les côtés), jamais par alpha : un masque dégradé mélangerait la marque sur la base. Points carrés sur des pixels entiers, comme les cellules de Bayer.
  • L'affichage coréen suit /hangul : keep-all + overflow-wrap: anywhere, hauteur de ligne 1,3, crénage -0,02em (jamais en dessous de -0,03em), text-wrap: balance, font-synthesis: none.
  • Arrière-plan sur html, jamais sur body (un arrière-plan sur body se peint par-dessus une scène en z négatif ; piège tf-shaders).
  • Rayon, échelle typographique et espacement proviennent également de DESIGN.md. Le jeu de tests ne définit aucun rayon, donc le CTA est carré.

4. Bibliothèque, licence, budget, repli

Bibliothèque : @paper-design/shaders 0.0.82 (ShaderMount vanilla + ditheringFragmentShader), WebGL2. La version 0.0.82 (2026-10-21) ne modifie que shader-mount.js : dispose() libère désormais le contexte WebGL. Licences vérifiées le 2026-10-13 à partir des fichiers LICENSE des tarballs npm, des métadonnées npm et de l'API de licence GitHub :

@paper-design/shaders 0.0.81shaders 4.0.4 (shaders.com)
LicenceApache-2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper")MIT (© 2026 Shader Effects Inc.) ; dépendance typegpu 0.12.3 MIT
ExécutionWebGL2, quasi universelWebGPU uniquement ; canvas transparent et aucun log en cas d'absence de support
JS pour cette scène23,7 KiB min / 7,0 KiB gzip (esbuild) ; CDN par fichier +esm 5,0 + 2,9 KiB gzip2 535 KiB min / 710 KiB gzip (Shader + MeshGradient)
Télémétrieaucuneactivée par défaut (échantillonnage 5% vers shaders.com/api/telemetry) ; si vous devez l'utiliser, passez disableTelemetry
Téléchargements npm hebdomadaires (2026-10-05..11)1 104 377 (-react)287 493

Paper l'emporte en termes de portée, de poids et de télémétrie. shaders est la voie de mise à niveau uniquement pour un projet qui propose déjà des scènes WebGPU. Dans ce cas, conservez ce pipeline de tokens, le découpage et le repli, et passez disableTelemetry. Les deux licences autorisent l'utilisation dans les skills et les templates. L'exemple importe Paper depuis une URL CDN figée et ne le met pas en vente. Si vous mettez les fichiers de Paper en vente, copiez son NOTICE avec eux.

Budget :

  • JS : 7,0 KiB gzip de bibliothèque + 1,1 KiB gzip de code de scène.
  • GPU : un quad plein écran, deux couleurs, tramage ordonné. minPixelRatio: 1 et maxPixelCount 1920×1080, car la taille des cellules est la résolution. Paper se met en pause hors écran et dans les onglets cachés.
  • Pas d'images, pas de vidéo, pas de police autre que la face UI.

Repli (partie intégrante du design, pas une réflexion après coup) :

  • Poster tramé CSS sous le canvas : points de l'encre de marque sur l'encre de base (radial-gradient cellules 6px), masqués vers deux coins. C'est la première peinture, le chemin sans WebGL2 (ShaderMount lance une exception sans contexte ; la page teste d'abord getContext('webgl2')), et l'état lorsque le CDN est inaccessible. verify.mjs force ce chemin.
  • prefers-reduced-motion: reduce : vitesse 0 à une image fixe (STILL_FRAME, 8000ms). C'est une composition fixe sans boucle rAF.

5. Vérification sur un vrai GPU

npm i -D playwright-core && npx playwright-core install chromium   # Playwright Chromium frais, pas votre propre Chrome
node <skill>/scripts/verify.mjs chemin/vers/hero.html ./hero-verify --frames 48 --seconds 12 --shape all

--shape warp|ripple|all définit data-shape avant l'exécution du module de la page. Pour chaque forme, il effectue quatre passes (GPU 1440px, mobile 390px, mouvement réduit, sans WebGL) avec --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS), et pour chacune :

  • enregistre le moteur de rendu WebGL, afin de savoir si un vrai GPU ou SwiftShader a dessiné les images ;
  • parcourt l'horloge du shader de manière déterministe sur 12 secondes et sauvegarde les images (ffmpeg → GIF/MP4 de démonstration) ;
  • mesure le contraste : masque le texte, échantillonne la scène derrière le titre et le sous-titre dans chaque image, et prend le ratio le plus bas par rapport à la couleur du texte. Il échoue en dessous de 4,5:1 pour l'un ou l'autre ;
  • compte les encres : en dehors des découpages, chaque pixel du canvas et du poster CSS doit être soit l'encre de base, soit l'encre de marque (twoInksScene, twoInksPoster) ;
  • poster avant canvas, depuis l'horloge de la page : un script d'initialisation échantillonne chaque image rendue et enregistre la première image où le poster est à l'écran et la première image où le canvas a dessiné et n'est pas transparent, ainsi que les temps de peinture et le LCP ;
  • temps par image sur la passe GPU : intervalles rAF pendant 3 s pendant que le champ tourne, médiane et p95 ;
  • vérifie que le canvas (pas le poster) est à l'écran, que le champ bouge, que le titre est à pleine opacité au chargement, que le mouvement réduit est immobile, et que sans WebGL, le poster s'affiche sans canvas.

Mesuré le 2026-11-06 avec le jeu de tests (Chromium headless, ANGLE Metal Renderer: Apple M5 Pro), toutes les vérifications ont réussi pour les deux formes :

FormePire ratio titre / sous-titreAutres pixels d'encre (scène / poster)Image poster → image canvas (passe GPU)ms par image (médiane / p95)
warp18,81 / 18,81 dans les quatre passes0 / 062 → 112 ms8,3 / 9,2
ripple18,81 / 18,81 dans les quatre passes0 / 044 → 127 ms8,3 / 9,2

6. Port Next.js / React

Rendu côté serveur de la section, du texte, du découpage et du poster en HTML/CSS pur (le poster n'a pas besoin de JS). Générez les variables CSS au moment de la construction à partir de tokens.mjs --json, pas à l'exécution. Montez la scène dans un composant feuille 'use client' :

useEffect(() => {
  if (!probeWebGL2() || !ref.current) return;           // le poster reste ; rien à nettoyer
  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 { /* conserver le poster */ }
  })();
  return () => m?.dispose();
}, []);

7. Attribution

Issu de l'expérience tf-shaders du propriétaire (skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10) : une scène plus au maximum un accent, le budget JS indiqué, le poster CSS sous chaque canvas, l'arrière-plan sur html, l'état calme derrière le texte, le contraste vérifié à la pire image, le texte du héros dès la première image, le mouvement réduit comme changement d'état, et la boucle de capture d'écran sur vrai GPU. Ce skill ajoute le pipeline de tokens, le tramage à deux encres, le découpage, le contraste mesuré et le choix d'exécution WebGL2.

À ne pas faire

  • N'ajoutez pas de troisième couleur et ne mélangez pas les deux encres (dégradés, superpositions translucides, panneaux dégradés). Deux encres plates sont le cœur du sujet ; un mélange entre teintes complémentaires est de la boue.
  • N'utilisez pas de couleur qui ne soit pas un token de DESIGN.md, et jamais une couleur d'état (rouge danger comme encre de marque).
  • Ne placez pas de texte directement sur le champ de tramage. Le texte va sur le découpage ; le petit texte a le sien.
  • Ne changez pas de shader par point de rupture et n'animez pas de propriétés de compilation. Changer une valeur d'encre ou px est une écriture uniforme et est acceptable.
  • Ne superposez pas le héros sur un arrière-plan body et ne faites pas apparaître le titre en fondu.
  • Ne chargez pas Paper et shaders sur la même page.

Skills associés