Communitygithub.com

Elis3omndz/Claude_Skills

將產品或行銷 URL、貼上的腳本或簡報,轉化為產品上市 / 宣傳影片 — SaaS 宣傳、功能揭露、產品展示、應用程式與公司上市。當使用者想要行銷、上市、推廣或揭露產品時使用;為任何商業 URL 的預設選項。網站導覽 / 展示也歸此處處理 — 簡報承載「如實呈現」意圖。不明確時 → /hyperframes。

Claude_Skills 是什麼?

此技能專為 HyperFrames 生態系統設計,用於將產品行銷素材(如 URL、腳本或簡報)轉化為完整的產品上市影片。它作為編排者,引導使用者透過一系列步驟(從設置、素材捕獲、設計系統、故事板、腳本,到最終渲染)產生專業級影片。支援多種平台,包括 HyperFrames CLI 和 Figma 整合,並可與 HeyGen 等媒體服務搭配使用。工作流程從確認簡報開始,接著捕獲品牌素材,建立設計系統,編寫故事板和腳本,最後生成 HTML 框架並渲染影片。關鍵步驟包括使用 `npx hyperframes capture` 等命令捕獲素材,透過 `npx hyperframes init` 設置專案,並確保品牌標記(如色彩和字型)被正確映射。此技能還包含嚴格的門檻檢查,確保每一步驟的輸出完整無誤後才進入下一步。對於不確定或用戶意圖不明的情況,它會引導至 `hyperframes` 技能進行意圖層判斷。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/product-launch-video

在你喜歡的 AI 中提問

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

說明文件

外掛安裝: 在執行設定或最新命令之前,若此技能位於 HyperFrames 外掛內,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。

首先,保持此技能最新 — 先與使用者確認後再執行: npx hyperframes skills update product-launch-video。如果一切已是最新狀態,則為快速無操作指令;否則,在您依賴此技能及其依賴的核心領域技能之前,它會先進行刷新。

media-use:在獲取音訊/圖片/標誌之前,請呼叫 /media-use 來從 HeyGen 目錄解析 BGM/SFX/圖片,並從其官方來源獲取品牌標誌。首先執行 --adopt 以註冊現有素材。請參閱 /media-use 技能。

figma 來源:如果來源是 figma.com 的 URL,請先執行 /figma — 進行素材匯出、品牌代幣、以及組件/分鏡重建(如有需要),然後從其輸出建構此工作流程。不要直接透過原始的 MCP 工具驅動 Figma:這會繞過 SVG 清理、.media/manifest.jsonl 來源追蹤、以及品牌代幣 var() 綁定,導致後續的品牌變更無法傳播,除非完全重新匯入。

產品上市至 HyperFrames

使用此技能來捕捉產品、了解其品牌、規劃上市影片,並在 HyperFrames 中逐幀建構。

前門是 /hyperframes。 您是編排者。執行每個步驟,驗證其門檻,然後才繼續下一步。此技能適用於正在進行行銷、上市、推廣或揭露的產品,包括當請求目的是推廣時的「為我們的網站製作宣傳片」等請求。網站導覽 / 展示請求也留在此處處理:BRIEF.md 承載「如實呈現」的意圖,而捕獲的螢幕截圖成為影片展示的素材。任何其他意圖、單純的「製作影片」、或任何不確定性 → 請先閱讀 /hyperframes — 意圖層負責所有路線決策,而一個沒有 BRIEF.md 就直接到達此處的全新建案無論如何都會通過它(設置的開場規則)。

您是編排者。在 videos/<project>/ 中工作。按順序執行步驟,並在繼續之前通過每個門檻。使用者門檻步驟為步驟 0、步驟 3 和步驟 6。在步驟 0 之前閱讀 ../hyperframes/references/brief-contract.md — 它定義了門檻類型,以及 BRIEF.md 的 flow/storyboard 如何推導出管理步驟 3/4/6 門檻的模式。除步驟 5 外,請自行執行每個步驟;在步驟 5 中,您為每個影格分派一個子代理。不要在此處放置設計或運動規則;這些規則位於影格工作者子代理、此技能的本地 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、以及 hyperframes-creative 中。

