Communitygithub.com

omd-shader-hero — 2インクのランチングヒーロー

プロジェクトのDESIGN.mdからベース色と1色のブランドカラーを使い、2インクのオーダードディザ(ベイヤー)フィールドでスローに折りたたむ(またはdata-shape=

omd-shader-hero — 2インクのランチングヒーロー とは?

omd-shader-heroは、印刷/リソグラフ風のルックを実現するAIエージェントスキルです。プロジェクトのDESIGN.mdからベースインクと1色のブランドカラーを抽出し、2色のフラットインクが決して混ざらないオーダードディザ(ベイヤー)フィールドを生成します。テキストはベースインクのハードエッジなノックアウト上に配置され、見出しとサブコピーは常に4.5:1以上のコントラスト比を保ちます。verify.mjsスクリプトが全タイムラインでコントラストを測定し、prefers-reduced-motionにも対応。ライブラリJSは約7KiB gzipと軽量で、Core v2トークンやGoogle互換のfrontmatterを読み取り、パレットを勝手に発明しません。ランディングページ、製品ヒーロー、ウェイトリスト、イベント、ブランドリニューアルのファーストスクリーンに最適です。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェントで、トリガーワードは日本語・韓国語・中国語・英語に対応しています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

omd-shader-hero — 1つのシーン、2つのブランドインク

ランチングヒーローは、あなたに何も負っていない誰かによる一つの見た目を持ちます。メッシュグラデーションはウェブ上で最も一般的なシェーダールックであり、2つの補色のブランド色をブレンドすると茶色くなります。このスキルはその逆を行います:2つのフラットインク、ベース色と1つのブランドカラーを、スクリーン印刷を通した光のようにゆっくりと折りたたまれるオーダードディザフィールドとして印刷します。すべてのピクセルはどちらかのインクであり、何もブレンドせず、濁ることもありません。コピーはベースインクのハードエッジなノックアウト上に配置され、リソポスターの切り抜きパネルのように見えます。

スクリプトは両方のインク、テキストカラー、コントラストをDESIGN.mdから選びます。色は趣味で選ばれません。

動作例:examples/hero.html、架空のexamples/DESIGN.example.mdから入力。スクリプト:scripts/tokens.mjs(インク+コントラスト)、scripts/verify.mjs(実際のレンダリング検証)。

1. 使用する場合 / 使用しない場合

使用する場合:

  • ランチング、製品、ウェイトリスト、イベント、またはブランドリニューアルページで、モーションを伴う最初のスクリーンが必要なとき
  • プロジェクトにDESIGN.mdがあり、ブランドカラーとダーク(またはライト)ベースが定義されているとき(Core v2 Foundationsトークン、Foundations proseペア、またはGoogle互換のcolors:フロントマター)
  • グラフィカルで印刷された、自信に満ちたルックがブランドに合うとき

使用しない場合:

  • DESIGN.mdがない、またはブランドカラーがない場合。tokens.mjsは終了コード3で終了し、停止します。omd-initを実行するか、質問してください。ギャップを埋めるために「素敵な」色を決して選ばないでください(不明は不在を意味します)
  • ブランドがソフトで、写真調、またはラグジュアリーで静かな場合。ディザフィールドは騒がしいです。代わりにブリーフの写真を使用してください(tf-shaders「フォトファースト」)
  • ページに複数のシェーダーシーンが必要な場合。1シーンのみ、多くても1つの小さなアクセントを別の場所に(tf-shadersルール)。スクロールストーリー全体にはomd-landingを使用してください。

2. 手順

  1. トークンを読み取り、選択しないでください。
    node <skill>/scripts/tokens.mjs DESIGN.md                 # 決定をJSONで出力
    node <skill>/scripts/tokens.mjs DESIGN.md --scheme light  # ダークではなくライトベース
    
    スクリプトは3つのフォーマットをこの順序で読み取ります:- **color.<role>**: \#hex`トークン、Foundationsセクション内のName (`#hex`)ペア、次にフロントマターcolors:`。その後:
    • 状態およびユーティリティロール(danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active)を削除します
    • 最も暗いトークンをベースインク(lightの場合は最も明るいもの)とします
    • 1つのブランドインクを取ります:primary/brandというロールがあればそれ、なければ最も彩度の高いブランドカラーで、ベースに近すぎるものはスキップします
  2. テキストカラーは計算されます。 スクリプトはテキスト候補(スキームの反対側のインク/ニュートラルトークン)を両方のインクおよびその中間点に対してチェックし、最適なものを選びます。コピーは不透明なベースインクノックアウト上に配置されるため、クリアすべきバーはベースインク上のテキストトークンです。フィクスチャでは18.8:1です。それでも4.5:1未満の場合、スクリプトは警告します:別のテキストトークンを選んでください。
  3. ヒーローを書きます。 examples/hero.htmlをコピー(または移植、§6参照)して埋めます:
    node <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html
    
    これにより#hero-vars CSSブロック(--hero-c0ベース、--hero-c1ブランド、--hero-text、--hero-scrim、--hero-scrim-a)と#hero-tokens JSONが書き換えられます。
  4. コピーは本物です。 見出し + 1文 + 1つのCTA。ユーザーの実際の製品ラインを使用してください。メトリクス、顧客、投資家を決して発明しないでください(tf-shaders §0)。
  5. 実際のGPUで検証(§5)し、フレームをフルサイズで確認してください。

3. シーンとその2つのパラメーター

PaperのditheringFragmentShader:type = 4x4(オーダーベイヤー)、colorBack = ベースインク、colorFront = ブランドインク、および.hero-scene上のdata-shapeで選択される2つのフィールド形状のうちの1つ:

data-shapeフィールド見た目
warp(デフォルト)ブランドライトの遅い対角線上の折り目、スケール1リソポスター、2隅にエネルギー
rippleヒーローを中心とした同心円、コピーの背後、スケール0.5重心のある印刷物:コピーが目の中心に

形状は構成の選択であり、3番目のパラメーターではありません:各形状のスケールは固定されており、セルがpx 2〜6で読み取れるようになっています。不明な値はwarpにフォールバックします。両方の形状は2つのフラットインクを維持します(ピクセルカウントで検証、§5)。Paperの他のディザリング形状と他のシェーダーは除外されました:ほとんどがエッジで2色をブレンドし、このスキルが存在するルールを破ります。

パラメータ範囲デフォルト動作
speed(data-speed)0–10.3折り目のドリフト。約0.6以上ではスクリーンセーバーのように見えます。0でフィールドをフリーズします。
px(data-px)2–6 CSS px3ディザセルサイズ。2 = 細かいスクリーン、3 = リソ、5–6 = 粗い印刷。

レイアウトルール:

  • ノックアウト、スリムではない。 コピーボックスは不透明なベースインクパネル上にハードエッジで配置されます(コピーの周りにinset 2rem × 2.5rem)。半透明のスリムやフェザーエッジだと、ベースがブランドドットの上に重なり、濁りが再現されます。小さなテキスト(フッターラベル)も独自のノックアウトを持ちます。
  • コントラスト:見出しとサブコピーで4.5:1。 見出しは十分大きいためWCAGは3:1を受け入れますが、このスキルはそれに依存しません。verify.mjsはどちらかが4.5:1未満で失敗します。
  • ヒーローコピーは最初のフレームで描画されます: opacity: 0はなく、キャンバスを待つこともありません。キャンバスは既に完了したCSSポスターの上に600msかけてフェードインします。
  • ポスターも2インクです。 形状に従い(warpは隅、rippleはリング、静止フレーム後にレイアウト)、ドットサイズによってトーンを得ます。2つのハードエッジバンド(コアでは4×4の正方形、ショルダーでは2×2)で、アルファは使用しません:フェードマスクはブランドをベースの上にブレンドします。ベイヤーセルのように、ピクセル全体に正方形のドット。
  • 韓国語のディスプレイタイプは/hangulに従います:keep-all + overflow-wrap: anywhere、行高1.3、トラッキング-0.02em(決して-0.03em未満)、text-wrap: balance、font-synthesis: none。
  • 背景はhtmlに、決してbodyには設定しません(body背景はネガティブzのシーンの上にペイントされます;tf-shadersの落とし穴)。
  • 半径、タイプスケール、スペーシングもDESIGN.mdから取得します。フィクスチャは半径を定義しないため、CTAは正方形です。

4. ライブラリ、ライセンス、予算、フォールバック

ライブラリ:@paper-design/shaders 0.0.82(vanilla ShaderMount + ditheringFragmentShader)、WebGL2。 0.0.82(2026-10-21)はshader-mount.jsのみを変更:dispose()がWebGLコンテキストを解放するようになりました。ライセンスは2026-10-13にnpm tarballのLICENSEファイル、npmメタデータ、GitHubライセンスAPIから検証済み:

@paper-design/shaders 0.0.81shaders 4.0.4(shaders.com)
ライセンスApache-2.0(+ NOTICE「Paper Shaders, Copyright 2026 Paper」)MIT(© 2026 Shader Effects Inc.);依存 typegpu 0.12.3 MIT
ランタイムWebGL2、ほぼユニバーサルWebGPUのみ;未サポート時は透明なキャンバスとログなし
このシーンのJS23.7 KiB min / 7.0 KiB gzip(esbuild);CDNファイルごと+esm 5.0 + 2.9 KiB gzip2,535 KiB min / 710 KiB gzip(Shader + MeshGradient)
テレメトリなしデフォルトでオン(5%サンプリング、shaders.com/api/telemetryへ);使用する必要がある場合はdisableTelemetryを渡す
npm週間ダウンロード(2026-10-05..11)1,104,377(-react)287,493

Paperはリーチ、軽量性、テレメトリなしで勝ります。shadersは、既にWebGPUシーンを出荷しているプロジェクトのみのアップグレードパスです。その場合、このトークンパイプライン、ノックアウト、フォールバックを維持し、disableTelemetryを渡してください。両方のライセンスはスキルおよびテンプレートでの使用を許可します。サンプルはPaperを固定CDN URLからインポートし、ベンダリングしません。Paperのファイルをベンダリングする場合は、そのNOTICEも一緒にコピーしてください。

予算:

  • JS: 7.0 KiB gzipライブラリ + 1.1 KiB gzipシーンコード。
  • GPU: 1つのフルビューポートクアッド、2色、オーダードディザ。minPixelRatio: 1およびmaxPixelCount 1920×1080(セルサイズが解像度であるため)。Paperはオフスクリーンおよび非表示タブで一時停止します。
  • 画像なし、動画なし、UIフェイス以外のフォントなし。

フォールバック(後付けではなくデザインの一部):

  • CSSハーフトーンポスターをキャンバスの下に:ベースインク上のブランドインクのドット(radial-gradient 6pxセル)、2つの隅に向けてマスク。これが最初のペイントであり、WebGL2なしのパス(ShaderMountはコンテキストなしでスロー;ページは最初にgetContext('webgl2')をプローブ)、CDNに到達できない場合の状態です。verify.mjsはこのパスを強制します。
  • prefers-reduced-motion: reduce: 固定フレーム(STILL_FRAME、8000ms)で速度0。rAFループのない1つの静止構成です。

5. 実際のGPUで検証

npm i -D playwright-core && npx playwright-core install chromium   # 新しいPlaywright Chromium、あなた自身のChromeではありません
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all

--shape warp|ripple|allは、ページのモジュールが実行される前にdata-shapeを設定します。各形状に対して4つのパスを実行します(1440px GPU、390pxモバイル、reduced-motion、no-WebGL)、--enable-gpu --ignore-gpu-blocklist --use-angle=metal(macOS)を使用し、各パスで:

  • WebGLレンダラーを記録し、実際のGPUまたはSwiftShaderがフレームを描画したかを確認します
  • シェーダークロックを12秒間決定論的に進め、フレームを保存します(ffmpeg → デモGIF/MP4)
  • コントラストを測定:コピーを非表示にし、すべてのフレームで見出しとサブコピーの背後にあるシーンをサンプリングし、テキストカラーに対する最悪の比率を取ります。どちらかが4.5:1未満で失敗します
  • インクをカウント:ノックアウトの外側で、キャンバスとCSSポスターのすべてのピクセルがベースインクまたはブランドインクである必要があります(twoInksScene、twoInksPoster)
  • キャンバスより前のポスター:ページ自身のクロックから、initスクリプトが各レンダリングフレームをサンプリングし、ポスターが画面に表示された最初のフレームと、キャンバスが描画されて透明でなくなった最初のフレームを記録します。さらにペイントタイミングとLCPも記録
  • フレーム時間(GPUパス):フィールドが実行中の3秒間のrAF間隔、中央値とp95
  • キャンバス(ポスターではない)が画面に表示されていること、フィールドが動いていること、見出しがロード時に完全な不透明度であること、reduced motionで静止していること、no-WebGLでポスターが表示されキャンバスがないことを確認します

2026-11-06にフィクスチャ(ヘッドレスChromium、ANGLE Metal Renderer: Apple M5 Pro)で測定、すべてのチェックが両方の形状で合格:

形状最悪の見出し / サブコピー他のインクのピクセル(シーン / ポスター)ポスターフレーム → キャンバスフレーム(GPUパス)フレームms(中央値 / p95)
warp4パスすべてで18.81 / 18.810 / 062 → 112 ms8.3 / 9.2
ripple4パスすべてで18.81 / 18.810 / 044 → 127 ms8.3 / 9.2

6. Next.js / React 移植

セクション、コピー、ノックアウト、ポスターをプレーンなHTML/CSSとしてサーバーレンダリングします(ポスターにJSは不要)。CSS変数はビルド時にtokens.mjs --jsonから生成し、ランタイムでは生成しないでください。シーンを'use client'リーフにマウントします:

useEffect(() => {
  if (!probeWebGL2() || !ref.current) return;           // ポスターは残る;クリーンアップ不要
  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 { /* ポスターを維持 */ }
  })();
  return () => m?.dispose();
}, []);

