Communitygithub.com

laviedezidane/hyperframes-skill

将产品链接或营销URL、粘贴的脚本或简介,转化为产品发布或推广视频。支持SaaS推广、功能介绍、产品演示、应用和公司发布。

hyperframes-skill 是什么?

该技能旨在将用户提供的营销材料(如产品URL、脚本或简介)自动转化为高质量的产品发布或推广视频。它支持SaaS推广、功能介绍、产品演示、应用启动等多种场景。技能工作流程包括项目初始化、资产捕获、设计系统配置、故事板与脚本生成、帧级动画制作以及最终渲染。它集成了HyperFrames框架,可结合HeyGen等引擎处理音频和品牌资产。对于Figma源链接,技能会先处理资产导出和品牌令牌,确保品牌一致性和可维护性。平台支持包括HyperFrames、HeyGen和本地引擎。用户共获得了一个结构化的六步流程,其中包含验证门控,确保每一步的输出质量。

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

在你喜欢的 AI 中提问

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

文档

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

首先,保持技能更新——在运行前与用户确认: npx hyperframes skills update product-launch-video。若一切为最新,则快速无操作;否则,在依赖之前刷新此技能及其所依赖的核心领域技能。

media-use:在获取音频/图像/标志前,调用 /media-use 从HeyGen目录和官方来源解析BGM/SFX/图像及品牌标志。先运行 --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外,每个步骤都由你完成(步骤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 缺失时才初始化。以品牌或域的 kebab-case 命名 <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 或输出文件。

在 init 之后立即写入 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 并原样输出其结果。它报告语音/BGM将使用HeyGen还是本地引擎,以及当未登录时如何登录。注意退出码约定:auth status 在未登录时退出码为1(以及存储的凭据被拒绝时)—— 该非零退出是正常的未登录状态,而非命令失败,因此不要将其视为错误,不要重试,也不要使用 &&/set -e 链式调用以防止中止工作流。应用一个分支:

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

当没有离线提供者可用时,不要静默忽略必需的能力;应呈现阻塞点。不要将此决策并入另一个问题或将密钥写入每个仓库的 .env。认证归属和离线回退:/media-use references/setup-providers.md 第2节。

关卡: 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 <毫秒>,为下游工作留出时间。--timeout 仅控制页面导航。仅当有意禁用可选图像字幕时才使用 --skip-vision。

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

警告如非常少的文本内容同时资产目录为空时,并不能证明页面的可用性。对于网站导览或“按原样展示”的简介,要求可信的捕获结构或提供的截图;如果两者都不存在,则停止。不要仅仅因为捕获不可用就发明或重建页面。

对于网站导览或“按原样展示”的简介,捕获的页面是视觉真理源。使用真实截图,而不是重新构建完整的网站HTML。如果截图需要内部运动,将截图作为基础,并在测量位置叠加真实的捕获资产,或仅重建运动的那个组件。对于滚动截图,在 capture/screenshots/full-page.png 上对视口进行动画处理 —— 整个文档的1倍图,对于在其上移动的1920宽视口进行像素精确处理。当页面太高无法一次性捕获时,它不存在;回退到同一目录中重叠的滚动位置截图。推入超过1:1缩放时,需要该区域的自己的2倍捕获,因为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 <此工作流>,简介合同第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节:将计划作为建议呈现,并问两个问题 —— 批准或更改,以及是否先画草图(推荐)或跳过。反馈以

…

[出于翻译目的进行了截断]

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

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

相关技能