Communitygithub.com

Biznomad/agent-skills

建立影片合成、動畫、標題卡、疊加層、字幕、旁白、音訊反應式視覺效果以及 HyperFrames HTML 中的場景轉場。當被要求製作任何基於 HTML 的影片內容時使用。

agent-skills 是什麼?

Biznomad/agent-skills 是一個專為 AI 代理設計的 HyperFrames 影片製作技能,旨在將 HTML 作為影片的單一事實來源。它支援完整的影片製作工作流程,包括合成編寫、時間軸同步、動畫(使用 GSAP)、音訊反應式視覺效果(如節奏同步、發光、脈動)、文字轉語音旁白、同步字幕,以及場景轉場(如淡入淡出、擦除、顯示和著色器過渡)。該技能強調以設計為先的工作流程,首先定義品牌識別(透過設計系統步驟),然後透過提示擴展來確保一致性,最後再進行佈局、動畫和實施。它專為 Claude Code、Cursor 和 Codex 等平台設計,通過讀取 `design.md` 和 `house-style.md` 來維護品牌一致性,同時提供變數參數化合成,以便輕鬆重複使用不同內容。對於 CLI 命令(如初始化、預覽、渲染),它依賴於相關的 hyperframes-cli 和 hyperframes-media 技能。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes

在你喜歡的 AI 中提問

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

說明文件

HyperFrames

HTML 是影片的單一事實來源。一段合成(Composition)就是一個 HTML 檔案,其中包含用於時間設定的 data-* 屬性、用於動畫的 GSAP 時間軸,以及用於外觀的 CSS。框架會處理片段可見性、媒體播放和時間軸同步。

方法

探索(僅限探索性請求)

對於開放式請求(「幫我做一支產品發表影片」、「為我們的品牌創作一些東西」),當使用者尚未確定方向時,請先瞭解意圖,再挑選顏色:

  • 觀眾(Audience) — 誰會觀看這支影片?開發者?高階主管?一般消費者?
  • 平台(Platform) — 影片要在哪裡播放?社群媒體(15 秒)、網站主視覺、產品示範、內部使用?
  • 優先級(Priority) — 什麼最重要?動畫品質?內容準確性?品牌忠實度?速度?
  • 變體(Variations) — 使用者想要多個選項,還是只要一個最好的方案?

對於具體請求(「加個標題卡」、「調整場景 3 的時間」),請跳過探索步驟。

對於探索性請求,可以考慮提供 2-3 個有實質差異的變體,而不僅僅是換顏色——例如不同的節奏、能量水準或結構方法。一個安全/符合預期,一個大膽創新。這不是強制性的——是在合適時可用的工具。

步驟 1:設計系統

如果專案中存在 design.md 或 DESIGN.md 檔案,請先讀取它(檢查兩種大小寫——在 Linux 上是不同的檔案)。這是品牌顏色、字型和限制條件的單一事實來源。使用其中的確切數值——不要發明顏色或替換字型。任何格式都可以(YAML 前置元資料、散文、表格——只需提取數值)。

如果它指定的字型在本地找不到(沒有包含 .woff2 檔案的 fonts/ 目錄,也不是內建字型),請在撰寫 HTML 之前警告使用者:「design.md 指定了 [字型名稱] 但找不到字型檔案。請將 .woff2 檔案新增到 fonts/,否則我將回退到 [最接近的內建替代方案]。」

如果沒有 design.md 存在,請給使用者提供一個選擇:

  1. 使用者提到了風格或氛圍? → 閱讀 visual-styles.md 中的 8 個命名預設。選擇最接近的。
  2. 想要視覺化瀏覽選項? → 執行設計選擇器:閱讀 references/design-picker.md 以瞭解完整工作流程。這會提供一個視覺選擇器頁面。使用者在瀏覽器中配置氛圍、調色板、排版和動畫,然後複製生成的 design.md 並將其貼回對話中。
  3. 想跳過步驟快速進行? → 詢問:氛圍、淺色或深色、是否有任何品牌顏色/字型?然後從 house-style.md 中選擇一個調色板。

