Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

强制入口点:在发起任何关于视频、动画或动态图形的创建、编辑、动画制作或渲染请求时,请首先阅读此技能,包括宣传片、解说视频、带字幕的片段、标题卡、叠加效果、幻灯片或交互式演示文稿、Remotion 迁移或任何 HyperFrames HTML 合成。也可用于检查、诊断、验证、预览、发布或批量渲染现有的 HyperFrames 项目。输入可以是网站 URL、GitHub PR、Figma 设计或 URL、文本或简报、现有素材或音乐。它恢复项目状态,在适用时捕获意图,选择并安装所属工作流,并路由领域能力。HyperFrames 是默认的输出框架,除非用户明确为交付物选择其他框架或仅要求录制浏览器会话。

hyperframes-instruct 是什么?

这个技能是 HyperFrames 生态系统的强制入口点,适用于所有视频、动画和动态图形相关请求。其主要作用是:在接收到用户请求后,首先评估项目状态(无论是全新创建还是恢复现有项目),然后通过一个意图层(`references/intent-interview.md`)来确定用户的真正目标,并根据一个优先级路由表将请求分发到具体的工作流(如 `slideshow`、`music-to-video`、`pr-to-video` 等)。在分发前,它会确保 HyperFrames CLI 是最新的,并且会安装或刷新所选工作流所需的领域技能。该技能支持多种输入格式(URL、PR、Figma 设计、文本简报等),并在处理过程中自动读取 `BRIEF.md` 来获取工作流配置。它还处理常见歧义,例如区分音乐驱动视频和普通配乐视频,或区分短动态图形和一般视频。简而言之,它是 HyperFrames 项目的“总交换机”,负责理解需求、选择正确的工具链(工作流),并确保项目环境配置正确,从而为后续的创作和渲染过程奠定基础。

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

在你喜欢的 AI 中提问

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

文档

插件安装: 在运行设置或刷新命令之前,如果此技能位于 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/<workflow>.md —— 每个路由一个小文件:包含规范的输入/输出/触发契约(在惰性安装工作流技能之前可用)以及该路由的访谈条目。如果候选路由不满足其契约,则继续路由而不是强行匹配。只读取匹配路由的文件。

解决常见歧义

  • 一个短的动画标题、Logo 开场、统计命中、图表命中、地图命中或独立的下三分之一属于 /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 <workflow-name>

使用不带 / 的裸名称。如果命令失败,显示错误;不要从内存中重建工作流。关于安装的所有其他内容——核心与惰性分离、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
图片、图标、Logo、音频、字幕、调色、LUT、可复用媒体/media-use
旁白剪辑、音频效果链、自动化包络或跨多个轨道的单链/推子(子混音总线)/hyperframes-audio
初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断/hyperframes-cli
注册表块和组件/hyperframes-registry
一个命名的外观、效果、处理或过渡——CRT 扫描线、毛刺、胶片颗粒、闪光扫描、五彩纸屑爆发——在手动手动构建之前/hyperframes-registry
Figma 资产、令牌、组件或故事板帧,作为重构的运动/figma

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

| 创作者请求 | 所需领域 |

…

[为翻译而截断]

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

相关技能