Communitygithub.com

hoodini/ai-agents-skills

將一段短影片轉換為單螢幕捲動驅動的電影感登陸頁面,使用者滾動時會逐格播放影片,並搭配五段文字場景淡入淡出。

ai-agents-skills 是什麼?

此技能專為將5至15秒的短影片(通常為AI生成)轉換為沉浸式、單螢幕的電影感登陸頁面而設計。它會從影片中提取每個影格,以HD JPEG品質(使用ffmpeg的-q:v 2參數)儲存,然後產生一個單頁HTML頁面,其中使用者的滾動操作會控制影格的前進(頁面本身不會滾動),同時五段文字覆蓋層會根據滾動進度淡入淡出。支援獨立專案模式(建立新資料夾)或整合到現有展示館(例如範例中的「parasites」作品集)中。此技能遵循嚴格的視覺語言,包含Anton(標題)、Caveat(手寫強調)和Inter(內文)字型,以及金/琥珀/強調色/奶油色的色調,並在CSS中鎖定滾動功能,徹底避免傳統的頁面滾動。它會產生約120–220 KB/影格的檔案(以q:v 2品質),對於6秒、24fps的片段,總大小約為25 MB(145個影格)。此技能與Claude Code、Cursor和Codex等AI代理平台相容,可根據使用者意圖(如「將此影片變成登陸頁面」、「建立捲動擦洗登陸頁面」或「為此片段建立視差英雄區」)自動觸發。

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

在你喜歡的 AI 中提問

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

說明文件

視差登陸頁面

將一段短影片轉換為單螢幕的電影感登陸頁面,使用者滾動時會逐格播放影片,同時五段戲劇性的文字場景會淡入淡出。文件本身不會實際滾動——滑鼠滾輪、觸控或鍵盤輸入會透過 JavaScript 攔截,並轉換為虛擬的影格進度。

此技能編碼了本儲存庫中 ../../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)
  • 最終場景就是行動呼籲區塊——之後沒有單獨的 .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. 代號 (Slug) — 簡短的資料夾/檔案名稱(例如 hope、marcus、desk)。一個單字,小寫,無空格。這會同時成為影格資料夾名稱(<slug>/)和 HTML 檔案名稱(<slug>.html)。
  3. 主題 / 話題 — 這個登陸頁面是關於什麼的?產品發布?個人時刻?野生動物邂逅?你需要這些資訊來撰寫文案。
  4. 專案模式 — 獨立(全新資料夾)或整合到現有的 parasites 展示館(位於此儲存庫頂層的 examples/parasites/)。如果使用者說「加到展示館」,他們指的是下方的模式 B。
  5. 強調色 — 用於腳本/行動呼籲反白: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。請擷取它——你的 HTML 需要 frame_count 和 suggested_scroll_budget。

為什麼用 -q:v 2:ezgif 和類似工具會進行積極的重新壓縮(約 55 KB/影格)。原生 ffmpeg 搭配 q:v 2 在相同尺寸下可達到約 120–220 KB/影格——視覺上更銳利。不要縮小解析度;絕對不要放大(它會增加檔案大小而不增加細節)。

為什麼用捲動預算公式(約 26 px/影格):保持「每次影格前進所需的滾動像素數」在不同片段長度下一致。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.Xamber

請閱讀 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 中新增卡片,在每個現有登陸頁面的導覽列中新增連結,並在前一個登陸頁面的最終場景中新增連鎖行動呼籲。

告知使用者如何檢視:

