Communitygithub.com

Elis3omndz/Claude_Skills

将产品/营销URL、粘贴的脚本或简介转化为产品发布/推广视频——适用于SaaS宣传、功能展示、产品演示、应用和公司发布。当用户想要营销、发布、推广或展示产品时使用;也是处理任何商业URL的默认选项。网站导览/展示也归此处理——简介中带有“按原样展示”的意图。不明确时 → /hyperframes。

Claude_Skills 是什么?

该技能旨在将产品信息转化为专业的产品发布视频。它作为一个编排器,指导用户从初始设置到最终视频渲染的完整工作流程。它处理产品URL、粘贴的脚本或简介,并支持网站导览和展示。工作流包括几个关键步骤:设置项目(包括处理预聚焦的简介)、捕捉品牌资产、定义设计系统、构建故事板/脚本、创建每一帧,最后渲染视频。该技能利用了HyperFrames框架,并与媒体资产、品牌调色板、预设和动画蓝图集成。它包含用户驱动的审批门控,用于故事板、视觉设计和最终渲染,可在自主和协作模式下运行。支持通过HeyGen或本地引擎进行语音和背景音乐处理,并为Figma源集成提供了特定步骤。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/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 source:如果来源是 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 缺失时才初始化。用品牌或域名的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 或输出文件。

在初始化之后立即写入 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 § Providers。

门控: 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捕捉后,不要人为地制造一个合成式的无捕捉回退。仅在原始简介提供了源材料,或用户在失败后明确切换到提供的截图或简介时,才继续执行无捕捉路径。

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

对于网站导览或“按原样展示”的简介,捕捉到的页面是视觉真相来源。使用真实截图而不是在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 <名称> --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合适,则记录一个候选蓝图ID。故事的真实性仍然决定哪些节拍存在——绝不要强制一个节拍去适应蓝图,也绝不要仅仅因为有一个经过验证的形状可用就发明一个节拍。从 capture/extracted/asset-descriptions.md(规范清单)中选择每个视觉帧的 asset_candidates——不要浏览原始的 capture/assets/。除非该清单缺失或不可用,否则不要要求用户选择资产。使用来自故事板和脚本参考的具体必需字段。

草拟后,运行审查循环的计划通读——../hyperframes/references/review-loop.md § 1:将计划作为提案呈现,并询问两个问题——批准或更改,以及先看草图(推荐)还是跳过。反馈以聊天回复形式到达;循环直到获得批准。这是一个检查点门控(简介合同 § 1):在自主模式下,如果用户已配置偏好此操作,则门控可以自动通过;否则会在该点暂停。通过后,如果用户要求先看草图,则在不运行完整的帧构建的情况下为每个故事板帧生成草图,然后进入审查循环的草图通读(§ 2);否则,跳过草图并直接进入步骤4。

门控: 故事板(和脚本,如果需要)已写入并获得批准;关于先看草图的决定已做出;BRIEF.md 的前言已更新为 status: drafting → under_review → storyboard_approved,具体取决于审查状态。


步骤3.1:音频源

目标:为视频解决BGM和画外音音频源。

首先运行 /media-use 来解决此问题:它会处理HeyGen或本地引擎的BGM/SFX/图像以及官方品牌的标志。请参阅 /media-use 技能以获取详细工作流。

如果选择HeyGen,请运行相关命令来注册资产并从其目录中选择BGM。

如果使用本地引擎或HeyGen不可用,则设置本地音频源的 audio_meta.json 配置。该文件应包含BGM和任何画外音片段的路径和持续时间信息。


步骤4:视觉设计

目标:为每个故事板帧分配一个具体的视觉布局、动画蓝图和复合指令。

阅读 ../hyperframes-creative/references/visual-design.md、../hyperframes-animation/blueprints/<候选蓝图>/*.md 以获得工作流程和指令。使用 ../hyperframes-animation/references/layout-engine.md 获取布局规则,使用 ..、hyperframes-animation/references/motion-philosophy.md 获取运动模式。更新 STORYBOARD.md,为每个帧添加 layout、motion_blueprint 和 composite_instructions 键。使用规范资产清单 capture/extracted/asset-descriptions.md 中的资产ID。

STORYBOARD.md 中的现有 asset_candidates 是指向 capture/ 中资产ID的指针。不要将原始文件路径放入 STORYBOARD.md;而是使用规范的资产ID。

门控(检查点,简介合同 § 1): 视觉设计已作为提案呈现并已批准。BRIEF.md 的前言已更新为 storyboard_approved → visual_design_approved。


步骤5:帧创建

目标:基于批准的视觉设计,为视频的每一帧渲染单个HTML文件。

遵循 ../hyperframes-animation/references/composition-rules.md 以获取工作流程和指令。从 STORYBOARD.md 读取帧列表。对于每一帧,调用一个框架创建子代理(您自己是编排器)。该子代理应在 compositions/frames/NN-<简短描述>.html 创建一个独立的HTML文件。它必须使用 frame.md 中定义的设计令牌,遵循所选的动画蓝图,并使用 capture/assets/ 中的资产。它不应假设视频布局的外部框架——每一帧都是独立的。

第一帧必须是标题帧(NN-01-title-card.html),最后一帧必须是结尾帧或行动号召帧。

创建compositions/frames/index.html作为测试查看器。

门控: 所有预期帧的HTML文件都存在,并且index.html显示帧序列。


步骤6:最终渲染

目标:将所有帧合成最终视频,添加音频,并进行审查。

使用npx hyperframes render compositions/frames/index.html renders/video.mp4进行最终渲染。假设渲染器会基于frame.md中的设计令牌处理分辨率、编解码器和帧合成。

渲染后,运行npx hyperframes play renders/video.mp4播放视频。

通过呈现视频和计时的剪辑计划,让用户审查,记录最终剪辑的持续时间。询问用户是否批准渲染。

门控(用户门控): 用户批准最终视频。如果需要,可以进行编辑——循环回到步骤3(故事板更改)或步骤5(仅帧更改)。

Individual skills in this repo

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

相关技能