AGENT SKILL

hyperframes-registry

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

License 许可
MIT
最近更新
2026-10-11
Stars
★ 74
Forks
1

01 前言 Front Matter

name
hyperframes-registry
description
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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

02 资源文件 7

03 SKILL.md 正文

HyperFrames Registry

The registry provides reusable blocks and components installable via hyperframes add <name>.

  • Blocks — standalone sub-compositions (own dimensions, duration, timeline). Included via data-composition-src in a host composition.
  • Components — effect snippets (no own dimensions). Pasted directly into a host composition's HTML.

Quick reference

hyperframes add data-chart              # install a block
hyperframes add grain-overlay           # install a component
hyperframes add shimmer-sweep --dir .   # target a specific project
hyperframes add data-chart --json       # machine-readable output
hyperframes add data-chart --no-clipboard  # skip clipboard (CI/headless)

After install, the CLI prints which files were written and a snippet to paste into your host composition. The snippet is a starting point — you'll need to add data-composition-id (must match the block's internal composition ID), data-start, and data-track-index attributes when wiring blocks.

Note: hyperframes add only works for blocks and components. For examples, use hyperframes init <dir> --example <name> instead.

Install locations

Blocks install to compositions/<name>.html by default. Components install to compositions/components/<name>.html by default.

These paths are configurable in hyperframes.json:

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

See install-locations.md for full details.

Wiring blocks

Blocks are standalone compositions — include them via data-composition-src in your host index.html:

<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>

Key attributes:

  • data-composition-src — path to the block HTML file
  • data-composition-id — must match the block's internal ID
  • data-start — when the block appears in the host timeline (seconds)
  • data-duration — how long the block plays
  • data-width / data-height — block canvas dimensions
  • data-track-index — layer ordering (higher = in front)

See wiring-blocks.md for full details.

Wiring components

Components are snippets — paste their HTML into your composition's markup, their CSS into your style block, and their JS into your script (if any):

  1. Read the installed file (e.g., compositions/components/grain-overlay.html)
  2. Copy the HTML elements into your composition's <div data-composition-id="...">
  3. Copy the <style> block into your composition's styles
  4. Copy any <script> content into your composition's script (before your timeline code)
  5. If the component exposes GSAP timeline integration (see the comment block in the snippet), add those calls to your timeline

See wiring-components.md for full details.

Discovery

Browse available items:

# Read the registry manifest
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Each item's registry-item.json contains: name, type, title, description, tags, dimensions (blocks only), duration (blocks only), and file list.

See discovery.md for details on filtering by type and tags.

Contributing a new block or component

To author a NEW registry item (caption style, VFX block, transition, lower third, or a reusable component) and ship it as an upstream PR — not install an existing one — follow the full idea → scaffold → build → validate → preview → ship workflow in contributing.md. Copy-paste starter templates (caption / VFX / component / registry-item.json) are in templates.md.

04 同仓库更多 Skills

VideoVerses
VideoVerses/Cuti-Harness

external-shot-continuity

External continuity review method for long-form video projects.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

independent-story-workflow

Create a three-part story document without paid media generation.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

suno-song

Instruction helper: write a singable original Suno song from Bitwize (verbatim copy), then call suno.generate. Trigger: 原创歌曲, 写歌, Suno lyrics, $suno-song. Not a workflow.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

short-drama-workflow

Workflow for producing plot-dense short dramas with character and location reference sheets, complete 15-second Seedance segments, native dialogue, parallel multi-reference T2V generation, duration validation, and final assembly. Use for 爽文短剧、都市反转短剧、对白短剧、连续多段短剧,或用户明确调用 $short-drama-workflow. Do not use for product-centered scenario advertisements.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

seedance2

Workflow: 即梦 Seedance 视频创意工作台。图+文案→看图分析→文案扩写→运镜→API生成。 触发词:即梦、Seedance、seedance、视频提示词、AI视频、运镜、短剧广告、$seedance2.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

product-voiceover-narration

Design concise native voiceover for commercial product-video segments and bind each spoken line to verified selling points, visible actions, and exact timeline ranges. Use when a product advertisement should introduce the product through narration, when Seedance 2.0 should generate picture and voice together, or when product shots need coordinated narration, music, and sound direction. Do not synthesize a separate voice track and never invent product claims.

★ 74