工作流程:步驟 0 設定 -> hyperframes.json;步驟 1 捕獲 -> capture/;步驟 2 設計系統 -> frame.md;步驟 3 分鏡/腳本 -> STORYBOARD.md 和 SCRIPT.md;步驟 3.1 音訊 -> audio_meta.json;步驟 4 視覺設計 -> 增強後的 STORYBOARD.md;步驟 5 影格 -> compositions/frames/NN-*.html 和 index.html;步驟 6 最終渲染 -> renders/video.mp4。


步驟 0:設定

目標:確認簡報,建立 HyperFrames 專案,並使簡報持久化。

簡報由意圖層確認,而非此處提出的問題。 開場規則,依序:(1) BRIEF.md 存在 → 讀取它,不問任何問題 — 簡報已確定,其 flow/storyboard 推導出模式(簡報合約 § 1)。(2) 沒有 BRIEF.md,但專案存在(磁碟上有 hyperframes.json / STORYBOARD.md)→ 從分鏡的前置資料和記錄的偏好繼續;永遠不要重新盤問一個半成品專案。(3) 兩者都沒有 — 一個直接到達此處的全新建案請求 → 閱讀 /hyperframes 並執行其意圖層(references/intent-interview.md):它檢查配方和記錄的預設值,進行此路線的問題詢問(../hyperframes/references/routes/product-launch-video.md),並回傳鎖定的簡報。編輯請求則跳過所有這些步驟 — 直接進行編輯。

僅在 hyperframes.json 缺失時才進行初始化。以中橫線命名法(kebab-case)從品牌或網域命名 <project>,例如 acme-promo;切勿使用工作區名稱或時間戳記。

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init 會檢查已安裝的技能與 GitHub 上的最新版本是否一致,並在有任何技能過期時更新全域集。

初始化後,讓 <PROJECT_ROOT> 為 videos/<project>,並以該目錄作為工作目錄執行所有後續的相對路徑命令。在以下的命令中,. 表示 <PROJECT_ROOT>;永遠不要將 .media、capture 或輸出檔案寫入呼叫者目錄。

在初始化後立即撰寫 BRIEF.md(切勿在此之前 — init 會拒絕非空目錄):意圖層鎖定的簡報,其格式遵循 ../hyperframes/references/brief-format.md。將 <MEDIA_DIR> 解析為已安裝的 /media-use 技能目錄。然後使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 記錄每個偏好支援的答案(brief-format.md 指定了子集)。如果意圖層採用了一個配方,則執行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它會將配方的 frame.md 複製到專案中(步驟 2 將被跳過),並回傳步驟 3 將據以草擬的骨架。配方填寫答案,而非核准;審查門檻仍會執行。

在繼續設定之前顯示登入狀態 — 執行 npx hyperframes auth status 並逐字傳達其輸出。它會報告語音/BGM 將使用 HeyGen 還是本地引擎,以及在未登入時如何登入。請注意退出碼合約:auth status 在未登入時(以及當儲存的憑證被拒絕時)退出碼為 1 — 這個非零退出是正常的未登入狀態,並非命令失敗,因此不要將其視為錯誤,不要重試它,也不要將其與 &&/set -e 串聯,以免中止工作流程。採用一個分支:

  • 協作模式: 等待使用者登入或明確選擇 offline / go。
  • 自主模式: 報告狀態並繼續使用可用的本地引擎。

當沒有可用的離線提供者時,不要默默遺漏一個必要功能;應指出障礙。不要將此決定合併到另一個問題中,也不要將金鑰寫入每個儲存庫的 .env 檔案中。認證所有權和離線備援:請參閱 /media-use references/setup-providers.md § Providers。

