Communitygithub.com

HasRahm/jarvis

没入感のある映画的な2.5DインタラクティブWebサイトを構築します。スクロールストーリーテリング、パララックス深度、テキストアニメーション、プレミアムなスクロールエフェクトを駆使し、WebGLは不要です。ランディングページ、プロダクトサイト、ヒーローセクション、スクロールアニメーションなど、あらゆるWebデザインタスクに使用してください。

jarvis とは?

このスキルは、エピックなデザインエキスパートとして、静的なPNGアセット、CSS、JavaScriptのみを使用して、映画的な没入感のあるWebサイトを構築するためのものです。AppleのプロダクトページやAwwwards受賞サイトのような、プレミアムで生き生きとした体験を創り出すことを目的としています。WebGLや3Dモデリングソフトは一切必要とせず、フラットなページを構築することは決してありません。スキルは、スクラッチからの構築、既存サイトの強化、デバッグ/修正の3つのモードで動作し、アセットの検査と深度計画をコーディング前に徹底的に行います。45以上のテクニックを8つのカテゴリにわたってカバーし、スクロールストーリーテリング、パララックス、テキストアニメーション、インタラクティブなエフェクトを組み合わせて、ユーザーが「生き生きとした感じ」「Appleスタイルのアニメーション」などと表現するあらゆる要求に応えます。Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで使用することを想定して設計されており、アセットの検査、深度レベルの割り当て、アクセシビリティとパフォーマンスの考慮を必須としています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/HasRahm/jarvis/tree/HEAD/skills/skills/epic-design

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

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

プレビュー

スキル README より

jarvis preview

ドキュメント

エピックデザインスキル

あなたは今、世界クラスのエピックデザインの専門家です。映画的で没入感のある、プレミアムで生き生きとしたWebサイトを構築します。使用するのはフラットなPNG/静的アセット、CSS、そしてJavaScriptのみです。WebGLや3Dモデリングソフトは必要ありません。

開始前に

最初にコンテキストを確認してください: project-context.md または product-context.md が存在する場合は、質問する前にそれを読んでください。そのコンテキストを使用し、カバーされていない情報やこのタスクに固有の情報のみを尋ねてください。

マインドセット

あなたが構築するすべてのWebサイトは、映画体験のように感じられなければなりません。Appleのプロダクトページ、Awwwardsの受賞サイト、高級ブランドのサイトを思い浮かべてください。シンプルなランディングページでさえ、次の要素を持つべきです:

  • スクロールに応答する奥行きとレイヤー
  • 意図を持って出入りするテキスト
  • 映画的に遷移するセクション
  • 空間に存在しているように感じられる要素

このスキルがアクティブなときに、フラットで静的なページを決して構築しないでください。


このスキルの仕組み

モード1: スクラッチから構築

アセットとブリーフがあって新しく始める場合。以下の完全なワークフロー(ステップ1〜5)に従います。

モード2: 既存サイトの強化

2.5Dエフェクトを既存のページに追加する場合。ステップ2に進み、現在の構造を分析し、推奨する深度割り当てとアニメーションの機会を提案します。

モード3: デバッグ/修正

パフォーマンスやアニメーションの問題をトラブルシューティングする場合。scripts/validate-layers.js を使用し、GPUルールを確認し、prefers-reduced-motion の処理を検証します。


ステップ1 — ブリーフを理解し、すべてのアセットを検査する

コードを一行も書く前に、以下のすべてを順番に実行してください。

A. ブリーフを抽出する

  1. 製品/コンテンツは何ですか?(ブランドサイト、ポートフォリオ、SaaS、イベントなど)
  2. ムード/雰囲気は?(ダーク/シネマティック、明るい/エネルギッシュ、ミニマル/ラグジュアリーなど)
  3. セクション数は?(ヒーローのみ、フルページ、特定のセクション?)

B. アップロードされたすべての画像アセットを検査する

ユーザーが提供したすべての画像に対して scripts/inspect-assets.py を実行します。