design.md 定義品牌。它不定義影片合成規則。 這些規則來自 references/video-composition.md 和 house-style.md。以適合影片的規模使用品牌顏色——而不是像網頁 UI 那樣的透明度。

步驟 2:提示擴展

始終對每個合成執行此步驟(單場景片段和簡單編輯除外)。這一步驟會根據 design.md 和 house-style.md 來鞏固使用者的意圖,並產生一個一致的、所有下游代理都能以相同方式讀取的中間產物。

閱讀 references/prompt-expansion.md 以瞭解完整的流程和輸出格式。

步驟 3:規劃

在撰寫 HTML 之前,先從高層次思考:

  1. 內容(What) — 觀眾應該體驗到什麼?識別敘事弧線、關鍵時刻和情感節拍。
  2. 結構(Structure) — 有多少個合成,哪些是子合成(sub-composition)與內聯合成(inline),哪些軌道承載什麼內容(影片、音訊、疊加層、字幕)。
  3. 節奏(Rhythm) — 在實施之前宣告你的場景節奏。哪些場景是快速切換,哪些是停留,著色器出現在哪裡,能量高峰在哪裡。命名模式:快-快-慢-快-著色器-停留。閱讀 references/beat-direction.md 以瞭解節奏模板。
  4. 時間(Timing) — 哪些片段驅動持續時間,轉場發生在哪裡,節奏如何。
  5. 佈局(Layout) — 先構建最終狀態。請參閱下面的「先佈局後動畫」。
  6. 動畫(Animate) — 然後使用下方的規則加入動畫。

只構建被要求的東西。 「一個標題卡」的請求不是「一個標題卡 + 3 個輔助場景 + 背景音樂 + 字幕」的請求。每個場景、每個元素、每個補間動畫都應有其存在的理由。如果額外的場景或元素能真正改善作品,請提出建議——但不要擅自加入。

對於小型編輯(修正顏色、調整時間、加入一個元素),直接跳到規則。

先佈局後動畫

將每個元素放置在其最顯眼的時刻——也就是它完全進入、正確定位、且尚未退出的幀。先將其寫成靜態的 HTML+CSS。此時還不需要 GSAP。

為什麼這很重要: 如果你將元素定位在它們的動畫起始狀態(畫面外、縮放到 0、透明度 0),然後補間到你認為它們最終應該到達的位置,你只是在猜測最終佈局。重疊問題在影片渲染之前是看不見的。透過先構建最終狀態,你可以在加入任何動畫之前看到並修復佈局問題。

過程

  1. 為每個場景識別主要幀(hero frame) — 即大部分元素同時可見的時刻。這就是你要構建的佈局。
  2. 為該幀撰寫靜態 CSS。.scene-content 容器必須使用 width: 100%; height: 100%; padding: Npx; 配合 display: flex; flex-direction: column; gap: Npx; box-sizing: border-box 來填滿整個場景。使用內邊距(padding)將內容推向內部——切勿在內容容器上使用 position: absolute; top: Npx。使用絕對定位的內容容器在內容高於剩餘空間時會溢出。僅將 position: absolute 保留給裝飾性元素。
  3. 使用 gsap.from() 加入入場動畫 — 從畫面外/不可見動畫到 CSS 位置。CSS 位置是基本事實;補間描述了到達該位置的過程。(在透過 data-composition-src 載入的子合成中,偏好使用 gsap.fromTo()——請參閱 references/motion-principles.md 中的載荷 GSAP 規則。)
  4. 使用 gsap.to() 加入退場動畫 — 從 CSS 位置動畫到畫面外/不可見。

範例

/* scene-content 填滿場景,padding 定位內容 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* 容器填滿任何場景尺寸 (1920x1080, 1080x1920 等)。
   Padding 定位內容。Flex + gap 處理間距。 */

