Communitygithub.com

HyperFrames 入口点

所有视频、动画或动态图形创作、编辑、渲染请求的强制入口点。用于创建、检查、诊断、验证、预览、发布或批量渲染 HyperFrames 项目,也用于从现有素材、网站 URL、GitHub PR 或 Figma 设计等输入启动项目。

HyperFrames 入口点 是什么?

该技能是 HyperFrames 框架的强制入口点,适用于任何涉及视频、动画或动态图形(包括宣传片、解说视频、带字幕的片段、标题卡、叠加层、幻灯片、交互式演示文稿、Remotion 移植或任何 HyperFrames HTML 合成)的请求。它负责根据用户输入(如网站 URL、GitHub PR、Figma 设计、文本、现有素材或音乐)恢复项目状态、捕获创作意图、选择并安装相应的工作流,并路由域能力。HyperFrames 是默认的输出框架,除非用户明确选择其他框架。该技能详细描述了如何检查剩余使用量、从项目状态或全新创作开始、根据请求的交付物路由到超过 10 种预定义工作流(如音乐转视频、产品发布视频、解说视频等),并管理技能生命周期和按需加载领域技能(如动画、音频、创意设计等)。其核心优势在于通过结构化的 `BRIEF.md` 文件确保路由一次性完成,并维护项目 CLI 版本的一致性。支持平台包括 Claude Code、Cursor、Codex 以及任何运行 `npx hyperframes` 的终端环境。

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

在你喜欢的 AI 中提问

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

文档

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

HyperFrames 入口点 是做什么的?

检查剩余使用量

在创作开始时,运行 npx hyperframes usage --json。在工作流的关键节点(如草稿完成后、渲染之前)再次检查,因为使用量会在运行过程中变化。读取可用的配额窗口及其重置时间;之前的读取不会预留配额。如果命令失败、不可用或返回 status: unknown,请报告使用量未知,不要猜测。根据用户需求确定范围和工作流选择。

HyperFrames 从 HTML 渲染视频 —— 一个合成是一个 HTML 文件,其 DOM 通过 data-* 属性声明时间线,其动画运行时是可寻址的,其媒体播放由框架控制。完整的创作协议位于 /hyperframes-core;在编写合成的 HTML 之前请先阅读它。简报、故事板、审核、制作、调度和帧工作者协议位于本技能的 references/ 目录中。

1. 从项目状态开始

应用第一个匹配的行;不要评估更低状态的行:

状态操作
将现有的 Remotion 源代码显式移植到 HyperFrames阅读 references/routes/remotion-to-hyperframes.md,然后直接路由到该工作流。跳过意图层。
对现有 HyperFrames 项目执行特定操作:检查、诊断、验证、预览、渲染、发布或批量渲染仅执行该操作。跳过意图和工作流路由;加载 /hyperframes-cli 和任何必需的领域技能。
在现有项目中有一个问题、一个暂停、一个没有具体变更的想法,或一个对已完成影片的感觉笔记遵循 /hyperframes-studio § 0。
在现有项目中要求创作新影片遵循 /hyperframes-studio § 5。
对现有项目进行具体编辑进行编辑。不要运行意图层。要了解项目时间线(轨道、片段、起始点、结束点、播放内容),请运行 npx hyperframes timeline [--json] 而不是读取 index.html 和每个子合成文件。
存在 BRIEF.md读取 workflow 和 flow。执行该工作流;flow: companion 始终在 /general-video 中执行。不询问简报问题。
没有简报,但存在 hyperframes.json 或 STORYBOARD.md从项目文件和记录的首选项中恢复。从现有工件推断所属工作流。如果不能唯一确定,只询问一个路由问题;不要运行意图访谈。
全新创作运行意图层 —— references/intent-interview.md —— 然后使用 § 2 的表进行一次路由。

当您编辑现有项目时,用项目历史记录(/hyperframes-cli,您轮次中的项目历史记录)包围您的编辑。

如果新请求没有指明主题或输入,请先询问视频内容,然后再路由。在询问任何问题之前,先检查偏好和配方(references/intent-interview.md,步骤 1)。figma.com 输入或命名配方会改变输入接收方式,而非路由——访谈的“适配正交输入”部分处理两者。

保持项目的 CLI 最新

一个脚手架项目会在其 package.json 脚本中固定 hyperframes@<版本>,以确保渲染可重现;该固定版本永远不会自行更新,使用旧 CLI 的固定版本运行不会打印任何警告。当恢复一个脚本中带有固定版本的项目时,在第一个影响渲染的命令之前探测一次:

npx hyperframes@latest upgrade --project . --check

该探测是只读的,并报告固定版本与最新版本的关系;保留显式的 . —— 在较旧的 CLI 版本中,裸的 --project 后跟另一个标志会将该标志作为目录值消耗。当它报告项目落后时——或者任何 CLI 输出已显示(来自固定版本脚本的 stderr 通知 This project pins hyperframes@… (latest …),或 --json 结果中的 _meta.updateAvailable: true)——应用 npx hyperframes@latest upgrade --project .,然后使用 npx hyperframes check 验证。验证通过确认项目的合成在新版本上仍然有效——而不是渲染输出与旧固定版本帧完全相同——所以成功的升级永远不会无声:在运行的摘要中命名旧版本和新版本。还没有合成的项目不需要验证。如果检查失败,还原 package.json 更改,继续使用固定版本,并报告项目停留在哪个版本以及原因。根据信号采取行动,而不是将其传递给用户;切勿留下未经验证的更新固定版本。