門檻: hyperframes.json 和 BRIEF.md 存在;偏好支援的答案已記錄(簡報合約 § 2);登入狀態已顯示(已登入,或繼續以離線模式進行)。


步驟 1:捕獲素材

目標:收集影片的來源素材、品牌信號和可用的素材。

對輸入進行分類並選擇路徑。明確的 URL -> 捕獲它,並使用該網站進行旁白和素材。貼上的腳本/簡報 -> 逐字儲存為 user_script.txt;VO_MODE(逐字或重構)來自 BRIEF.md — 當腳本到達時,意圖層會詢問此項(只有在簡報缺乏此項時,才在此處詢問一次)。然後解析捕獲目標:文字中的 URL -> 使用它;僅品牌名稱 -> 使用 WebSearch,在一行中確認 URL,然後爬取;沒有 URL/網站(或簡報說不要抓取)-> 無捕獲路徑。

使用以下命令執行捕獲:npx hyperframes capture "<URL>" -o ./capture --json。除非呼叫者擁有較短的截止日期,否則保留預設的導航後預算;在這種情況下,傳遞一個正數的 --capture-budget <毫秒>,以為後續工作留出時間。--timeout 僅控制頁面導航。只有在選擇性停用圖片說明時才使用 --skip-vision。

立即檢查命令結果和輸出目錄。非零退出碼、JSON ok: false、或 capture/BLOCKED.md 存在是捕獲路徑的硬停:報告記錄的原因,不要使用部分的螢幕截圖、DOM、代幣或素材。在 URL 捕獲失敗後,不要自行製造一個合成的無捕獲備援方案。僅當原始簡報提供了來源素材,或者使用者明確在失敗後切換到提供的螢幕截圖或簡報時,才繼續執行無捕獲路徑。

諸如「文字內容非常少」的警告加上空的素材目錄,並不能證明頁面可用。對於網站導覽或如實呈現的簡報,需要可信的捕獲結構或提供的螢幕截圖;如果兩者都不存在,請停止。不要僅僅因為捕獲不可用就發明或重建頁面。

對於網站導覽或如實呈現的簡報,捕獲的頁面是視覺真相來源。使用真實的螢幕截圖,而不是重建完整的網站 HTML。如果截圖需要內部移動,則將截圖保留為底層,並在測量到的位置上疊加真實的捕獲素材,或者僅重建移動的那一個組件。對於捲動截圖,在 capture/screenshots/full-page.png 上對視口進行動畫 — 這是整個文件的 1 倍圖層,對於一個沿著它向下移動的 1920 寬視口來說是像素精確的。當頁面太高無法一次性捕獲時,該檔案會缺失;請改為使用同一目錄中重疊的捲動位置截圖作為備援。超過 1:1 的放大需要該區域自己的 2 倍捕獲,因為 1 倍圖層沒有高於 1 倍的餘裕。僅當使用者明確要求風格化解釋時,才重建整個頁面;僅有不可用的捕獲本身並非授權。

如果存在 GEMINI_API_KEY、GOOGLE_API_KEY 或 OpenRouter 金鑰,捕獲會自動為素材添加說明到 capture/extracted/asset-descriptions.md。這不是一個審查門檻。如果沒有視覺金鑰,則使用 DOM 上下文並繼續。

無捕獲路徑:手動建立 capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/。tokens.json 應為 { "title": "", "description": "", "colors": [], "fonts": [] };盡可能從簡報中填寫 title/description。visible-text.txt 包含完整的簡報或腳本。asset-descriptions.md 應說明未捕獲任何素材,除非使用者提供了素材說明。

門檻: 捕獲 JSON 報告 ok: true;capture/BLOCKED.md 不存在;capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/ 存在;並且您能用一句清晰的句子說明品牌。將 asset-descriptions.md 視為主要的素材庫存。如果在實際捕獲後它缺失,請停止並報告捕獲不完整。僅在此結構性門檻仍然通過時,關於降級的可選階段的警告才是可接受的。


