Communitygithub.com

Biznomad/agent-skills

HyperFrames CLI 开发循环 — 使用 `npx hyperframes` 进行脚手架搭建、验证、预览、渲染和环境故障排除。如果遇到资产预处理命令(tts、transcribe、remove-background),请调用 hyperframes-media 技能。

agent-skills 是什么?

这个技能封装了 HyperFrames CLI 的完整开发循环,专为 AI 代理设计。它支持通过 `npx hyperframes` 进行项目的脚手架搭建(init)、代码检查(lint)、可视化检查(inspect)、预览(preview)和渲染(render)。该技能对于诊断构建或渲染环境问题特别有用,例如通过 `doctor` 命令检查 Chrome、FFmpeg、Node.js 和内存状况。它详细描述了 lint 操作(检查遗漏的 data-composition-id、重叠轨道等)和 inspect 操作(在无头 Chrome 中检查文本溢出),并提供了渲染和参数化渲染的全面选项。该技能适用于所有支持 `npx` 的 Agent 平台,并通过详细的技能文档确保 AI 代理能正确执行视频工作流程。

兼容平台~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/name_timestamp.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.

相关技能