Communitygithub.com

laviedezidane/hyperframes-skill

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

hyperframes-skill 是什么?

这个技能是 HyperFrames 视频生成框架的强制入口点,用于处理任何视频、动画或运动图形的创建、编辑、渲染和发布请求。它通过读取项目状态(如 `BRIEF.md`、`hyperframes.json` 或 `STORYBOARD.md`)来恢复工作,并利用一个状态驱动的决策表来决定具体的操作,例如直接编辑、运行意图层(用于全新的创作)或执行特定的操作(如检查、诊断、渲染)。该技能支持多种平台(如 Claude Code、Cursor、Codex),并提供了详细的路由逻辑,将请求映射到专门的工作流,例如 `/slideshow`(幻灯片)、`/pr-to-video`(PR 转视频)或 `/music-to-video`(音乐转视频)。核心功能包括:使用 `npx hyperframes usage --json` 检查使用配额、使用 `npx hyperframes@latest upgrade --project .` 保持 CLI 版本最新、根据交付物类型(如 deck、explainer、motion graphic)自动路由、以及按需加载领域技能(如 `/hyperframes-core`、`/hyperframes-animation`)。工作流会先生成一个 `BRIEF.md` 文件,然后根据该文件执行,从而确保一致且高效的生产流程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/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@<version>,以确保渲染结果可重现;该固定版本不会自行更新,并且旧版 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 — 每个路由一个小文件:规范的输入/输出/触发合约(在延迟安装的工作流技能存在之前可用)以及该路由的面谈入口。如果候选者不满足其合约,则继续路由,而不是强制匹配。仅阅读匹配的路由文件。

解决常见歧义

  • 短的动画标题、徽标标、统计命中、图表命中、地图命中或独立的下三分之一属于 /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
图像、图标、标志、音频、字幕、调色、LUT、可复用媒体/media-use
画外音雕刻、音频效果链、自动化包络,或多轨道上的一个链条/推子(子混音总线)/hyperframes-audio
初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断/hyperframes-cli
注册表块和组件/hyperframes-registry
命名的外观、效果、处理或转场 — CRT 扫描线、故障、胶片颗粒、闪光扫描、五彩纸屑爆发 — 在手动构建之前/hyperframes-registry
Figma 资源、令牌、组件或故事板帧作为重构的运动/figma

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

创作者请求所需领域

…

[truncated for translation]

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

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

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.

相关技能