7. 帰属

オーナーのtf-shaders実験(skill/shader-landing/SKILL.md、RESEARCH.md、scripts/shoot.mjs、2026-10)より:1シーン+最大1つのアクセント、規定のJS予算、すべてのキャンバスの下のCSSポスター、html上の背景、タイプの背後にある静かな状態、最悪のフレームでチェックされたコントラスト、ファーストフレームのヒーローコピー、状態変化としてのreduced motion、実際のGPUスクリーンショットループ。このスキルは、トークンパイプライン、2インクディザ、ノックアウト、測定されたコントラスト、WebGL2ランタイムの選択を追加します。

禁止事項

  • 3番目の色を追加したり、2つのインクをブレンドしないでください(グラデーション、半透明オーバーレイ、フェザーパネル)。2つのフラットインクがすべてのポイントです。補色間のブレンドは濁りです。
  • DESIGN.mdトークンではない色を使用しないでください。特にステートカラー(danger redをブランドインクとして)は使用しないでください。
  • テキストをディザフィールドに直接配置しないでください。コピーはノックアウト上に配置します。小さなテキストは独自のノックアウトを持ちます。
  • ブレークポイントごとにシェーダーを切り替えたり、コンパイル時のプロパティをアニメートしないでください。インク値やpxの変更はユニフォーム書き込みであり、問題ありません。
  • ヒーローをbody背景の上に重ねたり、見出しをフェードインさせたりしないでください。
  • Paperとshadersを同じページにロードしないでください。

関連スキル