Communitygithub.com

samyakiasonline-ctrl/hyperframe

将产品链接、营销URL、粘贴的脚本或简报转化为产品发布/推广视频,适用于SaaS推广、功能展示、产品演示、应用和公司发布等场景。

hyperframe 是什么?

「产品发布转HyperFrames」技能是一个AI编排器,专门用于将产品信息(URL、脚本或简报)转化为专业的发布或推广视频。它支持多种平台(如Claude Code、Cursor等),并确立了完整的工作流程:从第0步的设置(项目初始化、BRIEF.md创建、认证状态显示)开始,经过第1步的素材捕获(网站截图、资源提取)、第2步的设计系统(基于品牌令牌选择并定制预设框架),到第3步的故事板和脚本生成(使用创意参考和评审循环)。工作流的每一步都设有严格的“门控”检查点,确保只有通过验证后才能进入下一阶段,从而保证输出质量。该技能专为营销、发布、推广或演示产品的场景而设计,当用户意图不明确或需要制作其他类型的视频时,会引导用户通过`/hyperframes`进行意图判断。它依赖于HyperFrames生态系统中的多个子技能和模块(如`/media-use`、`/figma`、`hyperframes-creative`等),实现素材认证、品牌令牌绑定和动画编排等高级功能。

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

在你喜欢的 AI 中提问

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

文档

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

首先,保持此技能更新——在运行前确认用户: npx hyperframes skills update product-launch-video。当所有内容都是最新时,这是一个快速的无操作命令;否则,在您依赖此技能及它所依赖的核心领域技能之前,它会刷新它们。

media-use:在获取音频/图片/标志之前,调用 /media-use 从HeyGen目录解析背景音乐/音效/图片,并从其官方来源获取品牌标志。先运行 --adopt 注册现有资源。参见 /media-use 技能。

figma 源:如果源是一个 figma.com URL,先运行 /figma——如果需要,进行资源导出、品牌令牌和组件/故事板重建——然后从其输出构建此工作流。不要直接通过原始MCP工具驱动Figma:那样会跳过SVG清理、.media/manifest.jsonl 溯源记录以及品牌令牌 var() 绑定,因此后续的品牌更改无法在不完全重新导入的情况下传播。

产品发布转HyperFrames

使用此技能捕获一个产品,理解其品牌,规划一个发布视频,并在HyperFrames中逐帧构建。

前门是 /hyperframes。 你是编排者。运行每一步,验证其门控,然后才继续下一步。此技能适用于正在被营销、发布、推广或展示的产品,包括诸如“为我们的网站做推广”等请求,当目的是促销时。网站导览/展示请求也留在这里:BRIEF.md 携带了“按原样展示”的意图,捕获的截图将成为视频展示的资源。任何其他意图,一个简单的“制作视频”,或任何不确定性 → 先阅读 /hyperframes——意图层拥有每个路由决策,并且一个没有 BRIEF.md 的新创作无论如何都会通过它(设置的开场规则)。

你是编排者。在 videos/<project>/ 中工作。按顺序运行步骤,并在继续之前通过每个门控。用户门控步骤是步骤0、步骤3和步骤6。在步骤0之前阅读 ../hyperframes/references/brief-contract.md——它定义了门控类型以及如何从 BRIEF.md 的 flow/storyboard 推导出管理模式步骤3/4/6门控的模式。除了步骤5(你为每一帧分派一个子代理)之外,你自己执行每一步。不要在此处放置设计或运动规则;这些存在于帧工作子代理、此技能的本地 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ 以及 hyperframes-creative 中。

工作流:步骤0 设置 -> hyperframes.json;步骤1 捕获 -> capture/;步骤2 设计系统 -> frame.md;步骤3 故事板/脚本 -> STORYBOARD.md 和 SCRIPT.md;步骤3.1 音频 -> audio_meta.json;步骤4 视觉设计 -> 增强的 STORYBOARD.md;步骤5 帧 -> compositions/frames/NN-*.html 和 index.html;步骤6 最终渲染 -> renders/video.mp4。


步骤0:设置

目标:在确认的简报下进入,创建HyperFrames项目,并使简报持久化。

简报由意图层确认,而不是在此处通过提问确认。 开场规则,按顺序:(1) 存在 BRIEF.md → 阅读它且不提问任何问题——简报已定,其 flow/storyboard 推导出模式(简报合同第1部分)。(2) 没有 BRIEF.md 但项目存在(磁盘上有 hyperframes.json / STORYBOARD.md)→ 从故事板的前置元数据和记录的偏好中恢复;永远不要重新询问一个半成品的项目。(3) 两者都没有——一个直接到达这里的全新创作请求 → 阅读 /hyperframes 并运行其意图层(references/intent-interview.md):它检查配方和记住的默认值,进行此路由的问题(../hyperframes/references/routes/product-launch-video.md),并返回锁定的简报。编辑请求跳过所有这些——直接去执行编辑。

