Communitygithub.com

Sma1lboy/rove

安装并将注册表块和组件接入 HyperFrames 编排中。适用于运行 hyperframes add、安装块或组件、将已安装项接入 index.html,或编辑 hyperframes.json 的场景。涵盖 add 命令、安装位置、块子编排接入、组件片段合并、注册表发现以及编写新块或组件以向上游贡献的完整流程(构思 → 搭建 → 验证 → PR)。

rove 是什么?

HyperFrames Registry 是一个面向 HyperFrames 编排系统的可复用块和组件库,通过 `hyperframes add <name>` 命令进行安装。它支持两种类型的构件:块(Block)是具有独立尺寸、时长和时间线的子编排,通过 `data-composition-src` 属性嵌入到宿主编排中;组件(Component)则是不含独立尺寸的特效片段,直接粘贴到宿主编排的 HTML 中。该技能覆盖了从安装、接入到向上游贡献的完整开发者工作流:包括使用 CLI 安装块和组件、理解默认与可配置的安装路径、通过 HTML 属性(如 `data-composition-src`、`data-composition-id`、`data-start` 等)正确接入块,以及手动整合组件的 HTML、CSS 和 JavaScript 片段。此外,它还提供了通过 `curl` 浏览注册表清单进行发现的能力,以及从构思、搭建、验证到预览、提交 PR 的全套贡献指南。该技能适用于所有支持 HyperFrames 的开发环境(如任何现代 Web IDE),帮助开发者高效管理 HyperFrames 编排中的可复用构件。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/hyperframes/registry

在你喜欢的 AI 中提问

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

文档

HyperFrames 注册表

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

  • 块(Blocks) — 独立子编排(拥有自己的尺寸、时长、时间线)。通过宿主编排中的 data-composition-src 属性引入。
  • 组件(Components) — 特效片段(没有自己的尺寸)。直接粘贴到宿主编排的 HTML 中。

快速参考

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 包含:名称、类型、标题、描述、标签、尺寸(仅块)、时长(仅块)以及文件列表。

详见 discovery.md 了解如何按类型和标签筛选。

贡献新的块或组件

要编写一个新的注册表项(字幕样式、VFX 块、过渡、底部三分之一或可复用组件)并将其作为上游 PR 发布——而非安装现有项——请遵循 contributing.md 中完整的构思 → 搭建 → 构建 → 验证 → 预览 → 发布工作流。启动模板(字幕 / VFX / 组件 / registry-item.json)可在 templates.md 中找到。

Individual skills in this repo

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

Sma1lboy/rove

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.\n

Sma1lboy/rove

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Sma1lboy/rove

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=\"clip\"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Sma1lboy/rove

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, beat planning, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-motion`.

Sma1lboy/rove

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

相关技能