Communitygithub.com

Patasse97/claude-skills

没入感のある映画的な2.5DインタラクティブWebサイトをスクロールストーリーテリングで構築します。

claude-skills とは?

このスキルは、フラットなPNG/静的アセット、CSS、JavaScriptのみを使用して、プレミアムで生き生きとした映画的なWeb体験を構築するための包括的なフレームワークです。WebGLや3Dモデリングソフトウェアは必要ありません。AppleのプロダクトページやAwwwards受賞サイトのような、階層(奥行きレイヤー0~5)、スクロールベースのアニメーション(スクラブタイムライン、パララックス、クリップパス・リビールなど)、そして意図的なテキストエントリー/イグジットを備えた没入型Webサイトを作成するための、詳細な5ステップのワークフローを提供します。このスキルは、ゼロからの構築、既存サイトの強化、デバッグの3つのモードをサポートしており、アセット検査、奥行き割り当て、パフォーマンスとアクセシビリティのベストプラクティス(prefers-reduced-motion、GPUセーフなプロパティ、IntersectionObserver)に関する厳格なガイドラインを含んでいます。Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、開発者がコードを1行も書く前に、映画的なビジュアル階層とスクロールストーリーを計画的に設計できるようにします。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Patasse97/claude-skills/tree/HEAD/engineering-team/epic-design

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

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

プレビュー

スキル README より

claude-skills 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ルールを確認し、reduced-motionの処理を検証してください。


ステップ1 — 概要を理解し、すべてのアセットを検査する

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

A. 概要を抽出する

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

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

ユーザーが提供したすべての画像に対して scripts/inspect-assets.py を実行してください。 各画像について、以下を判断します:

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

  2. 背景ステータス — スクリプトの出力を使用します。以下の情報が得られます:

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

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

    • 孤立した製品(ボトル、靴、ガジェット、果物、スタジオ背景上のオブジェクト)
    • シーン内に浮かせることを意図したキャラクターや人物
    • 任意の背景に透過的に配置されるロゴやアイコン
    • depth-2 または depth-3 に浮遊アセットとして配置される要素

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

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

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

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

  5. サイズと奥行きの割り当て — 各アセットが属する奥行きレベルを決定し、それに応じてサイズを変更します。構築を開始する前に、決定事項をユーザーに伝えてください。

C. 構成計画 — コードを1行も書く前の視覚的階層

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

  • 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.10倍 | ブラー: 8px  | スケール: 0.70
DEPTH 1 → グロー/雰囲気    | パララックス: 0.25倍 | ブラー: 4px  | スケール: 0.85
DEPTH 2 → 中間装飾        | パララックス: 0.50倍 | ブラー: 0px  | スケール: 1.00
DEPTH 3 → メインオブジェクト | パララックス: 0.80倍 | ブラー: 0px  | スケール: 1.05
DEPTH 4 → UI / テキスト    | パララックス: 1.00倍 | ブラー: 0px  | スケール: 1.00
DEPTH 5 → 前景エフェクト   | パララックス: 1.20倍 | ブラー: 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.md8つの「上/横から生まれる」クリップパス技術セクションに方向性のあるエントリーが必要なとき
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)が必要であることを思い出させる
  • ユーザーが「スムーズなアニメーション」を要求しているが、reduced-motion処理がない → アクセシビリティ要件を指摘する
  • パララックスが要求されているが、パフォーマンス最適化がない → will-changeとGPU加速ルールを指摘する
  • 80以上のアニメーション要素がある → パフォーマンスの問題を指摘し、削減または遅延ロードを推奨する

出力アーティファクト

リクエスト得られるもの
「ヒーローセクションを構築して」インラインCSS/JS付き単一HTMLファイル、6つの奥行きレイヤー、アセット監査、技術リスト
「映画的に感じさせて」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 によりエフェクトを減らす

関連スキル