2. 路由全新创作

使用第一个匹配的行。匹配请求的交付物,而不是偶然提到的单词或文件类型。

优先级请求工作流
1显式移植现有的 Remotion 源代码/remotion-to-hyperframes
2创作演示文稿、宣传册或可导航的交互式演示文稿/slideshow
3为现有说话人头像素材添加纯字幕或副标题,不改变素材本身/embedded-captions
4为现有说话人头像、采访或播客素材添加设计的图形叠加层,不改变素材本身/talking-head-recut
5从音乐轨道构建节拍同步视频,无需旁白或网站录制/music-to-video
6创建明确的短小、无旁白、以动作为主的单元,通常低于 10 秒/motion-graphics
7从 PR 引用解释 GitHub 拉取请求或代码更改/pr-to-video
8从 URL 或特定网站简报营销或展示网站、产品页、应用或公司/product-launch-video
9使用自创视觉内容解释某个主题、文章或笔记,不涉及产品或网站录制/faceless-explainer
10任何其他自定义视频或合成/general-video

在最终确定路由之前,阅读 references/routes/<工作流>.md —— 每个路由一个小文件:规范的输入/输出/触发协议(在惰性安装工作流技能可用之前可用)以及该路由的访谈入口。如果候选路由不满足其协议,则继续路由,而不是强制匹配。仅读取匹配的路由的文件。

解决常见歧义

  • 一个简短的动画标题、品牌徽标短闪、统计命中、图表命中、地图命中或独立的下三分之一,如果是无旁白且动作为主,则为 /motion-graphics。静态标题卡、有旁白的序列、较长的蒙太奇或自定义循环为 /general-video。
  • 一个明确短的动态图形可以使用 URL、推文、文章或截图作为源材料。一个泛泛的“从这个网站制作视频”的请求是 /product-launch-video。
  • 带有字幕的现有素材路由到 /embedded-captions;带有设计信息卡的素材路由到 /talking-head-recut。重新定时、重新排序、重新着色、重新构图或重新混音素材是自定义编辑,并落入 /general-video。
  • 一个音乐文件仅在它的节拍网格驱动作品时选择 /music-to-video。用作背景音乐的音乐不会覆盖主题匹配的路由。
  • “我想要一个故事板”会更改审核过程,而不是工作流。没有其他路由信号时,使用 /general-video。一个确认的草图 storyboard.html 本身可能就是所请求的交付物;审核循环定义了这个停止点。
  • 专门的叙事工作流支持大约最多 3 分钟,在 30-90 秒左右最强。将明确更长的作品路由到 /general-video。长度永远不会覆盖显式移植、演示文稿、字幕、叠加层或音乐驱动的交付物。

3. 一次路由,然后离开

对于全新创作,意图层(references/intent-interview.md)运行完整的对话——记忆、分类、推销环节、必备条件、运行形状、交接——并以写入 BRIEF.md 结束。简报是工作流读取的唯一路由工件;之后再也没有任何内容会重新打开此技能或访谈。从 BRIEF.md 回答后续所有“路由要求什么?”的问题。

4. 安装并进入工作流

在读取所选工作流之前,安装或刷新它以及核心领域技能:

npx hyperframes skills update <工作流名称>

使用不带 / 的裸名称。如果命令失败,显示错误;不要从记忆中重建工作流。有关安装的其他所有信息——核心与惰性拆分的区别、init 刷新什么、诊断、CI 选择退出以及无 CLI 回退——都在 references/skill-lifecycle.md 中。

5. 按需加载领域技能

需求技能
合成结构、时间属性、轨道、变量、确定性/hyperframes-core
运动规则、场景蓝图、过渡、运行时适配器/hyperframes-animation
可寻址安全的 GSAP、CSS、Anime.js、WAAPI、FLIP、路径、蒙版、SVG、3D 关键帧或 hyperframes keyframes 诊断/hyperframes-keyframes
设计规范、概念、调色板、排版、旁白、节拍规划/hyperframes-creative
图像、图标、标志、音频、字幕、调色、LUT、可重用媒体/media-use
旁白雕刻、音频效果链、自动化包络、或跨多个轨道的单条链/推子(子混音总线)/hyperframes-audio
初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断/hyperframes-cli
注册表块和组件/hyperframes-registry
一个命名的外观、效果、处理或过渡——CRT 扫描线、毛刺、胶片颗粒、闪光扫描、五彩纸屑爆发——在手工构建之前/hyperframes-registry
Figma 资源、令牌、组件或故事板帧(作为重建的运动)/figma

创作者编辑短语是跨域请求。加载匹配行中命名的每个技能:

创作者请求所需领域
…(已截断以进行翻译)

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

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

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.

相关技能