Communitygithub.com

Biznomad/agent-skills

HyperFrames CLI 開發循環 — 使用 `npx hyperframes` 進行脚手架建置 (init)、驗證 (lint, inspect)、預覽、渲染與環境除錯 (doctor, browser, info, upgrade)。當執行以上任一命令或對 HyperFrames 建置/渲染環境進行除錯時,應使用此技能。對於資源預處理命令 (`tts`, `transcribe`, `remove-background`),請改用 `hyperframes-media` 技能。

agent-skills 是什麼?

此技能提供 HyperFrames CLI 的完整開發循環命令,包括專案初始化(`init`)、程式碼檢查(`lint`)、視覺檢查(`inspect`)、預覽(`preview`)、渲染(`render`)以及環境除錯(`doctor`、`browser`、`info`、`upgrade`)。對於開發者或 AI 代理來說,它能有效引導影片專案從零到完成的標準流程:先初始化結構,撰寫 HTML 編排,再經過 lint 與 inspect 確保品質,最後進行預覽與渲染。支援 `--docker` 可重現性輸出、`--gpu` 加速編碼、`--variables` 參數化渲染,以及 `draft`/`standard`/`high` 三種品質模式,適合不同開發階段。主要運行在所有 Node.js >= 22 的環境中,需搭配 FFmpeg。對於語音合成、轉錄或去背等資源預處理,應切換至 `hyperframes-media` 技能。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames CLI

一切透過 npx hyperframes 執行。需要 Node.js >= 22 與 FFmpeg。

工作流程

  1. 脚手架 — npx hyperframes init my-video
  2. 編寫 — 撰寫 HTML 編排(請見 hyperframes 技能)
  3. 檢查 — npx hyperframes lint
  4. 視覺檢查 — npx hyperframes inspect
  5. 預覽 — npx hyperframes preview
  6. 渲染 — npx hyperframes render

在預覽前先執行 lint 與 inspect。lint 會偵測缺少 data-composition-id、重疊的軌道與未註冊的時間軸。inspect 在無頭 Chrome 中開啟渲染後的編排,掃描時間軸,並回報文字溢出氣泡/容器或畫布外的情況。

脚手架

npx hyperframes init my-video                        # 互動式精靈
npx hyperframes init my-video --example warm-grain   # 選取範例
npx hyperframes init my-video --video clip.mp4        # 搭配影片檔案
npx hyperframes init my-video --audio track.mp3       # 搭配音訊檔案
npx hyperframes init my-video --example blank --tailwind # 搭配 Tailwind v4 瀏覽器執行環境
npx hyperframes init my-video --non-interactive       # 略過提示(CI/代理)

範本:blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph。

init 會建立正確的檔案結構、複製媒體、使用 Whisper 轉錄音訊,並安裝 AI 編碼技能。請使用此命令,而非手動建立檔案。

使用 --tailwind 時,在編輯類別或主題令牌前,請先呼叫 tailwind 技能。此脚手架使用 Tailwind v4.2 瀏覽器執行環境,而非 Studio 的 Tailwind v3 設定。

程式碼檢查

npx hyperframes lint                  # 當前目錄
npx hyperframes lint ./my-project     # 指定專案
npx hyperframes lint --verbose        # 資訊層級的發現
npx hyperframes lint --json           # 機器可讀

會檢查 index.html 與 compositions/ 目錄內的所有檔案。回報錯誤(必須修正)、警告(應修正)與資訊(搭配 --verbose)。

視覺檢查

npx hyperframes inspect                 # 檢查時間軸上的渲染佈局
npx hyperframes inspect ./my-project    # 指定專案
npx hyperframes inspect --json          # 代理可讀的發現
npx hyperframes inspect --samples 15    # 更密集的時間軸掃描
npx hyperframes inspect --at 1.5,4,7.25 # 明確的主力畫格時間點

請在 lint 與 validate 之後使用此命令,特別是對於包含對話氣泡、卡片、字幕或緊密排版的編排。它會回報:

  • 文字超出最近的可視容器或氣泡
  • 文字被自身的固定寬度/固定高度框裁剪
  • 文字超出編排畫布
  • 子元素逃脫裁剪容器

