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` 命令高效地创建、验证、预览和渲染视频项目。它支持 Node.js >= 22 和 FFmpeg,核心工作流包括 scaffold(初始化项目结构)、lint(检查 HTML/合成文件错误)、inspect(视觉检测排版溢出问题)、preview(热重载预览)和 render(导出多种格式的视频)。每个子命令都有丰富的选项,如选择示例模板、配置输出参数、启用 GPU 加速等,并且参数化渲染功能允许通过 `--variables` 动态覆盖组合变量,适用于 CI/CD 流程。此外,它还提供了 `doctor`、`browser`、`info` 等调试命令,便于快速定位环境问题。该技能主要适用于 Claude Code、Cursor 等 AI 代理集成,以及手动命令行操作场景。

兼容平台✓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. Scaffold(脚手架) — 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 中打开渲染后的合成,扫描时间轴,并报告文本溢出气泡/容器或画布的问题。

Scaffold(脚手架)

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/agent 使用)

模板: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 设置。

Lint(检查)

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          # agent 可读的发现结果
npx hyperframes inspect --samples 15    # 更密集的时间轴扫描
npx hyperframes inspect --at 1.5,4,7.25 # 指定关键帧时间戳

在 lint 和 validate 之后使用此命令,特别是对于包含对话气泡、卡片、字幕或紧凑排版的合成。它会报告:

  • 文本超出最近的视觉容器或气泡
  • 文本被其自身的固定宽度/高度框裁剪
  • 文本超出合成画布
  • 子元素逃离裁剪容器

错误应在渲染前修复。警告提供给 agent 审查;添加 --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每个 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      # 管理捆绑的 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.

相关技能