Communitygithub.com

nateherkai/hyperframes-student-kit

安装并将注册表块与组件接入 HyperFrames 合成。适用于运行 hyperframes add、安装块或组件、将已安装项接入 index.html 或处理 hyperframes.json 时。涵盖 add 命令、安装位置、块子合成接入、组件代码片段合并以及注册表发现。

hyperframes-student-kit 是什么?

该技能为 HyperFrames 注册表提供全面支持,允许用户通过 `hyperframes add <name>` 命令安装可复用的块(Blocks)和组件(Components)。块是独立的子合成,拥有自己的尺寸、时长和时间线,通过 `data-composition-src` 属性包含在主合成中;组件是效果代码片段,无独立尺寸,直接粘贴到主合成的 HTML 中。技能覆盖了安装位置配置(通过 `hyperframes.json` 自定义路径)、块接入(设置 `data-composition-id`、`data-start` 等关键属性)和组件接入(复制 HTML、CSS、JS 并集成 GSAP 时间线)的完整工作流。此外,还帮助用户通过注册表清单发现可用项,并按类型或标签进行筛选。支持 Cursor 和 Claude Code 等 AI 编码工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-registry

在你喜欢的 AI 中提问

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

文档

HyperFrames 注册表

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

  • 块 — 独立的子合成(拥有自己的尺寸、时长和时间线)。通过 data-composition-src 包含在主合成中。
  • 组件 — 效果代码片段(无独立尺寸)。直接粘贴到主合成的 HTML 中。

何时使用此技能

  • 用户提到 hyperframes add、"block"、"component" 或 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。

接入块

块是独立的合成——通过 data-composition-src 包含到你的宿主 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>

关键属性:

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

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

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.

nateherkai/hyperframes-student-kit

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

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

相关技能