錯誤應在渲染前修正。警告會呈現給代理審查;加上 --strict 則會在出現警告時也失敗。重複的靜態問題會預設被折疊,以便 JSON 輸出保持精簡,適合 LLM 上下文視窗。如果溢出是刻意設計的進入/離開動畫,請在元素或祖先加上 data-layout-allow-overflow。如果裝飾性元素不應被審計,請加上 data-layout-ignore。

npx hyperframes layout 仍保留作為相同視覺檢查的相容別名。

預覽

npx hyperframes preview                   # 提供當前目錄的服務
npx hyperframes preview --port 4567       # 自訂埠號(預設 3002)

檔案變更時會熱重載。自動在瀏覽器中開啟 Studio。

當將專案交回給使用者時,請使用 Studio 專案 URL,而非原始的 index.html 路徑:

http://localhost:<port>/#project/<project-name>

請使用預覽輸出中的實際埠號與專案目錄名稱。例如,在 codex-openai-video 中執行 npx hyperframes preview --port 3017 後,回報 http://localhost:3017/#project/codex-openai-video。

請將 index.html 視為原始碼上下文。可以將其連結為實作檔案,但不要將其標記為專案或預覽表面。

渲染

npx hyperframes render                                # 標準 MP4
npx hyperframes render --output final.mp4             # 命名輸出
npx hyperframes render --quality draft                # 快速迭代
npx hyperframes render --fps 60 --quality high        # 最終交付
npx hyperframes render --format webm                  # 透明 WebM
npx hyperframes render --docker                       # 位元組一致
旗標選項預設備註
--output路徑renders/名稱_時間戳.mp4輸出路徑
--fps24, 30, 603060fps 渲染時間加倍
--qualitydraft, standard, highstandarddraft 用於迭代
--formatmp4, webmmp4WebM 支援透明度
--workers1-8 或 autoauto每個啟動一個 Chrome
--docker旗標關閉可重現的輸出
--gpu旗標關閉GPU 加速編碼
--strict旗標關閉在 lint 錯誤時失敗
--strict-all旗標關閉在錯誤與警告時都失敗
--variablesJSON 物件—覆蓋 data-composition-variables 中宣告的變數值
--variables-file路徑—包含變數值的 JSON 檔案(替代 --variables)
--strict-variables旗標關閉在 --variables 中有未宣告的鍵或型別不符時渲染失敗

品質建議: 迭代時使用 draft,審查時使用 standard,最終交付時使用 high。

參數化渲染: 編排在 <html> 根元素上使用 data-composition-variables 宣告其變數 — 這是一個 JSON 宣告陣列(每個條目包含 {id, type, label, default}),定義了綱要。內部的腳本透過 window.__hyperframes.getVariables() 讀取解析後的值。CLI 的 --variables '{"title":"Q4 Report"}' 是一個以 id 為鍵的 JSON 物件,會覆蓋已宣告的預設值以進行一次渲染;缺少的鍵會回退,因此同一編排在開發預覽與生產環境中可以不加修改地執行。(子編排宿主也可以使用 data-variable-values 來覆蓋每個實例的值 — 物件形狀相同,作用範圍僅限於子編排的一次掛載。完整模式請見 hyperframes 技能。)

資源預處理

npx hyperframes tts、transcribe 與 remove-background 會產出可供編排使用的資源(旁白音訊、逐字稿、透明影片)。每個命令在首次執行時會下載各自的模型。對於語音選擇、Whisper 模型規則(.en 會翻譯非英文的陷阱)、輸出格式選擇(VP9 透明 WebM 與 ProRes),以及 TTS → 轉錄 → 字幕鏈,請呼叫 hyperframes-media 技能。

除錯

npx hyperframes doctor       # 檢查環境(Chrome、FFmpeg、Node、記憶體)
npx hyperframes browser      # 管理內建 Chrome
npx hyperframes info         # 版本與環境詳細資訊
npx hyperframes upgrade      # 檢查更新

如果渲染失敗,請先執行 doctor。常見問題:缺少 FFmpeg、缺少 Chrome、記憶體不足。

其他

npx hyperframes compositions   # 列出專案中的編排
npx hyperframes docs           # 開啟文件
npx hyperframes benchmark .    # 基準測試渲染效能

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

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

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

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.

相關技能