Communitygithub.com

delorenj/skills

HyperFrames CLI 开发循环 — 使用 `npx hyperframes` 完成脚手架搭建(init)、验证(lint、inspect)、预览、渲染和环境排障(doctor、browser、info、upgrade)。当执行这些命令或排查 HyperFrames 构建/渲染环境时调用。对于资源预处理命令(`tts`、`transcribe`、`remove-background`),请改为调用 `hyperframes-media` 技能。

skills 是什么?

该技能封装了 HyperFrames CLI 的完整开发工作流,适用于所有基于 HyperFrames 的视频合成项目。开发者通过 `npx hyperframes` 统一入口,即可依次完成项目初始化(init)、HTML 组合编写、代码检查(lint)、可视化审查(inspect)、实时预览(preview)和最终渲染(render)。技能严格定义了执行顺序:lint 和 inspect 必须在 preview 之前运行,以确保 `data-composition-id` 正确、轨道不重叠、文本不溢出气泡/容器或画布。它同时提供了参数化渲染功能,支持通过 `--variables` 或 `--variables-file` 动态覆盖组件变量,实现同一合成在不同配置下的复用。环境排障方面,`doctor`、`browser`、`info`、`upgrade` 子命令可快速诊断 FFmpeg、Chrome、Node 版本和内存等常见问题。该技能与 `hyperframes-media`(资源预处理)和 `tailwind` 技能配合使用,共同构建完整的开发体验。支持 Node.js >= 22 和 FFmpeg 环境。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/delorenj/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/名称_时间戳.mp4输出路径
--fps24, 30, 603060fps 会使渲染时间翻倍
--qualitydraft, standard, highstandarddraft 用于迭代
--formatmp4, webmmp4WebM 支持透明
--workers1-8 或 autoauto每个工人将启动一个 Chrome 实例
--docker标志off可重现输出
--gpu标志offGPU 加速编码
--strict标志off遇到 lint 错误时失败
--strict-all标志off遇到错误和警告时都失败
--variablesJSON 对象—覆盖 data-composition-variables 中声明的变量值
--variables-file路径—包含变量值的 JSON 文件(--variables 的替代方案)
--strict-variables标志off当 --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 vs 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 14 individual skills — each has its own dedicated page.

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

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

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

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

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

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

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

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

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

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

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

相关技能