Communitygithub.com

Biznomad/claude-skills

將現有的 Remotion(基於 React)影片組合翻譯成 HyperFrames HTML 組合。僅在使用者明確要求移植、轉換、遷移、翻譯或改寫 Remotion 組合為 HyperFrames 時使用(例如「將我的 Remotion 專案移植到 HyperFrames」)。

claude-skills 是什麼?

此技能專為將 Remotion(基於 React)影片組合機械化翻譯為 HyperFrames(HTML + GSAP)組合而設計,涵蓋約 80% 的典型組合。它透過語法檢查來識別無法直接翻譯的模式(如 useState、useEffect 副作用、非同步 calculateMetadata、第三方 React 元件庫、@remotion/lambda),並建議使用執行時期互通模式而非進行有損翻譯。技能包含分層測試語料庫(T1 至 T4,共 4 個測試用例),用於根據測量的 SSIM 閾值驗證翻譯品質。支援平台為 HyperFrames 和 Remotion,工作流程包括:語法檢查原始碼、規劃翻譯(基於 API 映射)、產出 HyperFrames 組合(index.html)、透過 SSIM 差異驗證,並記錄翻譯缺口。

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

在你喜歡的 AI 中提問

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

說明文件

Remotion 轉 HyperFrames

概述

將 Remotion(基於 React)影片組合翻譯成 HyperFrames(HTML + GSAP)組合。大多數 Remotion 習慣用法都有直接的 HyperFrames 等效項——對於約 80% 的典型組合,翻譯是機械化的。此技能編碼了對應關係,並透過拒絕翻譯不適合 HF 基於搜尋(seek-driven)模型的有損 20% 模式,轉而建議使用 PR #214 中的執行時期互通模式來保護翻譯品質。

此技能附帶分層測試語料庫(T1–T4,共 4 個測試用例),根據測量的 SSIM 臨界值對翻譯進行評級。未執行評估前請勿進行翻譯——一個「看起來正確」但渲染出的 SSIM 比驗證基準低 0.05 的翻譯是無聲的錯誤。

使用時機

僅在使用者明確要求從 Remotion 遷移時使用此技能。 觸發短語範例:

  • "將我的 Remotion 專案移植到 HyperFrames"
  • "將此 Remotion 程式碼轉換為 HyperFrames"
  • "從 Remotion 遷移"
  • "翻譯此 Remotion 組合"
  • "將其改寫為 HyperFrames HTML"

在以下情況請勿使用此技能:

  • (a) 使用者正在創作新的 HyperFrames 組合,即使他們有或正在 A/B 測試類似的 Remotion 影片。
  • (b) 使用者順帶提及 Remotion 而未要求遷移。
  • (c) 使用者分享 Remotion 程式碼作為參考資料,而非要求翻譯。
  • (d) 使用者要求「與我的 Remotion 影片相同」而未明確要求遷移原始碼——將其視為全新的 HyperFrames 建置。

如有疑問,預設使用 hyperframes 技能創作原生 HyperFrames 組合。

工作流程

步驟 1:語法檢查原始碼

在 Remotion 原始碼目錄上執行 scripts/lint_source.py。語法檢查會偵測無法乾淨翻譯的模式:

  • 阻斷器(拒絕並建議互通):useState、useReducer、useEffect/useLayoutEffect(帶有非空依賴項)、非同步 calculateMetadata、第三方 React UI 函式庫(MUI、Chakra、Mantine、antd、shadcn、Radix、NextUI)。
  • 警告(丟棄該結構後翻譯):@remotion/lambda 配置、delayRender、useCallback、useMemo、自訂 hooks。
  • 資訊(翻譯時附上註記):staticFile、interpolateColors。

如果觸發任何阻斷器,請停止。閱讀 references/escape-hatch.md 並顯示建議訊息。警告不會阻止翻譯——在步驟 3 中丟棄有問題的結構,並在 TRANSLATION_NOTES.md 中記錄缺口。@remotion/lambda 配置是典型的警告案例:技能會丟棄 import 和 renderMediaOnLambda(...) 調用,但翻譯組合的其他部分。

步驟 2:規劃翻譯

