Communitygithub.com

Biznomad/agent-skills

在用户明确要求将 Remotion(基于 React)视频合成迁移为 HyperFrames HTML 合成时使用。仅当用户明确要求移植、转换、迁移、翻译或重写 Remotion 合成为 HyperFrames 时使用。

agent-skills 是什么?

该技能旨在帮助开发者将现有的 Remotion(基于 React)视频合成机械地转换为 HyperFrames(HTML + GSAP)合成。它提供了从 Remotion 到 HyperFrames 的 API 映射,覆盖约 80% 的典型合成场景。技能内置了代码检查工具,可检测无法完美转换的模式(如 useState、useEffect 副作用、异步 calculateMetadata、第三方 React 组件库、@remotion/lambda 等),并建议使用运行时互操作模式而非进行有损翻译。技能包含分级的测试语料库(T1-T4,共4个夹具),通过在渲染后测量 SSIM 阈值来验证转换的保真度,确保翻译结果不仅“看起来正确”,而且在像素级别与基线一致。该技能适用于 Cursor、Claude Code 等 AI 代理平台,帮助开发者将现有的 Remotion 项目迁移到 HyperFrames 环境。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Remotion 到 HyperFrames

概述

将 Remotion(基于 React)视频合成为 HyperFrames(HTML + GSAP)合成。大多数 Remotion 习语都有直接的 HyperFrames 等效项 — 对于约 80% 的典型合成,转换是机械的。此技能编码了映射关系,并通过拒绝翻译不适合 HyperFrames 逐帧驱动模型的模式来防止有损的 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、自定义钩子。
  • 信息项(翻译并附注):staticFile、interpolateColors。

如果触发了任何阻塞项,请停止。阅读 references/escape-hatch.md 并呈现推荐消息。警告不会阻止翻译 — 在步骤 3 中丢弃违规结构,并在 TRANSLATION_NOTES.md 中记录差距。@remotion/lambda 配置是典型的警告案例:该技能会丢弃导入和 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,以及每个标量属性的一个 data-*。
  • 一个扁平场景 div 列表,带有 data-start / data-duration / data-track-index。
  • 内联 <style> 用于布局;CSS 设置每个动画属性的 from 状态。
  • 底部的单个 <script> 标签,包含一个暂停的 gsap.timeline({paused: true})。每个 Remotion useCurrentFrame() 派生值都成为此时间线上正确偏移处的补间动画。
  • window.__timelines["<composition-id>"] = tl; 将时间线注册到 HF 运行时。

自定义 React 子组件将作为重复 HTML 内联,使用属性接口作为模板(有关每个实例的 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 查看哪些帧出现偏差,然后重新阅读相关的时序/序列/媒体参考。

关键:两个渲染必须使用匹配的像素格式。在 Remotion 源代码的 remotion.config.ts 中设置 Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") — 否则差异会测量编码器差异(SSIM 下降约 0.05),而不是翻译保真度。

步骤 5:记录差距

任何未干净翻译的内容(丢弃的音量斜坡、近似的自定义演示、替换的字体)都将在 HF 输出旁生成 TRANSLATION_NOTES.md。格式请参见 references/limitations.md。

此技能明确不做的事情

  • 翻译 React 状态机。 通过 useState + useEffect 驱动动画的合并不是 HyperFrames 逐帧驱动模型中的确定性帧捕获目标。推荐使用运行时互操作模式。
  • 将 Remotion 渲染管道与 HyperFrames 一起运行。 这是 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多场景 + 弹簧 + 音频 + 图片0.9850.95
T3数据驱动、自定义子组件、计数0.9530.90
T4互操作(8 个检查案例)8/8 通过不适用

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

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

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.

相关技能