Communitygithub.com

govindgoel2001/视频编辑工具包

安装注册表中的块和组件,并将其接入 HyperFrames 合成。在执行 hyperframes add、安装块或组件、将已安装项目接入 index.html 或处理 hyperframes.json 时使用。涵盖 add 命令、安装位置、块子合成接入、组件片段合并以及注册表发现。

视频编辑工具包 是什么?

该技能专门用于帮助开发者和 AI 代理高效使用 HyperFrames 的注册表功能。它解释了如何通过 `hyperframes add <name>` 命令安装可复用的块(独立子合成)和组件(效果片段),以及如何将它们无缝接入现有的宿主合成中。对于块,需要设置 `data-composition-src`、`data-composition-id`、`data-start` 等属性;对于组件,则需要手动将 HTML、CSS 和 JS 片段粘贴到对应的位置。技能还提供了配置安装路径(通过 `hyperframes.json`)、浏览注册表可用项(通过 curl 读取 `registry.json`)以及处理高级场景(如指定目标目录或生成机器可读输出)的指导。支持的命令行选项包括 `--dir`、`--json` 和 `--no-clipboard`,适用于本地开发和 CI/无头环境。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-skills/hyperframes-registry

在你喜欢的 AI 中提问

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

文档

HyperFrames 注册表

注册表提供可通过 hyperframes add <name> 安装的可复用块和组件。

  • 块 — 独立的子合成(有自己的尺寸、时长、时间线)。通过宿主合成中的 data-composition-src 引入。
  • 组件 — 效果片段(没有独立尺寸)。直接粘贴到宿主合成的 HTML 中。

何时使用此技能

  • 用户提及 hyperframes add、“块”、“组件”或 hyperframes.json
  • hyperframes add 的输出出现在会话中(文件路径、剪贴板片段)
  • 你需要将已安装的项目接入现有合成
  • 你想了解注册表中有什么可用项

快速参考

hyperframes add data-chart              # 安装一个块
hyperframes add grain-overlay           # 安装一个组件
hyperframes add shimmer-sweep --dir .   # 指定目标项目
hyperframes add data-chart --json       # 机器可读输出
hyperframes add data-chart --no-clipboard  # 跳过剪贴板(CI/无头环境)

安装后,CLI 会打印写入了哪些文件以及一个可以粘贴到宿主合成中的片段。该片段是一个起点——在接入块时,你需要添加 data-composition-id(必须与块的内部合成 ID 匹配)、data-start 和 data-track-index 属性。

注意:hyperframes add 仅适用于块和组件。对于示例,请改用 hyperframes init <dir> --example <name>。

安装位置

块默认安装到 compositions/<name>.html。 组件默认安装到 compositions/components/<name>.html。

这些路径可在 hyperframes.json 中配置:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

详见 install-locations.md。

接入块

块是独立合成——通过在宿主 index.html 中使用 data-composition-src 引入它们:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

关键属性:

  • data-composition-src — 块 HTML 文件的路径
  • data-composition-id — 必须与块的内部 ID 匹配
  • data-start — 块在宿主时间线中出现的时间(秒)
  • data-duration — 块播放的时长
  • data-width / data-height — 块画布尺寸
  • data-track-index — 图层排序(数值越大越靠前)

详见 wiring-blocks.md。

接入组件

组件是片段——将它们的 HTML 粘贴到合成标记中,CSS 粘贴到样式块中,JS(如果有)粘贴到脚本中:

  1. 读取已安装的文件(例如 compositions/components/grain-overlay.html)
  2. 将 HTML 元素复制到合成的 <div data-composition-id="..."> 中
  3. 将 <style> 块复制到合成的样式中
  4. 将任何 <script> 内容复制到合成的脚本中(时间线代码之前)
  5. 如果组件暴露了 GSAP 时间线集成(请参阅片段中的注释块),将这些调用添加到你的时间线中

详见 wiring-components.md。

发现

浏览可用项:

# 读取注册表清单
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

每个项的 registry-item.json 包含:name、type、title、description、tags、dimensions(仅块)、duration(仅块)和文件列表。

详见 discovery.md 了解按类型和标签过滤的详细信息。

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

govindgoel2001/video-editing-toolkit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

govindgoel2001/video-editing-toolkit

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

govindgoel2001/video-editing-toolkit

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 CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

相关技能