Communitygithub.com

muhammedadnank/Antigravity-Skills

將一段短影片轉換為單頁式捲動驅動電影著陸頁。使用者提供 5–15 秒的影片(通常是 AI 生成),此技能會擷取每一幀為 HD JPEG,然後產生一個英雄式 HTML 頁面,使用者的捲動手勢能在原地逐幀撥放影片(頁面本身不捲動),並有 5 個戲劇性文字疊層淡入淡出。

Antigravity-Skills 是什麼?

這個技能專為將短影片素材(5–15 秒)轉換成一個鎖定視窗的電影級著陸頁而設計。使用者只需提供一段影片(通常是 AI 生成的短片),技能就會以 HD 品質(-q:v 2)擷取每一幀,並生成一個自給自足的 HTML 頁面。頁面會攔截使用者的捲動、觸控或鍵盤輸入,並轉換為虛擬幀進度,從而實現逐幀撥放影片的效果。同時,五個文字場景(包含 Anton 大寫標題和 Caveat 手寫體強調)會根據預先定義的進度窗口依序淡入淡出,營造戲劇性的敘事體驗。此技能支援兩種部署模式:獨立模式(在指定位置建立全新專案資料夾)或整合模式(將新頁面加入到現有的 'examples/parasites/' 展示集合中)。工作流程包含四個階段:確認使用者提供的影片路徑、代號、主題與強調色;使用內建指令碼擷取所有幀;填充一個包含所有佔位符的 HTML 範本;並複製共用的 style.css 與 parallax.js 檔案。產出的最終作品是一個鎖定、無法實際捲動的頁面,所有互動都透過 ParallaxPage JavaScript 類別處理。這個技能也負責生成電影風格的文案(參考 bundled 的 copy-guide.md)。若整合到既有展示中,它會自動更新導覽列、索引頁面卡片,並在相鄰頁面之間建立「下一頁」CTA 連結。

相容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/muhammedadnank/Antigravity-Skills/tree/HEAD/skills/parallax-landing-page

在你喜歡的 AI 中提問

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

說明文件

視差著陸頁

將一段短影片變成一個單畫面電影級著陸頁,使用者的捲動手勢會逐幀撥放影片,同時五個戲劇性文字場景會淡入淡出。文件本身實際上不會捲動——滑鼠滾輪、觸控、鍵盤輸入都會在 JS 中被攔截,並轉換為虛擬幀進度。

此技能編碼了捆綁參考資料(位於 ../../examples/parasites/)中驗證過的樣式(github / lion / hope 著陸頁——三個使用此技能構建的工作頁面)。如果這裡有任何歧義,請以該資料夾為最終依據。

此技能在 YUV.AI 層級中的位置

parallax-landing-page 位於 YUV.AI 技能金字塔的中間層,與 yuv-design-system、yuv-decks、yuv-viral-video 和 video-to-landing-page 並列。頂層協調器 yuv-pilot 會在需要將 5–15 秒的影片剪輯變成單一英雄式捲動撥放著陸頁時,將任務路由到此處。

此技能使用自己的視覺語言(Anton + Caveat + Inter,金色/琥珀色/強調色/奶油色調色板)——它不會呼叫 yuv-design-system。這兩個系統共存:yuv-design-system 負責跨網頁/應用程式/簡報表面的品牌調色板,而 parallax-landing-page 專門負責電影級捲動撥放美學。對於 YUV.AI 視差著陸頁,你可以選擇性地在頁尾區域添加一個鳳凰浮水印和標準的 Linktree URL,作為品牌貫穿線——請參閱 yuv-design-system/assets/ 以取得浮水印檔案。請勿將 Anton/Caveat 字體堆疊替換為設計系統的霓虹調色板——這會失去標誌性的外觀。

你要構建的內容

每個著陸頁都是一個鎖定的視口,包含:

  • 一個填滿整個螢幕的畫布,一次繪製一幀(cover-fit,DPR ≤ 2)
  • 5 個絕對定位的文字場景(前引 + 大寫 Anton 標題 + Caveat 手寫體行),每個都有各自的捲動進度窗口
  • 一個固定導航欄,帶有 PARALLAX // showcase 標誌和指向同級著陸頁的連結
  • 一個載入器,在使用者互動前預載每一幀
  • 一個暗角 + 底片顆粒疊層
  • 一個底部捲動提示,使用者開始捲動後淡出
  • 一個右下角幀計數器(例如 073 / 145)
  • 最終場景就是 CTA 區塊——下方沒有單獨的 .end 區塊

