Communitygithub.com

yazzang-homelab/motion-studio

品牌资产阶段的产品影片制作工具:从 URL 捕获真实截图、Logo、色彩和字体,永不重绘 UI;包含品牌故事节奏、语音和吉祥物。用于获取或修复品牌资产。

motion-studio 是什么?

Motion Studio 是一个 AI 驱动的技能,专为产品宣传影片的品牌资产阶段设计。它可以从用户指定的产品 URL 自动捕获真实的截图、Logo、色彩、字体和文案,确保影片素材与产品完全一致,而非使用占位符或虚构内容。该技能支持多视角、全页面截图和组件裁剪,并能提取网页字体和色彩变量,生成资产生成清单。它适用于 Claude Code 等平台,通过 `capture.mjs` 等脚本实现资产捕获,并提供 UI 状态和画布帧的捕获能力。使用前需确认字体许可,并注意对不受信任页面的安全防护。整个流程包括项目初始化、品牌捕获、组件分解、音乐节拍生成和故事板编排,最终集成到标准的 motion-reel 流水线中。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/product-reel

在你喜欢的 AI 中提问

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

文档

产品影片(课程步骤 04,级别 L2)

将工作室瞄准用户实际销售的产品。展示卷的能量保持不变;内容变为用户自己的:真实截图、真实 Logo、真实色彩和字体、真实文案、一个真实数字,以及音乐跟随的动态。品牌阶段之后的所有内容运行标准的 motion-reel 流水线。

请求参数(可能为空),仅显示一次;后续部分称为“上述请求”:

范围:当用户只希望捕获或修复资产,或者您从 motion-reel 的品牌阶段来到这里时,执行第 2 和 3 部分(以及第 4 部分,如果要求),报告,然后停止。对于全新的影片,遵循每个部分;第 5 至 8 部分交给 motion-reel 流水线。

模式的来源

  • Tony Dinh (@tdinh_me) 报告称,TypingMind 的宣传卷在 30 分钟内完成,而类似视频一年前花费他约 1000 美元以上。他的提示是展示卷单行代码加上四个简短方向行:介绍产品 URL;使用实际产品截图、Logo 和资产;视频必须有音乐,并且动态必须与音乐匹配;使其成为真正的专业制作,而不是演示或原型。他说 Claude 自行收集了品牌资产。
  • 他的后续要求将截图分解为组件和图标,以便它们可以移动,而不是显示原始截图,并使动态更丰富。这就是下面的组件规则。
  • 他的提示以“Try again, ultracode.”结束。在当前 Claude Code 中,ultracode 是一个关键字,使 Claude 为该任务编写多代理工作流。它是否驱动了他的结果并未记录;不要将其呈现为质量开关。
  • Rob Hallam (@robj3d3) 在同一个 Claude Code 对话中为他的产品制作了第二个宣传卷,就像他的第一个一样。该课程推断引擎被重用;因此每个品牌对应一个会话和一个项目。
  • 一个反例:@mablesjoseph 要求从资产文件夹中通过一行代码制作一个“时尚而有力”的宣传片,结果是“不够好,无法分享”。方向比资产本身更重要。

1. 输入

在一轮 AskUserQuestion 中询问上述请求未涵盖的内容:

输入默认规则
产品 URL 和名称必需用户自己的产品,或有权推广的产品
时长20 秒5 个故事节拍,每个 2 到 4 秒
格式9x16 优先,然后 1x1、16x9同一时间线,重新构图
CTA询问屏幕上精确的文字
一个证明数字询问必须来自用户或其网站;绝不虚构
音乐合成,120 BPM提供的曲目需要此用途的许可证
语音/吉祥物无语音需要 .env 中的 ELEVENLABS_API_KEY
参考外观无可选,通过 /motion-studio:reference-style

2. 项目

每个品牌一个项目文件夹(理想情况下一次会话)。如果没有 studio.json:

node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install