仅在缺少 hyperframes.json 时初始化。以烤串命名法从品牌或域名命名 <project>,例如 acme-promo;切勿使用工作空间名称或时间戳。

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init 检查已安装的技能与GitHub上的最新版本,并在任何技能过时时更新全局集合。

初始化后,让 <PROJECT_ROOT> 为 videos/<project>,并将所有后续的相对路径命令以此目录作为其工作目录运行。在下面的命令中,. 表示 <PROJECT_ROOT>;切勿在调用者目录中写入 .media、capture 或输出文件。

在初始化后立即写入 BRIEF.md(绝不在之前——init 拒绝非空目录):意图层锁定的简报,形状遵循 ../hyperframes/references/brief-format.md。将 <MEDIA_DIR> 解析为已安装的 /media-use 技能目录。然后使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 记录每个偏好支持的答案(brief-format.md 命名了子集)。如果意图层采用了一个配方,运行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它会将其 frame.md 复制到项目中(步骤2随后被跳过),并返回步骤3草稿的骨架。配方填充的是答案,而不是批准;审查门控仍然运行。

在继续之前显示登录状态 — 运行 npx hyperframes auth status 并逐字中继其输出。它报告语音/背景音乐将使用HeyGen还是本地引擎,以及当未登录时如何登录。注意退出代码契约:auth status 在未登录时以退出码1退出(以及当存储的凭据被拒绝时)——该非零退出是正常的未登录状态,不是命令失败,因此不要将其视为错误,不要重试它,也不要将其与 &&/set -e 连锁,以免中止工作流。应用一个分支:

  • 协作模式: 等待用户登录或明确选择 offline / go。
  • 自主模式: 说明状态并通过可用的本地引擎继续。

在没有离线提供者时,不要静默地忽略所需的能力;将障碍暴露出来。不要将此决策折叠到另一个问题中或将密钥写入每个仓库的 .env 中。认证所有权和离线回退:/media-use references/setup-providers.md 第提供者部分。

门控: 存在 hyperframes.json 和 BRIEF.md;偏好支持的答案已记录(简报合同第2部分);登录状态已显示(已登录,或继续离线)。


步骤1:捕获资源

目标:收集源材料、品牌信号以及视频可用的资源。

对输入进行分类并选择路径。明确的URL -> 捕获它,并使用网站进行解说和资源。粘贴的脚本/简报 -> 逐字保存为 user_script.txt;VO_MODE(逐字或重构)来自 BRIEF.md —— 当脚本到达时意图层会询问(仅在简报因某种原因缺少它时在此处询问一次)。然后解析捕获目标:文本中的URL -> 使用它;仅有品牌名称 -> WebSearch,在一行中确认URL,然后抓取;没有URL/网站(或简报说不要抓取)-> 无捕获路径。

运行捕获命令:npx hyperframes capture "<URL>" -o ./capture --json。保持默认的导航后预算,除非调用者拥有一个更小的截止日期;然后传递一个正数的 --capture-budget <milliseconds>,为下游工作留出时间。--timeout 仅控制页面导航。仅在可选图片字幕被有意禁用时使用 --skip-vision。

立即检查命令结果和输出目录。非零退出、JSON ok: false 或存在 capture/BLOCKED.md 是捕获路径的硬停止:报告记录的原因,并且不要消费部分截图、DOM、令牌或资源。不要在失败的URL捕获后制造合成性的无捕获回退。仅在原始简报提供了源材料,或用户在失败后明确切换到提供的截图或简报时,才继续通过无捕获路径。

诸如有 very little text content 之类的警告以及空的资源目录并不能证明有一个可用页面。对于网站导览或按原样展示的简报,需要可信的捕获结构或提供的截图;如果两者都不存在,则停止。不要仅仅因为捕获不可用就发明或重建页面。

对于网站导览或按原样展示的简报,捕获的页面是视觉事实来源。使用真实截图而不是用HTML重建整个网站。如果截图需要内部移动,保持截图作为基础,并在测量过的位置叠加捕获的真实资源,或者只重建移动的那个组件。对于滚动截图,将视口动画化在 capture/screenshots/full-page.png 上——整个文档的1倍板,对于一个沿其向下移动的1920宽视口是像素精确的。当页面太高无法一次性捕获时,该文件不存在;退回到同一目录中重叠的滚动位置截图。推入超过1:1需要该区域的自己的2倍捕获,因为1倍板没有高于1倍的回旋余地。仅在用户明确要求风格化解释时重建整个页面;不可用的捕获本身并不是授权。