在 q:v 2 時總大小:大約每幀 120–220 KB × 幀數。一個 6 秒 24fps 的剪輯 = 145 幀 ≈ 25 MB。一個 10 秒的剪輯 = 241 幀 ≈ 53 MB。

儲存位置

預設: ~/Documents/yuv-projects/landings/<slug>/——始終將獨立著陸頁儲存在此處,以便之後再次找到它們。只有在使用者明確選擇不同位置,或者選擇模式 B(整合到現有的 examples/parasites/ 展示)時才覆蓋。

mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 技能在提取幀和構建 HTML 時會在此處建立 <slug>/。

最終路徑(模式 A——獨立):~/Documents/yuv-projects/landings/<slug>/。 最終路徑(模式 B——整合):使用者選擇的現有展示目錄。

在每次建置結束時告知使用者最終路徑。


工作流程

共有四個階段。請勿跳過任何階段——每個階段都為下一個階段提供輸入。

階段 1——發現

與使用者確認:

  1. 影片路徑——來源 MP4 檔案的位置。
  2. 代號——簡短的資料夾/檔案名稱(例如 hope、marcus、desk)。單詞,小寫,無空格。這將成為幀資料夾名稱(<slug>/)和 HTML 檔案名稱(<slug>.html)。
  3. 主題/話題——這個著陸頁是關於什麼的?產品發佈?個人時刻?野生動物遭遇?你需要這些資訊來撰寫文案。
  4. 專案模式——獨立(全新的資料夾)或整合到位於 examples/parasites/ 的現有寄生蟲展示中(此儲存庫的頂層)。如果使用者說「將其加入展示」,則表示模式 B。
  5. 強調色——用於腳本/CTA 高亮:gold (#f5b042),amber (#ff8a3d),accent (粉紅色 #ff4d6d),cream (#f5e9d4),或新的顏色(將其添加到 style.css 中的 :root,並撰寫新的 .script.<name> 規則)。

如果使用者尚未指定其中一些項目,請提出預設值並繼續——不要在他們看到結果後才能回答的問題上耽擱。

階段 2——提取幀

執行捆綁的提取腳本。它會用 ffprobe 探測影片,並以原生解析度、-q:v 2(近乎無損的 JPEG)提取每一幀,命名為 frame-001.jpg 到 frame-NNN.jpg(3 位數零填充)。

python <skill>/scripts/extract_frames.py <video_path> <output_folder>

範例:

python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
    C:/Users/User/Documents/parasites/hope/hope.mp4 \
    C:/Users/User/Documents/parasites/hope

腳本會將 JSON 中繼資料區塊輸出到 stdout。擷取它——你需要 frame_count 和 suggested_scroll_budget 來產生 HTML。

為什麼用 -q:v 2:ezgif 和類似工具會積極地重新壓縮(約 55 KB/幀)。原生 ffmpeg 在 q:v 2 時,在相同尺寸下約為 120–220 KB/幀——視覺上更清晰。請勿縮小;永遠不要放大(這會無端增加檔案大小而不增加細節)。

為什麼用滾動預算公式(每幀約 26 像素):讓「每前進一幀所需的滾動像素數」在不同剪輯長度下保持不變。145 幀 → 約 4200,241 幀 → 約 6300,90 幀 → 約 2500(下限)。腳本會為你計算並限制在 [2500, 8000] 範圍內。

階段 3——撰寫頁面

閱讀 <skill>/assets/landing-page-template.html 中的範本。它是一個完整的可運作檔案,帶有 {{PLACEHOLDER}} 標記和創意部分旁邊的 <!-- TODO: --> 註解。在 <target>/<slug>.html 中建立一個新檔案,並替換所有內容。

替換檢查清單(必須替換每個佔位符):

佔位符要填入的內容範例
{{PAGE_TITLE}}HTML <title>Hope — The Fastest Heart in the Negev
{{PAGE_DESCRIPTION}}meta 描述,一句話A moment with Hope, the cheetah of Midbarium.
{{SLUG}}資料夾名稱(無路徑,無斜線)hope
{{FRAME_COUNT}}整數幀數241
{{FRAME_COUNTER_TEXT}}001 / NNN 並具有匹配的寬度001 / 241
{{SCROLL_BUDGET}}來自提取器 JSON 的整數6300
{{PREVIEW_FRAME_MID}}零填充的中間幀121
{{PREVIEW_FRAME_END}}零填充的最後一幀241
{{LOADER_TITLE}}一個單詞,大寫HOPE
{{LOADER_SCRIPT}}手寫體行,以 … 結尾summoning the runner…
{{NAV_LINKS_HTML}}導航欄的完整 <a> 標籤區塊見下文
{{SCENE_N_*}}5 個場景各自的前引、標題、手寫體行見文案指南
{{SCROLL_HINT_TEXT}}2–4 個單詞的大寫提示SCROLL TO RUN
{{CTA_BUTTONS_HTML}}2–4 個 <a class="cta"> 標籤見下文
{{ACCENT_CLASS}}.script.X 和 .cta.X 的強調色後綴amber

閱讀 references/copy-guide.md 以了解電影風格的文案模式(前引措辭、標題長度、手寫體行語氣)。文案是此技能的價值所在——通用文案會毀掉一個原本漂亮的動畫。

階段 4——連接資源

如果目標資料夾已經有 style.css 和 parallax.js(展示整合),則無須操作——它們是共用的。否則,從 <skill>/assets/ 將兩者複製到目標資料夾:

cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js

如果整合到現有展示中,還需要執行 references/showcase-integration.md 中的步驟——將卡片添加到 index.html,將連結添加到每個現有著陸頁的導航欄,並在前一個著陸頁的最終場景中添加連結 CTA。

告訴使用者如何檢視:

從父資料夾透過 python -m http.server 8000 開啟 <target>/<slug>.html(不要用 file://——Chromium 可能會因為本地圖片來源而污染畫布)。

檔案約定

<target>/
├── <slug>/                  # 幀資料夾
│   ├── <slug>.mp4           # 來源(保留)
│   ├── frame-001.jpg
│   ├── frame-002.jpg
│   └── … frame-NNN.jpg
├── <slug>.html              # 著陸頁
├── style.css                # 共用(如果是獨立則複製)
├── parallax.js              # 共用(如果是獨立則複製)
└── index.html               # 中樞(僅當獨立或整合時)

幀資料夾名稱和 HTML 檔案名稱必須使用相同的代號——頁面 new ParallaxPage({folder: '<slug>', ...}) 呼叫中的 folder 選項就是文字上的資料夾路徑。

ParallaxPage API(已在 parallax.js 中,請勿重新定義)

new ParallaxPage({
  folder:       '<slug>',     // 包含 frame-001.jpg 等的資料夾
  frameCount:   145,          // 整數
  prefix:       'frame-',     // 此技能始終為 'frame-'
  scrollBudget: 4200,         // 完整通過所需的累積輸入像素
  // 可選:padWidth(預設 3),ext(預設 'jpg')
})

該類別會自動附加 body.scrub-page(透過 CSS 鎖定捲動),預載所有幀,執行一個基於 RAF 的 lerp(0.22 係數)朝向由捲動得出的目標幀,並淡入淡出 data-start/data-end 範圍包含目前進度的場景。

硬性限制(不容妥協)

這些限制已融入參考實作中,違反會破壞體驗:

  • 5 個場景,固定進度窗口:0.00–0.20、0.22–0.40、0.42–0.60、0.62–0.80、0.82–1.00。場景之間的 0.02 間隙是故意的——這是節拍之間「只有圖像,沒有文字」的時刻。英雄場景(場景 1)和最終場景(場景 5)分別使用 data-fade="0.30" 和 data-fade="0.18",以便在邊緣停留更長時間;中間場景使用預設的 0.25。
  • 撥放區域下方沒有 .end 區塊。最終場景包含 CTA。整個頁面是一個鎖定的視口。
  • Anton + Caveat + Inter——大寫 Anton 用於所有粗體文字,Caveat 用於手寫體強調(金色/琥珀色/奶油色),Inter 用於任何主體引導文字。切勿替換,切勿添加第四種字體。
  • 米白色 #f5f1ea,永遠不是 #fff——已在 CSS 中作為 var(--text)。
  • 幀名稱是 frame-NNN.jpg,零填充至總數的位數(3 位數是標準,因為剪輯 < 1000 幀;JS 會根據總數自動計算計數器寬度)。
  • 代號既是資料夾名稱,也是 HTML 檔案的基本名稱——hope/、hope.html。無例外;整合步驟依賴此約定。

卡住時去哪裡查閱

  • 此儲存庫中捆綁的參考展示:examples/parasites/——github.html、lion.html、hope.html、style.css、parallax.js、index.html。如果你的輸出與這些在視覺上有明顯差異,表示你已偏離;請重新閱讀。
  • references/copy-guide.md——如何撰寫 5 個場景才能真正具有電影感。
  • references/showcase-integration.md——添加到現有中樞時所需的確切編輯。
  • assets/landing-page-template.html——帶有佔位符的標準結構。
  • assets/hub-template.html——僅在從頭開始建立全新的展示時使用(3 張卡片)。

兩個真實的範例呼叫

獨立: 使用者有一段剪輯 desk.mp4,並想要一個著陸頁。

  1. 詢問代號和主題。對 desk.mp4 執行提取器 → ./desk/frame-NNN.jpg。
  2. 將 style.css + parallax.js 複製到專案根目錄。
  3. 從範本撰寫 desk.html。導航欄只有一個連結:自己。
  4. 完成。告知使用者使用 python -m http.server 提供服務。

展示新增: 使用者將 hope.mp4 新增到現有的寄生蟲資料夾。

  1. 代號 = hope。提取 → hope/frame-NNN.jpg。(重複使用現有的 style.css + parallax.js。)
  2. 從範本撰寫 hope.html。
  3. 執行展示整合:將第三張卡片新增到 index.html,將 Hope 連結附加到 github.html 和 lion.html 的導航欄,將前一個著陸頁的最終場景連結為 Next: Hope → CTA。
  4. 如果引入新的強調色,請將其新增到 :root 中,並在 style.css 中新增 .script.X + .cta.X 規則。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

muhammedadnank/Antigravity-Skills

Build a premium cinematic landing page with mouse-scrub video hero and brand-driven narrative-arc sections. Use whenever the user provides a hero video plus a product / subject / brand and wants a landing page, promo site, product showcase, marketing page, or storytelling site. Works for any language and any subject. The signature effect is mouse-driven video scrubbing \u2014 the hero video lives across the entire page as a fixed backdrop, and moving the mouse left-right scrubs the video timeline so the subject responds to the cursor. Below the hero, 4-5 fully-opaque sections each carry their own brand identity (color, typography emphasis, layout pattern) and walk the viewer through a narrative arc (e.g. longing -> joy -> nostalgia -> contemplation -> action). Do NOT use for parallax frame-scrub landings where the page itself doesn't scroll (use parallax-landing-page instead) or for video editing / captioning workflows (use video-edit).

muhammedadnank/Antigravity-Skills

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

muhammedadnank/Antigravity-Skills

Best practices for Remotion - Video creation in React

muhammedadnank/Antigravity-Skills

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

muhammedadnank/Antigravity-Skills

Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video. Use when the user provides a video file and asks for "a landing page from this video", "scroll-frame website", "Apple-style scroll site", "hero that scrubs the video", "like the GitHub Copilot landing", or any equivalent. Extracts N evenly-spaced frames via ffmpeg, builds a self-contained HTML page with a sticky hero + JS scroll listener that swaps the visible frame as you scroll, plus headline, sections and CTA below. For YUV.AI projects, applies the yuv-design-system skill in Neon mode (pink/cyan/white, default for YUV.AI web) — Decks (purple/yellow) is reserved for slides only. For generic / non-YUV.AI projects, picks an appropriate palette per the source video. Output is one folder with `index.html` and a `frames/` directory — drop on any static host.

相關技能