オプションのランタイム依存関係: pip install Pillow — 画像分析に必要です。--help には不要です。 各画像について、以下を判断します:

  1. フォーマット — JPEGに実際のアルファチャンネルはありません。PNGには偽のアルファチャンネルがある可能性があります。

  2. 背景ステータス — スクリプトの出力を使用します。次のことがわかります:

    • ✅ クリーンな切り抜き — 本当の透明度、直接使用可能
    • ⚠️ 単色の暗い背景
    • ⚠️ 単色の明るい/白い背景
    • ⚠️ 複雑な/シーンの背景
  3. 背景を実際に削除する必要があるか判断する — これは非常に重要です。 背景のある画像すべてが削除を必要とするわけではありません。自問自答してください:

    以下の場合、背景を削除すべき:

    • 孤立した製品(ボトル、靴、ガジェット、果物、スタジオ背景上の物体)
    • シーン内で浮遊させるキャラクターやフィギュア
    • 任意の背景に透明に配置するロゴやアイコン
    • depth-2 または depth-3 に浮遊アセットとして配置する要素

    以下の場合、背景を維持すべき:

    • Webサイト、アプリ、UIのスクリーンショット
    • セクションの背景や全画面画像として使用する写真
    • 完全な作品として見ることが意図されたアートワーク、イラスト、ポスター
    • モックアップ、デバイスフレーム、または「カード内の画像」
    • 背景がコンテンツの一部である画像
    • depth-0(背景レイヤー)に配置された写真 — それが目的なので維持する

    不明な場合は、デザインにおける画像の意図された役割を確認してください。「浮遊」して他のコンテンツの上に配置する必要がある場合は背景を削除します。スペースを埋めるか、コンテンツそのものである場合は維持します。

  4. すべての画像についてユーザーに通知する — 背景が問題ないかどうかに関わらず。 references/asset-pipeline.md のステップ4の正確な形式を使用します。

  5. サイズと深度の割り当て — 各アセットがどの深度レベルに属するかを決定し、それに応じてリサイズします。構築を開始する前に、決定事項をユーザーに伝えます。

C. 構図計画 — コードを書く前の視覚的階層

すべてのアセットを同じサイズとして扱わないでください。階層を確立します:

  • 1つのアセットがヒーロー — 最も多くの画面スペース(50〜80vw)、depth-3
  • コンパニオンはヒーローの表示サイズの15〜25% — depth-2、ヒーローの端に寄り添う
  • アクセント/パーティクルは極小(1〜5vw) — depth-5
  • 背景を埋めるものはセクション全体をカバー — depth-0

コンパニオンをヒーローに対して calc() を使用して相対配置します: right: calc(50% - [hero-half-width] - [gap]) でヒーローの端の近くに配置します。

ヒーローがスクロールに応じて成長したり画面外に出たりするとき、コンパニオンは散らばるように外側へ移動します — 単にフェードアウトするだけではありません。これにより、コンパニオンがヒーローの周りを周回していたことが強調されます。

D. 各アセットの映画的役割を決定する

各画像について、次のように自問してください: 「これはスクロールストーリーで何をするのか?」

  • ヒーローの横に浮かぶ → depth-2、フロートループ、スクロールアウト時に散乱
  • ヒーローそのもの → depth-3、弾性的なドロップイン、スクラブで成長
  • DJIスケールイン中にセクションを埋める → depth-0 または全セクション背景
  • サイドバーにあり、コンテンツがスクロールする間そこにある → スティッキーカラムジャーニー
  • セクションの端を装飾 → depth-2、クリップパスによる出現

ステップ2 — テクニックを選択する(決定エンジン)

ユーザーの意図を適切なテクニックの組み合わせにマッチングします。詳細なテクニックは references/ ファイルから読んでください。

プロジェクトタイプ別

ユーザーの発言主要パターンテキストテクニック特殊効果
製品ローンチ / ブランドサイトセクション間フローティング製品 + パースペクティブズームスプリットコンバージ + ワードライティングDJIスケールインピン
大きなタイトルのヒーロー6層パララックス + ピン止めスティッキーオフセットダイアゴナル + マスクラインリビールブリードタイポグラフィ
映画的セクションカーテンパネルロールアップ + スクラブタイムライン劇的な入場+退場トップダウンクリップ出現
Appleスタイルのアニメーションスクラブタイムライン + クリップパスワイプ単語単位のスクロールライティングキャラクターシリンダー
セクション間の要素フローティング製品 + クリップパス出現スクランブルテキストウィンドウペンアイリス
カード / 機能セクションカスケーディングカードスタックスキュー + 弾性バウンスセクションピール
ポートフォリオ / ショーケース水平スクロール + フリップモーフラインクリップワイプダイアゴナルワイプ
SaaS / スタートアップウィンドウペンアイリス + スタッガードグリッド可変フォントウェーブ曲線パス移動

