Communitygithub.com

HyperFrames 注册表

搜索、安装并将注册表中的块和组件集成到 HyperFrames 作品中。在手动构建任何命名视觉效果之前使用,如CRT扫描线、故障效果、色差、胶片颗粒等。

HyperFrames 注册表 是什么?

HyperFrames 注册表技能帮助用户高效发现和安装可复用的视觉块和组件,适用于 HyperFrames 平台。它提供约400个托管项,涵盖CRT扫描线、故障效果、色差、胶片颗粒、闪烁扫描、图表、代码窗口、地图或五彩纸屑爆发等常见视觉效果。该技能支持通过 CLI 命令(如 `hyperframes add`、`hyperframes catalog`)进行搜索、安装和集成,并具备智能搜索功能,支持关键词和语义匹配。安装后,它会提供代码片段以嵌入主合成中,并处理依赖关系。此外,该技能还支持创建新块或组件并向上游贡献,涵盖从构思、搭建、验证到PR的完整流程。

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

在你喜欢的 AI 中提问

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

文档

插件安装: 在执行设置或刷新命令之前,当此技能位于 HyperFrames 插件内部时,请遵循插件执行规则。独立安装则保留下面的更新说明。

HyperFrames 注册表 是做什么的?

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

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

快速参考

hyperframes add data-chart              # 安装一个块
hyperframes add grain-overlay           # 安装一个组件
hyperframes add captions                # 安装所有标记为 captions 的块
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 — Studio 时间线行;仅用于显示。使用 CSS z-index 进行分层

详见 wiring-blocks.md。

连接组件

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

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

详见 wiring-components.md。

发现

将 CLI 作为主要的发现界面。在浏览之前按意图搜索: 注册表包含的项目比肉眼能扫描的要多,因此列出并通过名称或标签匹配是慢路径,并且当作者的措辞与你的不同时会失败。

# 根据节拍应执行的操作对整个目录进行排名
npx hyperframes catalog --query "reveal a headline one line at a time"
npx hyperframes add caption-clip-wipe

搜索是本地进行的,不发送任何数据。默认情况下,它根据与项目名称、标题和描述共享的词汇进行排名,因此只找到使用你词汇的项目;--on-device 则根据含义进行排名(需要一次性模型下载)。使用 --json 时,信封会标明回答的层级,因此请检查该层级而不是假设排名已发生。

始终用英文查询,无论视频使用何种语言。 目录是用英文编写的,两个层级都以此索引(本机模型也仅支持英文)。使用其他语言的查询不会产生可搜索的术语,并且不会返回任何结果。在日语或中文项目中很容易犯这个错误,因为简报、字幕和旁白都是该语言,查询自然也会随之而来:用英文描述 动作,然后以视频所需语言编写屏幕上的文案。如果查询返回“查询中无可搜索的词语”,则是此规则导致的,而不是缺少组件,也不值得报告差距。

可安装性是在排名之后应用的,而不是之前:向量携带但此注册表无法提供的名称将从结果中删除,并计入 dropped,因此非零的 dropped 意味着两者属于不同代际。有关离线层级、同意门以及如何刷新过时索引,请参见 /hyperframes-cli。

要浏览或筛选而不是搜索:

npx hyperframes catalog
npx hyperframes catalog --type block
npx hyperframes catalog --type component
npx hyperframes catalog --type block --tag social
npx hyperframes catalog --json
npx hyperframes catalog --human-friendly

普通表格和 --json 模式仅列出匹配项;使用 hyperframes add <name> 安装选定的名称。--human-friendly 打开交互式选择器并立即安装所选项目。在 CI 或代理工作流中,优先使用 --json 后跟显式的 add。

报告目录中缺失的内容

当搜索结果为空且没有适合的项目时,在手动创建特效之前报告:

npx hyperframes feedback --search-miss "<你运行的查询>" --wanted "<你需要的特效>" --tier <回答的层级>

catalog --query 会为你打印此行,预填充,并且 --json 将其作为 report_gap 携带——因此在你决定没有适合的东西时,它已经在你手中。

每当任一层级的结果都不适合时,请报告。 不要等到本机层级回答:它需要经过同意的33 MB下载,因此除非显式选择加入,否则代理运行在 words 层级上,并且如果局限于 on-device 几乎会沉默所有报告。--tier 值随之传递,以便在阅读时区分词汇未命中与含义未命中。描述你期望的效果,而非你想象的项目名称:返回的是值得构建的特效列表,而报告一个不存在的项目没有任何价值。这是唯一将查询发送到任何地方的路径,正是为什么它是一个单独的、有意的命令,而不是搜索自动执行的操作。它不携带评分,也绝不会进入评分指标。

这是目录的完整需求信号。跳过它意味着你遇到的缺失会被从安装计数中猜测,而这无法看到没有人能安装的特效。

如果 CLI 无法访问配置的注册表,检查原始清单作为后备:

curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

CLI 无法访问的注册表不会清空目录以进行发现:当重新验证失败时,先前获取的清单会继续在24小时刷新窗口之外提供服务,因此 catalog 和 catalog --query 仍然会根据磁盘上的最后副本列出和排名。

即使是你昨天安装的项目,add 仍然需要网络。 只有清单被缓存;项目的实际文件每次安装时都会获取。因此离线时可以搜索,可以看到项目是什么,但安装会在文件获取时失败。不要向用户承诺离线安装。

每个项目的 registry-item.json 包含:名称、类型、标题、描述、标签、尺寸(仅块)、时长(仅块)和文件列表。

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

贡献新的块或组件

要创作一个新的注册表项目(字幕样式、VFX 块、过渡、低三分之一或可复用组件)并将其作为上游 PR 提交——而非安装现有项目——请按照 contributing.md 中的完整构思→搭建→构建→验证→预览→发布工作流进行操作。starter 模板(字幕/VFX/组件/registry-item.json)的复制粘贴模板位于 templates.md。

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

samyakiasonline-ctrl/hyperframe

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

samyakiasonline-ctrl/hyperframe

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

samyakiasonline-ctrl/hyperframe

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

samyakiasonline-ctrl/hyperframe

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

samyakiasonline-ctrl/hyperframe

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

samyakiasonline-ctrl/hyperframe

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

samyakiasonline-ctrl/hyperframe

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

相关技能