錯誤示範——硬編碼尺寸和絕對定位:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// 步驟 3:動畫進入這些位置
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// 步驟 4:從這些位置動畫退出
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

當元素在不同時間共享空間時

如果元素 A 在元素 B 進入同一區域之前退出,兩者都應針對其各自的主要幀具有正確的 CSS 位置。時間軸排序保證了它們永遠不會在視覺上共存——但如果你跳過佈局步驟,你將不會發現它們因時間錯誤而意外重疊的情況。

什麼算是有意重疊

分層效果(文字後方的發光、陰影元素、背景圖案)和 Z 軸堆疊設計(卡片堆疊、深度層次)是有意的。佈局步驟的目的是捕捉無意的重疊——兩個標題落在彼此上方、一個統計數字覆蓋了標籤、內容超出畫面。

資料屬性

所有片段

屬性 (Attribute)必要 (Required)值 (Values)
id是唯一識別碼
data-start是秒數或片段 ID 引用 ("el-1", "intro + 2")
data-durationimg/div/compositions 需要秒數。影片/音訊預設使用媒體長度。
data-track-index是整數。相同軌道的片段不能重疊。
data-media-start否來源的修剪偏移量(秒)
data-volume否0-1 (預設 1)

data-track-index 不影響視覺層級——請使用 CSS z-index。

合成片段

屬性 (Attribute)必要值
data-composition-id是唯一的合成 ID
data-start是開始時間(根合成:使用 "0")
data-duration是優先於 GSAP 時間軸持續時間
data-width / data-height是像素尺寸 (1920x1080 或 1080x1920)
data-composition-src否外部 HTML 檔案的路徑
data-variable-values否子合成主機上每個實例變數覆蓋的 JSON 物件

在根 <html> 元素上:

屬性 (Attribute)必要值
data-composition-variables否已宣告變數的 JSON 陣列 (id/type/label/default) — 驅動 Studio 編輯 UI 並為 getVariables() 提供預設值

合成結構

透過 data-composition-src 載入的子合成使用 <template> 包裝器。獨立合成(主要的 index.html)不使用 <template>——它們將 data-composition-id 的 div 直接放在 <body> 中。在獨立檔案上使用 <template> 會對瀏覽器隱藏所有內容並破壞渲染。

子合成結構:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- 內容 -->
    <style>
      [data-composition-id="my-comp"] {
        /* 作用域樣式 */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // 補間動畫...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

在根元素中載入:<div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

變數(參數化合成)

使用不同的內容渲染同一個合成——標題、主題顏色、價格、字幕——而無需編輯原始 HTML。

三步驟模式:

  1. 宣告 合成 <html> 根元素上的變數,使用 data-composition-variables。每個條目需要 id、type(string、number、color、boolean、enum 之一)、label 和 default。列舉條目還需要 options: [{value, label}, ...]。
  2. 讀取 合成內腳本中的解析值,使用 window.__hyperframes.getVariables()。返回宣告的預設值 + 每個實例的覆蓋值 + CLI 覆蓋值的合併結果。
  3. 覆蓋 在渲染時使用 npx hyperframes render --variables '{...}'(頂層)或使用主機元素上的 data-variable-values='{...}'(子合成的每個實例)。
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Title","default":"Hello"},
  {"id":"theme","type":"enum","label":"Theme","default":"light","options":[
    {"value":"light","label":"Light"},
    {"value":"dark","label":"Dark"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# 開發預覽使用宣告的預設值
npx hyperframes preview

# 使用覆蓋值渲染
npx hyperframes render --variables '{"title":"Q4 Report","theme":"dark"}' --output q4.mp4

# 或從 JSON 檔案讀取
npx hyperframes render --variables-file ./vars.json

子合成每個實例的值: 相同的 getVariables() 在透過 data-composition-src 載入的子合成內部也可以運作。每個主機元素傳遞其自己的值:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"$29"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"

…

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

相關技能