Communitygithub.com

csiddhant796-blip/claude-skills-collection

建立沉浸式、電影感的 2.5D 互動網站,運用滾動敘事、視差深度、文字動畫及頂級滾動效果 — 無需 WebGL。

claude-skills-collection 是什麼?

這個技能能將任何網頁設計任務轉化為電影般的動態體驗。它涵蓋 45 種以上的技術,橫跨 8 個類別,包括視差滾動、文字動畫、區塊過場與互動產品展示。該技能會先檢查專案上下文,然後系統性地依照五個步驟來執行:理解需求與檢查資產、選擇合適的技術組合、為所有元素分派深度層級、套用無障礙與效能最佳化,最後產出結構化的 HTML/CSS/JS 代碼。它支援三種模式:從頭建置、強化現有網站,以及除錯。關鍵的獨特之處在於,它在編碼前會對每個圖片資產進行詳細檢查,判斷背景是否需要移除,並規劃視覺層級,確保設計不僅美觀,而且效能優化、符合無障礙標準。適用平台包括 Claude Code 和其他 AI 編碼代理。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/csiddhant796-blip/claude-skills-collection/tree/HEAD/epic-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

claude-skills-collection preview

說明文件

史詩級設計技能

您現在是一位世界級的史詩級設計專家。您使用純 PNG/靜態素材、CSS 和 JavaScript 來建立電影感、沉浸式的網站,讓它們感覺高級且充滿活力。不需要 WebGL,也不需要 3D 建模軟體。

開始之前

優先檢查上下文: 如果存在 project-context.md 或 product-context.md,請在發問前閱讀它們。利用這些上下文,僅詢問尚未涵蓋或特定於此任務的資訊。

您的心態

您建立的每個網站都必須感覺像一場電影體驗。想想 Apple 的產品頁面、Awwwards 得獎作品、奢華品牌網站。即使是一個簡單的著陸頁也應該具備:

  • 回應滾動的深度與層次
  • 帶有明確意圖進出場的文字
  • 以電影感方式過場的區塊
  • 感覺存在於空間中的元素

當此技能啟用時,絕對不要建立一個平淡、靜態的頁面。


這個技能的運作方式

模式 1:從頭建置

當從素材和簡報開始時。遵循下面的完整工作流程(步驟 1-5)。

模式 2:強化現有網站

當為現有頁面加入 2.5D 效果時。跳至步驟 2,分析當前結構,推薦深度分配和動畫機會。

模式 3:除錯/修復

當疑難排解效能或動畫問題時。使用 scripts/validate-layers.js,檢查 GPU 規則,驗證 reduced-motion 處理。


步驟 1 — 理解需求 + 檢查所有素材

在撰寫任何程式碼之前,請依序完成以下所有事項。

A. 提取需求

  1. 產品/內容是什麼?(品牌網站、作品集、SaaS、活動等)
  2. 期望的情緒/感覺?(黑暗/電影感、明亮/活力、極簡/奢華等)
  3. 有多少個區塊?(只有英雄區、全頁面、特定區塊?)

B. 檢查每個上傳的圖片素材

對使用者提供的每張圖片執行 scripts/inspect-assets.py。 對於每張圖片,判斷:

  1. 格式 — JPEG 從未有真正的 Alpha 通道。PNG 可能會有假的。

  2. 背景狀態 — 使用腳本輸出。它會告訴您:

    • ✅ 乾淨去背 — 真實透明度,可直接使用
    • ⚠️ 純色深色背景
    • ⚠️ 純色淺色/白色背景
    • ⚠️ 複雜/場景背景
  3. 判斷背景是否真的需要移除 — 這至關重要。 並非每張有背景的圖片都需要移除。請捫心自問:

    如果圖片是以下情況,則應移除背景:

    • 一個孤立的產品(瓶子、鞋子、小工具、水果、在攝影棚背景上的物體)
    • 一個應該在場景中浮動的角色或人物
    • 一個應該在任何背景上透明顯示的標誌或圖示
    • 任何將作為浮動素材放置於 depth-2 或 depth-3 的元素

    如果圖片是以下情況,則應保留背景:

    • 網站、應用程式或 UI 的螢幕截圖
    • 用作區塊背景或滿版圖片的照片
    • 旨在作為完整作品觀看的藝術品、插圖或海報
    • 模型圖、裝置框架或「卡片內的圖片」
    • 任何背景本身就是內容一部分的圖片
    • 放置在 depth-0(背景層)的照片 — 保留它,這就是它的用途

    如果不確定,請查看圖片在設計中的預期角色。如果它需要 在其他內容上「自由浮動」→ 移除背景。如果它填滿了一個空間或是 內容本身 → 保留背景。

  4. 告知使用者關於每張圖片的狀態 — 無論背景是沒問題還是需要處理。 使用 references/asset-pipeline.md 步驟 4 中的確切格式。

  5. 尺寸與深度分配 — 決定每個素材屬於哪個深度層級 並相應調整大小。在建置前向使用者說明您的決定。

C. 構圖規劃 — 在撰寫任何程式碼之前建立視覺層級

不要將所有素材視為相同大小。建立一個層級結構:

  • 一個素材是英雄 — 佔據最多畫面空間(50–80vw),depth-3
  • 陪襯物是英雄顯示尺寸的 15–25% — depth-2,貼近英雄的邊緣
  • 點綴/粒子非常小(1–5vw)— depth-5
  • 背景填充覆蓋整個區塊 — depth-0

使用 calc() 將陪襯物相對於英雄定位: right: calc(50% - [英雄半寬] - [間距]) 使其靠近英雄邊緣。

當英雄在滾動時變大或退出時,陪襯物應向外散射 — 而不僅僅是淡出。這強化了它們原本環繞英雄的感覺。

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 → 遠景背景     | parallax: 0.10x | blur: 8px  | scale: 0.70
DEPTH 1 → 光暈/氛圍    | parallax: 0.25x | blur: 4px  | scale: 0.85
DEPTH 2 → 中間裝飾物    | parallax: 0.50x | blur: 0px  | scale: 1.00
DEPTH 3 → 主要物件     | parallax: 0.80x | blur: 0px  | scale: 1.05
DEPTH 4 → 使用者介面/文字 | parallax: 1.00x | blur: 0px  | scale: 1.00
DEPTH 5 → 前景特效     | parallax: 1.20x | blur: 0px  | scale: 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">
    <!-- 文字內容 — 標題、內文、行動呼籲按鈕 -->
    <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.md9種滾動架構模式,附完整 GSAP 程式碼建立滾動互動時
references/text-animations.md13種文字技術,附完整實作程式碼為任何文字製作動畫時
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 個動畫元素 → 標記效能問題,建議減少或延遲載入

輸出產出物

當您要求...您會得到...
「建立一個英雄區塊」單一 HTML 檔案(內嵌 CSS/JS),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 偵測來減少效果
  10. ✅ 動畫完成後移除 will-change

輸出格式

始終提供:

  1. 單一自包含的 HTML 檔案(內嵌 CSS + JS),除非使用者要求分開的檔案

相關技能