Communitygithub.com

Biznomad/claude-skills

HyperFrames CLI 開發循環 — `npx hyperframes` 用於腳手架(init)、驗證(lint、inspect)、預覽、渲染以及環境疑難排解(doctor、browser、info、upgrade)。執行這些指令或排解 HyperFrames 建置/渲染環境問題時使用。對於資產前置處理指令(`tts`、`transcribe`、`remove-background`),請改為呼叫 `hyperframes-media` 技能。

claude-skills 是什麼?

這是一個專為 HyperFrames 影片創作框架設計的 CLI 開發循環技能。它提供了一組 `npx hyperframes` 指令,能夠讓開發者或 AI 代理從零開始建立專案(`init`),透過 lint 檢查 HTML 結構與時間軸錯誤,利用 headless Chrome 進行視覺檢查以偵測文字溢位或剪裁問題,並最終以 MP4 或 WebM 格式產出高品質影片。該技能支援參數化渲染,允許在執行時傳入 JSON 變數來覆蓋組合中的定義,實現一次組合多種輸出的靈活性。此外,它還包含環境診斷工具(如 `doctor`、`browser`、`info`、`upgrade`),幫助排除 FFmpeg、Chrome 或 Node.js 版本不相容等常見問題。此技能適用於 Claude Code、Cursor 或 Codex 等平台,透過直接執行 CLI 指令來加速影片內容的迭代與交付。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-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. Lint — 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 時,請在編輯類別或主題 token 之前呼叫 tailwind 技能。腳手架使用 Tailwind v4.2 的瀏覽器運行時,而非 Studio 的 Tailwind v3 設定。

Linting

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

Lint 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每個 worker 會啟動一個 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 Alpha WebM 與 ProRes)以及 TTS → 轉錄 → 字幕的鏈路,請呼叫 hyperframes-media 技能。

疑難排解

npx hyperframes doctor       # 檢查環境(Chrome、FFmpeg、Node、記憶體)
npx hyperframes browser      # 管理 bundled 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 17 individual skills — each has its own dedicated page.

Biznomad/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-skills

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

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

相關技能