仅技能安装:${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs。然后执行 npm run doctor。

3. 捕获品牌

从项目根目录运行捕获脚本(或简要使用 motion-studio:asset-scout 并带上此确切命令和项目路径):

node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
标志用途
--viewports desktop,mobile默认;tablet 也可用
--full-page长截图以裁剪部分
--selector "<css>"裁剪特定产品部分(可重复):hero、定价卡、仪表板面板
--dismiss-banners在一次性浏览器中点击明显的 cookie 或同意按钮(接受、同意、允许,使用英语、韩语、日语、中文、德语、法语或西班牙语;弱标签如 OK 或 Close 仅在横幅或对话框内有效)。清单中说明点击了哪个按钮,或没有匹配项
--apply-brand将名称、URL 和建议的颜色写入 studio.json
--dark捕获深色主题
--no-fonts跳过字体下载(默认:保存页面加载的网络字体)
--allow-private允许页面访问回环、局域网和链路本地地址(默认:仅目标主机和端口);仅用于您信任的页面,例如用户自己产品的本地开发服务器
--no-sandbox启动 Chrome 时不使用其渲染器沙箱(也支持 MOTION_NO_SANDBOX=1;在 Linux 上以 root 身份运行时自动,因为 Chrome 无法在沙箱中启动);每当关闭时都会打印一条注释
--json输出一行 JSON 结果

它将写入 assets/brand/screens/、assets/brand/logo/、assets/brand/components/、assets/brand/og-image.* 和 assets/manifest.json(包含建议角色的调色板、CSS 颜色变量、使用的字体、标题、按钮和导航文案、注释)。图像扩展名来自文件字节,页面外的组件裁剪将被跳过并附注说明。页面实际加载的网络字体保存到 assets/fonts/,并在 assets/fonts/fonts.json 中注册(已有条目不会被覆盖);每个字体在清单中都有一个 license,除非找到许可 URL 或文件,否则保持为 UNVERIFIED,脚本会在发布前打印提醒检查。运行失败时保留之前的捕获。详细信息和清单架构:references/asset-capture.md。

Logo 和类型。当页头没有 Logo 图像或 SVG 时,品牌通常是文本字标。捕获将其记录为 manifest.brand.wordmark(标记、各部分颜色及其角色、计算字体族、字重、字号和字间距),以及一个参考裁剪 assets/brand/logo/wordmark-crop.png,并在注释中说明,而不是仅要求 Logo 文件。根据该记录重建;仅当影片需要精确锁定时才要求 SVG 或 PNG。

字体。日志行 font registry: <family>: ...(以及 manifest.fonts.registry)说明每个使用的字体族是否已在 assets/fonts/fonts.json 中,以及其许可是否已验证(有记录的许可 ID 和许可文本)或 UNVERIFIED,以及本次运行添加了什么。一个位于同一字体族已验证条目旁边的字体将重用该许可。

UI 状态和画布帧

capture.mjs 在加载时拍摄一次。两个兄弟脚本涵盖其余部分;两者都打印 --help,仅写入项目内部(默认 assets/brand/),并在相同的安全堆栈后面运行(Windows 上的无头 shell、开启渲染器沙箱、拒绝私有地址、编辑机密)。插件安装:下面的命令。仅技能安装(无 ${CLAUDE_PLUGIN_ROOT}):脚本位于此文件旁边,因此运行 node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ...(同样适用于 capture.mjs 和 canvas-frames.mjs);它们只需要 Node 和从运行文件夹解析的 playwright(传递 --root <folder>),无需项目、studio.json 或 tools/。asset-scout 代理运行相同的命令。

node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
脚本用途写入
states.mjs覆盖产品(模态、同意)、在内部窗格中滚动的应用、点击后的状态、元素及其计算样式assets/brand/states/<name>/:00-first、01-escape、scroll-NN、10-click-...、crop-20-... PNG 和 states.json
canvas-frames.mjs一个屏幕是一个 <canvas>,每次点击变化并自行动画assets/brand/frames/<clip>.png 精灵表和 frames.json(帧大小、实际时间和每帧哈希);pack 添加 pack/<clip>.png 和仅包含影片播放帧的 pack.json

canvas-frames.mjs 以整数比例使用 drawImage(关闭平滑)复制画布缓冲区。它从不截取元素截图:以非整数比例在带边框盒子中显示的画布(1280 px 缓冲区在 1272 设备 px 中)会被浏览器重新采样,像素艺术画布会变得模糊。拒绝非缓冲区整数缩小的帧大小。使用前请阅读每个 PNG。

页面是不可信内容,因此捕获保护其运行机器:

  • Chrome 保持渲染器沙箱开启(manifest.sandbox 记录)。以 root 身份运行的容器或 CI 需要 --no-sandbox,并且仅用于您信任的页面。
  • 在 Windows 上,浏览器是 Playwright 的无头 shell(npx playwright install chromium-headless-shell),绝不是单独安装的 Chrome 或 Edge:以全新配置文件启动这些可能会导致 Windows 登录失败并锁定账户。选择一项(studio.json browser、MOTION_BROWSER、MOTION_CHROME_PATH)会在每次启动时打印警告,10 分钟内第 4 次启动将被拒绝,3 次通过(references/asset-capture.md)。
  • 对回环、局域网、链路本地(包括云元数据)和非 Web 地址的请求将被中止,除非指向目标自己的主机和端口。拒绝在 manifest.blocked 和注释中列出。如果 URL 本身被拒绝,运行失败且不保存任何内容。为信任的页面传递 --allow-private。
  • URL 中的凭据(https://user:pass@host/)仅作为 HTTP 认证发送到目标源。它们和看似机密的查询值(token、key、sig、session、code...)不会出现在日志、manifest.json、states.json 或 studio.json brand.url 中(替换为 ***)。
  • 声明推测规则(<script type="speculationrules">)的页面可以使 Chrome 自行获取本地地址,而任何请求过滤器都不会看到;清单会注释。不要在不信任的页面上捕获带有敏感本地服务的机器。

然后,在任何动画之前:

  1. 向用户列出找到的内容:截图、Logo 候选、建议的 bg/fg/accent/muted、字体、标题和 CTA 文案,以及每个注释(机器人检查、缺少 Logo)。
  2. 确认或纠正调色板和字体,然后写入 studio.json brand。捕获的字体已在 assets/fonts/ 中,但仅在验证许可后使用(UNVERIFIED 表示无人检查)。使用 npm run fonts -- add "Family:400,700" 添加 Google 字体;商业字体需要用户自己的许可或文件。韩文或其他 CJK 文案需要包含字形的字体:npm run fonts -- coverage --text "..." --family "Name"。
  3. 询问缺失的内容,而不是虚构:SVG Logo、精确的强调色十六进制、登录墙后的截图。

4. 组件,而非原始截图

  • 将捕获的截图部分裁剪为单独图像(--selector,或自动裁剪:页头、hero、CTA 按钮、卡片、产品图片、定价、部分)。对部分进行动画:卡片滑入布局、按钮按下、图表面板绘制。
  • 使用从裁剪中测量的真实颜色、文案和圆角,在画布中重建简单的 UI 外壳(按钮、开关、字段)。这是重新排版,而非发明:布局、标签和数据必须与产品完全匹配。
  • 绝不绘制不存在的产品屏幕。没有占位符文案、无 lorem ipsum、无虚假数字。如果缺少所需屏幕,请询问。

5. 音乐和节拍网格(在镜头列表之前)

在真实际拍网格上计时所有内容,因此在任何人编写镜头之前测量或合成音乐:

  • 提供的曲目:node tools/beats.mjs audio/<track>,然后将 studio.json audio.music 指向它,并设置 bpm 和 duration。其第一个强拍可能远在 0 秒之后或具有不同于 120 的节奏,镜头列表必须遵循该节奏,绝不假设网格。
  • 无曲目:node tools/score.mjs --style pulse --bpm 120 --dur 20(对于 UI 密集影片使用 minimal)。它写入 audio/music.wav 和分析文件 audio/beats.json。
  • 每个可见的命中点都会得到一个提示;动态跟随音乐,而不是反过来。

6. 故事节拍

用用户的事实填充 assets/brand-prompt.md 中的品牌故事,并交给 motion-studio:motion-director 生成 docs/shotlist.md;导演读取 audio/beats.json,因此第 5 部分优先。默认 20 秒,120 BPM,每 2 到 4 秒一个节拍,场景变化在强拍上:

#节拍画面声音
1钩子,0 到 2 秒最多 5 个字的巨大动态类型问题;第 0 帧已经构图强拍上的重击
2产品出现真实 UI 逐步组装进入时的嗖嗖声,部分上的弹出
3三个功能每个都是 UI 时刻,光标执行真实操作每次按下时的点击声
4证明真实数字就位滴答声或铃声
5锁定Logo + CTA,最后一个强拍上最终命中上升进入命中

显示镜头列表并等待用户确认(先计划),除非他们要求自主模式。如果网格后来更改(其他曲目、其他 bpm 或 duration),重新定时列表并再次显示。

7. 语音和吉祥物

  • 语音(可选):编写 audio/voice.json(参见 assets/voice-script.example.json):每个节拍一行,t 在第 5 部分网格的强拍上,短句。运行 npm run voice -- --dry-run 并告知用户字符数,然后 npm run voice 消耗点数(相同的行被合成一次并计费)。混音器在语音下降低音乐。
  • 吉祥物(可选):用代码绘制的角色,具有固定身份(形状、从品牌抽样的调色板、比例),在节拍上用 playful 弹簧反应。保持相同...

[已截断用于翻译]

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

相关技能