步驟 2:設計系統

目標:選擇一個已提供的影格預設;一個腳本將其轉換為此影片的 frame.md + 字幕外觀。

當 BRIEF.md 指定了 style_preset — 使用者在意圖層從展示中挑選的 — 則使用它;僅當簡報未指定時,您才需要進行判斷。然後您需要做出一個決定 — 選擇哪個預設:閱讀 ../hyperframes-creative/references/design-spec.md,並選擇其外觀最符合品牌和簡報的預設。然後執行:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

該腳本確定性地完成其餘工作:將預設的 FRAME.md 複製為 frame.md,並根據 capture/extracted/tokens.json 中的品牌代幣對其進行重新混音(按角色將品牌顏色映射到預設的顏色鍵上 — 墨水、畫布、強調色 — 保持鍵/結構/組件不變;將預設的顯示字型+正文互換為品牌字型),將預設的字幕外觀複製到 .hyperframes/caption-skin.html,並自行驗證(映射中斷則退出碼為 1)。一旦退出碼為 0,立即進入下一步 — 無需手動編輯規格。

沒有品牌顏色/字型的 tokens.json(例如沒有捕獲)→ 腳本保留預設自身的調色板,這是一個完整可發貨的設計。如果簡報指定了捕獲遺漏的品牌顏色/字型,請在執行前將它們添加到 capture/extracted/tokens.json(或使用使用者的 design.md 來填充);僅在映射確實需要時,才事後手動調整 frame.md。

門檻: build-frame.mjs 退出碼為 0 — frame.md 來自一個已命名的預設,並且(當預設包含時).hyperframes/caption-skin.html 作為字幕外觀來源存在;所選的預設已記錄為偏好(--key style_preset --workflow <此工作流程>,簡報合約 § 2)。


步驟 3:分鏡和腳本

目標:將簡報和捕獲的素材轉化為已核准的逐幀故事計劃。

閱讀 ../hyperframes-creative/references/story-spine.md(鉤子語言、價值先於證據、以提案形式呈現的故事板、有來源可追溯的視覺素材)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/script-format.md。使用它們來撰寫 STORYBOARD.md,並在需要旁白時撰寫 SCRIPT.md。將前置資料 duration: 設定為簡報的 length — 一個粗略的期望;組合時會報告最終剪輯與之相比的實際長度。

使用 story-design.md 進行故事藍圖、鉤子、說服邏輯、節拍、VO_MODE 和素材選擇。作為一個軟性指南,請參閱 ../hyperframes-animation/blueprints-index.md 中的角色→藍圖選單:對於每個節拍,當有合適的藍圖時,記下一個候選藍圖 id。故事真相仍然決定哪些節拍存在 — 永遠不要強迫一個節拍去適應一個藍圖,也永遠不要僅僅因為有一個可用的經過驗證的形狀就發明一個節拍。從 capture/extracted/asset-descriptions.md(規範庫存)中選擇每個視覺影格的 asset_candidates — 不要瀏覽原始的 capture/assets/。除非該庫存遺失或不可用,否則不要要求使用者選擇素材。使用來自分鏡和腳本參考文件的確切必填欄位。

草擬後,執行審查循環的計劃階段 — ../hyperframes/references/review-loop.md § 1:將計劃作為提案呈現,並提出兩個問題 — 核准或修改,以及先看草稿(建議)或跳過。反饋以聊天回覆的形式到達;循環直到核准。這是一個檢查點門檻(簡報合約 § 1):在自主模式下,…

[因原始內容截斷,此處為完整翻譯]

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Elis3omndz/Claude_Skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Elis3omndz/Claude_Skills

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Elis3omndz/Claude_Skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

Elis3omndz/Claude_Skills

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Elis3omndz/Claude_Skills

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

相關技能