閱讀 references/api-map.md——包含每個 Remotion API 及其 HF 等效項或每個主題參考的索引。根據原始碼使用的內容,確定需要的參考主題:

原始碼包含載入參考
Composition、defaultProps、schema、calculateMetadataparameters.md
Sequence、Series、Loop、AbsoluteFill、Freezesequencing.md
useCurrentFrame、interpolate、spring、Easing、interpolateColorstiming.md
Audio、Video、Img、IFrame、staticFile、delayRendermedia.md
TransitionSeries、@remotion/transitionstransitions.md
@remotion/lottielottie.md
@remotion/google-fonts/<Family>、Font.loadFont、@font-facefonts.md

不要全部載入——僅載入特定原始碼所需的內容。

步驟 3:產生 HF 組合

產出 index.html,包含:

  • 根元素 <div id="stage">,攜帶組合的 data-composition-id、data-start="0"、data-duration(以秒為單位)、data-fps、data-width、data-height,以及每個純量 prop 的 data-*。
  • 一個扁平化的場景 div 列表,帶有 data-start / data-duration / data-track-index。
  • 內聯 <style> 用於佈局;CSS 設定每個動畫屬性的 from 狀態。
  • 底部單一個 <script> 標籤,包含一個暫停的 gsap.timeline({paused: true})。每個 Remotion useCurrentFrame() 推導都會變成此時間軸上正確偏移量的 tween。
  • window.__timelines["<composition-id>"] = tl; 將時間軸註冊到 HF 的執行時期。

自訂 React 子元件內嵌為重複的 HTML,使用 prop 介面作為模板(有關每個實例的 data-* 模式,請參閱 parameters.md)。

步驟 4:驗證

執行評估工具——完整指南請參閱 references/eval.md。快速路徑:

# 渲染 Remotion 基準(在 fixture 中執行 npm install 後)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# 渲染 HF 翻譯
cd ../hf-src && npx hyperframes render --output ../hf.mp4

# SSIM 差異比較
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff

臨界值:低於原始碼複雜度層級 p05 約 0.02(請參閱 eval.md 中驗證過的臨界值表格)。如果差異比較失敗,請執行 scripts/frame_strip.sh 查看哪些影格發生偏差,然後重新閱讀相關的 timing/sequencing/media 參考。

關鍵:兩個渲染必須使用匹配的像素格式。在 Remotion 原始檔案的 remotion.config.ts 中設定 Config.setVideoImageFormat("png") + Config.setColorSpace("bt709")——否則差異比較會測量到編碼器差異(約 0.05 SSIM 損失),而非翻譯保真度。

步驟 5:記錄缺口

任何未乾淨翻譯的內容(丟失的音量曲線、近似處理的自訂呈現方式、替換的字型)都會在 HF 輸出旁產生一個 TRANSLATION_NOTES.md。格式請參閱 references/limitations.md。

此技能明確不做的事

  • 翻譯 React 狀態機。 使用 useState + useEffect 驅動動畫的組合在 HyperFrames 的基於搜尋模型中並非確定性的影格擷取目標。建議使用執行時期互通模式。
  • 與 HyperFrames 並行執行 Remotion 的渲染管線。 那是 PR #214 中的執行時期互通模式——針對未能通過此技能語法檢查的組合的獨立解決方案。

(@remotion/lambda 不是阻斷器——Lambda 配置屬於部署,而非動畫。技能會將其作為警告丟棄,並翻譯其餘部分。請參閱 references/escape-hatch.md。)

如何評級自己的翻譯

執行測試語料庫協調器:

./assets/test-corpus/run.sh

它會執行 T1、T2、T3(渲染 + 差異比較)和 T4(語法檢查驗證),列印每個層級的通過/失敗表格,並產出彙總 JSON 報告。使用此工具驗證技能在乾淨檢出中端到端正常運作——並作為編輯任何參考後的迴歸檢查。

驗證基準(截至 2026-04-27):

層級組合形狀平均 SSIM臨界值
T1單一元素淡入0.9740.95
T2多場景 + spring + 音訊 + 圖片0.9850.95
T3資料驅動、自訂子元件、計數器0.9530.90
T4逃脫出口(8 個語法檢查案例)8/8 通過不適用

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

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/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

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.

相關技能