如果存在 GEMINI_API_KEY、GOOGLE_API_KEY 或OpenRouter密钥,捕获会自动为资源添加字幕,存入 capture/extracted/asset-descriptions.md。这不是审查门控。如果没有视觉密钥,使用DOM上下文并继续。

无捕获路径:手动创建 capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/。tokens.json 应为 { "title": "", "description": "", "colors": [], "fonts": [] };尽可能从简报中填写标题/描述。visible-text.txt 包含完整的简报或脚本。asset-descriptions.md 应说明没有资源被捕获,除非用户给出了资源说明。

门控: 捕获JSON报告 ok: true;不存在 capture/BLOCKED.md;存在 capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/;并且你可以用一句清晰的话说明品牌。将 asset-descriptions.md 视为主资源清单。如果在真实捕获后它缺失,则停止并报告捕获不完整。关于降级可选阶段的警告只有在结构门控仍然通过时才可接受。


步骤2:设计系统

目标:选择一个已发布的帧预设;一个脚本会将其转化为此视频的 frame.md + 字幕皮肤。

当 BRIEF.md 命名了一个 style_preset —— 用户通过意图层的展示直观选择了它 —— 使用它;只有当简报未指定时,判断的抉择才由你做出。然后你做出唯一一个决定——哪个预设:阅读 ../hyperframes-creative/references/design-spec.md,并选择外观最符合品牌和简报的预设。然后运行:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

脚本确定性地完成其余工作:将预设的 FRAME.md 复制为 frame.md 并重新混编到 capture/extracted/tokens.json 中的品牌令牌上(品牌颜色按角色映射到预设的颜色键上——墨水色、画布色、强调色——保持键/结构/组件;将预设的显示字体+正文替换为品牌的字体),将预设的字幕皮肤复制到 .hyperframes/caption-skin.html,并进行自我验证(如果映射损坏则退出1)。一旦它以0退出,就进行下一步——无需手动编辑规范。

没有品牌颜色/字体的 tokens.json(例如没有捕获)→ 脚本会保留预设的调色板,这是一个完整可交付的设计。如果简报指定了捕获遗漏的品牌颜色/字体,在运行前将它们添加到 capture/extracted/tokens.json(或使用用户的 design.md 来填充它);仅在映射确实需要时,之后再手动调整 frame.md。

门控: build-frame.mjs 以0退出——来自命名预设的 frame.md 存在,并且(当预设提供时).hyperframes/caption-skin.html 作为字幕皮肤源存在;所选预设已记录为偏好(--key style_preset --workflow <this workflow>,简报合同第2部分)。


步骤3:故事板和脚本

目标:将简报和捕获的材料转化为一个经批准的逐帧故事计划。

阅读 ../hyperframes-creative/references/story-spine.md(钩子语言、价值优先于证据、故事板作为提案、源可追溯的视觉元素)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/script-format.md。使用它们来编写 STORYBOARD.md,并在需要解说时编写 SCRIPT.md。设置前置元数据 duration: 来自简报的 length —— 一个粗略的期望;组装报告最终剪辑相对于它的位置。

使用 story-design.md 进行故事蓝图、钩子、说服逻辑、节拍、VO_MODE 和资源选择。作为软指南,查阅 ../hyperframes-animation/blueprints-index.md 中的角色→蓝图菜单:对于每个节拍,当有合适的蓝图时,记录一个候选蓝图ID。故事真理仍然决定哪些节拍存在——永远不要强行让节拍适合蓝图,也永远不要仅仅因为一个经过验证的形状可用就发明一个节拍。从 capture/extracted/asset-descriptions.md(规范清单)中选择每个视觉帧的 asset_candidates —— 不要浏览原始的 capture/assets/。除非清单缺失或不可用,否则不要要求用户选择资源。使用来自故事板和脚本参考的确切必填字段。

起草后,运行审查循环的计划阶段 —— ../hyperframes/references/review-loop.md 第1部分:将计划作为提案呈现,并问两个问题——批准或更改,以及先草图(推荐)还是跳过。反馈以聊天回复形式到达;循环直到获得批准。这是一个检查点门控(简报合同第1部分):在自主模式下,用户可能在批准此点后离开;确保所有必要信息都被记录。


(注意:原始文档在此处被截断以进行翻译。完整的工作流包括步骤3.1音频、步骤4视觉设计、步骤5帧、步骤6最终渲染,以及相关的门控、引用和配置。此翻译忠实呈现了所提供的部分。)

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

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

相关技能