從父資料夾透過 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 區段。最終場景包含行動呼籲。整個頁面是一個鎖定的視窗。
  • Anton + Caveat + Inter——大寫 Anton 用於所有粗體文字,Caveat 用於手寫強調(金/琥珀/奶油色),Inter 用於任何主體引導文字。絕不替換,也絕不新增第四種字型。
  • 近白色 #f5f1ea,絕不使用 #fff——已存在於 CSS 中作為 var(--text)。
  • 影格命名為 frame-NNN.jpg,補零至總影格數的位數(由於片段通常少於 1000 個影格,3 位數是標準;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 新增到現有的 parasites 資料夾。

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

Individual skills in this repo

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

hoodini/ai-agents-skills

Edit any selfie or screen-share footage into a viral short-form video in YUV.AI's signature style — Apple-style liquid-glass cards (real CSS backdrop-filter), dark-mode polish, MrBeast-paced cuts, video-title karaoke captions, premium GSAP motion graphics, no fake content, never covering the speaker's face. Hebrew is rendered in Rubik Black, English in Anton uppercase. Always renders BOTH 9:16 and 16:9 and always saves with _V<N> suffix for backups. Trigger when the user drops a path to an .mp4/.mov/.mkv and says "edit this", "make it viral", "turn this into a short", or any Hebrew equivalent (ערוך סרטון, סרטון ויראלי, להפוך לוויראלי, ריל, שורט). The pipeline is the COMBINATION of two skills: video-use (transcription + word-snapped cuts + base extraction) and hyperframes (HTML/CSS/GSAP visual composition + render). Do NOT use for podcast-only audio edits.

hoodini/ai-agents-skills

Yuval Avidani's YUV.AI brand and design system. Apply ONLY when YUV.AI-branded output is requested — presentations, decks, keynotes, portfolio, brand site, profile, speaker bio, brand assets, or any prompt mentioning YUV.AI / "my brand" / "my deck" / "my site" / "for me". Do NOT auto-trigger on generic "build a game / web app / dashboard / landing page" without YUV.AI context — those use whatever palette fits. Three modes; NEON (hot pink #FF1464 + neon cyan #00E5FF + white, DEFAULT for YUV.AI web, apps, games, dashboards, social, general visual work); DECKS (Fly High purple/yellow/grey, presentations and slides ONLY); Warm Editorial (pink/yellow/bone for Hope, Marcus, bigcats.ai, practical.yuv.ai). Universal Fly High throughline across all modes; flight/progress motifs (HUD strips, dials, "Let's Fly High" tagline, phoenix mark). Anton + Inter (EN), Rubik + Assistant (HE), letter-spacing 0 default. Bundled brand assets, canonical socials, credentials. Project brand wins if specified.

hoodini/ai-agents-skills

Yuval's all-in-one AI video pipeline. Turns an idea/script into a finished, on-brand MP4 by orchestrating HyperFrames (HTML→deterministic video render), Lottie (branded motion graphics), ManimCE (math / neural-network / concept animations), and a transcribe→approve caption flow — all wrapped in the YUV.AI Neon Phoenix brand via a frame.md. Use whenever Yuval wants to make, edit, or explain something as a video: promo, explainer, launch, social reel, "make a video about X", "explain X as a video", "neural network animation", "turn this into a video", captioned tutorial, 16:9 or 9:16. Triggers: video, explainer, promo, reel, manim, lottie, hyperframes, animation, "make a video", "explain ... as a video", מצגת וידאו, סרטון, הסבר וידאו. Routes each beat to the right engine, wraps in brand, self-verifies, and renders.

hoodini/ai-agents-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 (RTL or LTR — Hebrew, English, Arabic, Spanish, French, Japanese, etc.) and any subject (food, tech, animals, fashion, services, SaaS, wildlife campaigns, music releases, books, real estate). The signature effect is mouse-driven video scrubbing — 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). Triggers on phrases like "build a landing page from this video", "cinematic landing ...

hoodini/ai-agents-skills

Edit any video into a captioned showcase — transcribe (any language, defaults to large-v3), present a transcript_review.txt for the user to fix mishears BEFORE rendering, then build a HyperFrames composition with liquid-glass caption pills, liquid blob background, liquid morph wipes, optional behind-subject text via background removal, and render the final video. Use whenever the user provides a video file and asks to edit it, caption it, add subtitles, fix existing captions, make a reel/promo/captioned tutorial, or "do the same" pattern as a prior captioned video. Supports English, Hebrew, and any Whisper-supported language. **Renders both 16:9 (YouTube / horizontal) and 9:16 (TikTok / Instagram Reels / YouTube Shorts) from the SAME 16:9 source** — vertical mode uses a centered footage strip with a blurred backdrop + liquid blobs and a vertical-tuned caption pill, no need to re-shoot. THE PIPELINE PAUSES FOR USER APPROVAL on the transcript before final render — this is the support mechanism for getting ca...

hoodini/ai-agents-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.

hoodini/github-trending

Fetch and display GitHub trending repositories and developers. Use when building dashboards showing trending repos, discovering popular projects, or tracking GitHub trends. Triggers on GitHub trending, trending repos, popular repositories, GitHub discover.

hoodini/mongodb

Work with MongoDB databases using best practices. Use when designing schemas, writing queries, building aggregation pipelines, or optimizing performance. Triggers on MongoDB, Mongoose, NoSQL, aggregation pipeline, document database, MongoDB Atlas.

hoodini/owasp-security

Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability.

相關技能