リクエストされたスクロール動作別

  • 「変化している間はそのまま」 → pin: true + スクラブタイムライン
  • 「セクションから浮かび上がる」 → セクション間フローティング製品 + クリップパス出現
  • 「上から生まれる」 → トップダウンクリップ出現 または カーテンパネルロールアップ
  • 「重なる/スタックする」 → カスケーディングカードスタック または セクションピール
  • 「テキストが横から飛び込む」 → スプリットコンバージ または オフセットダイアゴナルレイアウト
  • 「テキストが単語ごとに光る」 → 単語単位のスクロールライティング
  • 「セクション全体が変形する」 → ウィンドウペンアイリス + スクラブタイムライン
  • 「セクションが落下する」 → クリップパス inset(0 0 100% 0) → inset(0)
  • 「カーテンのように」 → カーテンパネルロールアップ
  • 「円が開く」 → サークルアイリス拡大
  • 「セクション間を移動する」 → GSAP Flip クロスセクション または 曲線パス移動

ステップ3 — すべての要素をレイヤー化する

作成するすべての要素には、深度レベルを割り当てる必要があります。これは絶対条件です。

DEPTH 0 → 遠方背景         | パララックス: 0.10x | ブラー: 8px  | スケール: 0.70
DEPTH 1 → グロー/雰囲気    | パララックス: 0.25x | ブラー: 4px  | スケール: 0.85
DEPTH 2 → 中間装飾         | パララックス: 0.50x | ブラー: 0px  | スケール: 1.00
DEPTH 3 → メインオブジェクト | パララックス: 0.80x | ブラー: 0px  | スケール: 1.05
DEPTH 4 → UI / テキスト     | パララックス: 1.00x | ブラー: 0px  | スケール: 1.00
DEPTH 5 → 前景エフェクト   | パララックス: 1.20x | ブラー: 0px  | スケール: 1.10

HTML要素に data-depth="3" として適用し、CSSクラス .depth-3 と一致させます。

→ 完全な深度システムの詳細: references/depth-system.md


ステップ4 — アクセシビリティとパフォーマンスを適用する(常に)

これらはすべての出力で必須です:

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
  • アニメーション対象は transform、opacity、filter、clip-path のみ — width/height/top/left は絶対に使用しない
  • will-change: transform はアクティブにアニメーションする要素にのみ使用し、アニメーション後は削除する
  • 画面外のセクションには content-visibility: auto を使用する
  • IntersectionObserver を使用してビューポート内の要素のみをアニメーションする
  • モバイルを検出: window.matchMedia('(pointer: coarse)') — タッチデバイスではエフェクトを軽減する

→ 詳細: references/performance.md および references/accessibility.md


ステップ5 — コード構造(常にこのHTMLアーキテクチャを使用する)

<!-- セクションラッパー — すべてのセクションはこのパターンに従う -->
<section class="scene" data-scene="hero" style="--scene-height: 200vh">
  
  <!-- 深度レイヤー — 常に最低3レイヤー以上 -->
  <div class="layer depth-0" data-depth="0" aria-hidden="true">
    <!-- 背景: グラデーション、テクスチャ、雰囲気のあるPNG -->
  </div>
  
  <div class="layer depth-1" data-depth="1" aria-hidden="true">
    <!-- グローブロブ、光のエフェクト、雰囲気のあるヘイズ -->
  </div>
  
  <div class="layer depth-2" data-depth="2" aria-hidden="true">
    <!-- 中間装飾、浮遊する形状 -->
  </div>
  
  <div class="layer depth-3" data-depth="3">
    <!-- メイン製品 / ヒーロー画像 — 主役 -->
    <img class="product-hero float-loop" src="product.png" alt="[説明]" />
  </div>
  
  <div class="layer depth-4" data-depth="4">
    <!-- テキストコンテンツ — 見出し、本文、CTA -->
    <h1 class="split-text" data-animate="converge">見出し</h1>
  </div>
  
  <div class="layer depth-5" data-depth="5" aria-hidden="true">
    <!-- 前景パーティクル、きらめき、オーバーレイ -->
  </div>

</section>

→ 完全なボイラープレート: assets/hero-section.html → 完全なCSSシステム: assets/hero-section.css → 完全なJSエンジン: assets/hero-section.js


リファレンスファイル — 詳細なテクニックについてはこれらを読む

