Communitygithub.com

laviedezidane/hyperframes-skill

搜索、安装注册表中的区块和组件,并将其接入 HyperFrames 合成。在对任何命名的视觉效果进行手工构建之前使用。

hyperframes-skill 是什么?

该技能是 HyperFrames 注册表的 AI 助手接口,允许开发者直接通过对话或 CLI 发现、安装并将可复用的区块和组件集成到 HyperFrames 合成中。它支持通过 `hyperframes add` 命令安装约 400 个托管项目(包括 CRT 扫描线、故障效果、图表、代码窗口等),通过语义或关键词搜索整个目录,以及将安装的组件拼接到 `index.html` 中。该技能支持在 Cursor、Claude Code 等 AI 编码代理中工作,提供标准的 `add`、`catalog`、`catalog --query` 等 CLI 操作,并包含发现、安装位置、区块/组件接线及上游贡献的完整工作流。其核心优势在于:搜索是本地进行的,不会发送数据;当查询没有结果时,可自动生成反馈命令以报告缺失功能;并内置了离线搜索的缓存机制。

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

在你喜欢的 AI 中提问

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

文档

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

HyperFrames 注册表

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

  • 区块 — 独立的子合成(拥有自己的尺寸、时长和时间线)。通过宿主合成中的 data-composition-src 引入。
  • 组件 — 效果代码片段(没有自己的尺寸)。直接粘贴到宿主合成的 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。

接入区块

区块是独立的合成——通过在宿主 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 — Studio时间线行;仅用于显示。层级叠加请使用 CSS z-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。

发现

以 CLI 作为主要发现工具。在浏览之前,先根据意图进行搜索: 注册表中的项目数超过人眼能浏览的数量,因此列出所有项目并按名称或标签匹配是慢速路径,并且当作者的措辞与你不同时会失败。

# 对整个目录排序,针对节拍应实现的效果
npx hyperframes catalog --query "reveal a headline one line at a time"
npx hyperframes add caption-clip-wipe

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

无论视频使用何种语言,始终用英语进行查询。 目录是用英语编写的,两个层级都以此方式索引(设备端模型也仅支持英语)。使用其他语言进行的查询不会产生可搜索的词汇,并且不会返回任何结果。在日语或中文项目中,这很容易出错——简报、字幕和旁白都是该语言,查询也自然跟随:用英语描述 动作,然后用视频需要的任何语言编写屏幕上显示的副本。如果查询返回 No searchable words in query,那就是此规则的问题,而不是缺少组件,也不值得填写差距报告。

可安装性是在排序之后应用的,而不是之前:向量携带但此注册表无法提供的名称会从结果中删除,并计入 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 中的完整想法 → 搭建 → 构建 → 验证 → 预览 → 发布工作流。入门模板(字幕 / VFX / 组件 / registry-item.json)位于 templates.md。

Individual skills in this repo

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

Agent Media OS for 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. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

相关技能