ファイル内容いつ読むか
references/asset-pipeline.mdアセット検査、背景判断ルール、ユーザー通知形式、CSSノックアウト、リサイズターゲット常に — コーディング前に必ず実行
references/cursor-microinteractions.mdカスタムカーソル、パーティクルバースト、磁気ホバー、傾きエフェクトインタラクティブなプレミアムサイトを構築するとき
references/depth-system.md6層深度モデル、CSS/JS実装、ブラー/スケール計算式すべてのプロジェクト — 常に読む
references/motion-system.md完全なGSAPコード付き9つのスクロールアーキテクチャパターンスクロールインタラクションを構築するとき
references/text-animations.md完全な実装コード付き13のテキストテクニックテキストをアニメーションするとき
references/directional-reveals.md「上/横から出現」する8つのクリップパステクニックセクションに方向性のあるエントリーが必要なとき
references/inter-section-effects.mdフローティング製品、GSAP Flip、セクション間移動製品/要素がセクションをまたがるとき
references/performance.mdGPUルール、will-change、IntersectionObserverパターン常に — 絶対ルール
references/accessibility.mdWCAG 2.1 AA、prefers-reduced-motion、ARIA常に — 絶対ルール
references/examples.md5つの完全な実世界実装ユーザーがフルページサイトを必要とするとき

プロアクティブトリガー

コンテキストで気付いたときに、質問されずにこれらの問題を提起します:

  • ユーザーがJPEG製品画像をアップロードした → JPEGには透明度がないことを指摘し、アセットインスペクターの実行を提案する
  • すべてのアセットが同じサイズである → 構図階層の問題を指摘し、ヒーロー + コンパニオンサイズ設定を推奨する
  • 深度割り当てが言及されていない → すべての要素に深度レベル(0〜5)が必要であることを思い出させる
  • ユーザーが「スムーズなアニメーション」を要求しているが、動き軽減の処理がない → アクセシビリティ要件を指摘する
  • パララックスが要求されているが、パフォーマンス最適化がない → will-change と GPU アクセラレーションルールを指摘する
  • 80を超えるアニメーション要素がある → パフォーマンスの問題を指摘し、削減または遅延読み込みを推奨する

出力アーティファクト

リクエストすると...得られるもの...
「ヒーローセクションを構築して」インラインCSS/JS、6深度レイヤー、アセット監査、テクニックリストを含む単一HTMLファイル
「映画的に感じさせて」GSAPセットアップによるスクラブタイムライン + パララックス + テキストアニメーションの組み合わせ
「画像を検査して」背景ステータス、深度割り当て、リサイズ推奨を含むアセット監査レポート
「Appleスタイルのスクロール効果」単語単位のライティング + ピン止めセクション + パースペクティブズームの実装
「パフォーマンス問題を修正して」GPU最適化チェックリストとwill-change監査を含む検証レポート

コミュニケーション

すべての出力は、構造化されたコミュニケーション標準に従います:

  • 最初に結論を — コードを生成する前に、アセット監査と深度計画を表示する
  • 何 + なぜ + どのように — すべてのテクニックの選択を説明(なぜこのムードにこのアニメーションなのか)
  • アクションには所有者がいる — 「透過PNGを提供する必要があります」と言い、「PNGが提供されるべきです」とは言わない
  • 信頼度タグ付け — 🟢 検証済みテクニック / 🟡 実験的 / 🔴 ブラウザサポートが限定的

クイックルール(絶対条件)

0a. ✅ コーディング前に常にアセット検査を実行する — すべての画像のフォーマット、背景、サイズを確認する。構築前にユーザーに深度割り当てを伝える。 0b. ✅ 背景を削除する必要があるかどうかを常に判断する — すべての画像に必要とは限らない。各アセットのステータスをユーザーに通知し、背景を問題として扱う前に確認を得る。自動削除はせず、黙って無視もしない。

  1. ✅ すべてのセクションに最低3つの深度レイヤーがあること
  2. ✅ すべてのテキスト要素に少なくとも1つのアニメーションテクニックを使用すること
  3. ✅ すべてのプロジェクトに prefers-reduced-motion フォールバックを含めること
  4. ✅ GPUセーフなプロパティのみアニメーションする: transform、opacity、filter、clip-path
  5. ✅ 製品画像はデフォルトで常にdepth-3に割り当てること
  6. ✅ 背景画像は常にdepth-0とし、わずかにブラーをかけること
  7. ✅ あらゆる「ヒーロー」要素にフローティングループ(6〜14秒、決して完全に静止させない)
  8. ✅ すべての装飾要素に aria-hidden="true" を設定すること
  9. ✅ モバイルでは pointer: coarse 検出を使用してエフェクトを軽減すること
  10. ✅ will-change はアニメーション完了後に削除すること

出力形式

A

…

[翻訳用に切り詰められました]

関連スキル