项目介绍
video-shotcraft 是一套把 Claude Code 或 Codex 组织成产品视频制作工作流的 Agent Skill。它不是单一提示词，而是把产品检查、创作模式选择、镜头映射、Remotion 实现、声音设计、节奏卡点和最终质量检查连接起来，并附带可复用的镜头卡、动态样片和完整模板。本页依据 GitHub 公开文件整理，没有把仓库自述写成我们的亲自渲染结果。
核心功能
三种完整宣传片协作模式
Skill 区分直接使用 Ink Press 模板、自主自由创作和共同创作；若用户尚未选模式，会先做最小只读产品检查，再说明依据与取舍。
镜头配方卡与参考实现
references/shots/ 提供 152 张镜头卡，demos/ 提供对应的 Remotion TSX 参考实现，Gallery 汇总 209 条可搜索和筛选的动态样片。
Ink Press 完整模板
template/ 提供一支 36.2 秒、1920×1080、30fps、10 镜头的完整产品宣传片工程，可替换产品截图、文案与品牌信息。
声音设计、节奏卡点与 QA
仓库包含 BGM、149 个 SFX、节奏分析方法、视觉验收准则和最终审查要求，用于把声音、转场和运镜纳入同一制作流程。
剪映工程导出
可把成片按镜头切段，并将字幕、SFX 和 BGM 写入可编辑的剪映草稿；README 明确记录 macOS 剪映 Pro 11.2 已验证，Windows 未验证。
安装与使用
优先使用 README 给出的 Skills CLI 命令安装到 Claude Code 或 Codex；安装后先让宿主识别 Skill，并用非敏感示例项目完成只读产品检查，再决定是否进入渲染。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我安装 video-shotcraft，项目地址：https://github.com/Vincentwei1021/video-shotcraft。先阅读 README_CN.md、SKILL.md、LICENSE、template/package.json 与 assets/audio/ATTRIBUTION.md，确认宿主与许可边界，再执行官方命令 `npx skills add Vincentwei1021/video-shotcraft`。若发现同名 Skill、需要安装 Node/Remotion/浏览器组件、创建链接、覆盖文件、访问项目源码、启动服务或采集页面时，先向我确认。安装后只用非敏感示例项目做最小只读产品检查，确认能说明三种创作模式；未经确认不要渲染、上传或公开发布视频。- 能够运行 npx 的 Node.js 环境
- 支持 Agent Skills 的 Claude Code、Codex 或类似编码 Agent
- 实际渲染时需要安装 template/package.json 中声明的 Remotion 4.0.484、React 19.2.7 等依赖
- 准备不含客户、个人、内部、密钥或实时敏感数据的测试页面或截图
npx skills add Vincentwei1021/video-shotcraft- 1核对宿主、数据与许可边界
确认 Claude Code 或 Codex 能加载 Agent Skills，并准备非敏感测试页面。先阅读仓库 LICENSE、音频 ATTRIBUTION 和 Remotion 独立许可；需要额外权限、下载浏览器、覆盖文件或公开发布时单独确认。
- 2执行官方安装命令
在目标宿主可访问的终端运行： npx skills add Vincentwei1021/video-shotcraft 若已有同名 Skill，先比较来源和版本，不要直接覆盖。
- 3运行最小只读验证
重启或刷新 Agent，要求它使用 video-shotcraft 检查一个非敏感示例前端。确认它能说明 Ink Press、自由创作与共同创作三种模式、推荐依据和素材风险，而不是直接修改项目或开始渲染。
- 4选择模式并准备渲染依赖
用户选定模式后再按相应文档继续；若进入模板渲染，在 template/ 中按锁文件安装依赖，并先用最小静帧或短片验证 Remotion 环境。
- 5使用自有素材完成成片验收
替换仓库演示截图和文案，脱敏页面数据，逐镜头检查画面、节奏、声音和字幕；对外发布前确认产品素材、商标、音频与 Remotion 许可。
重启或刷新 Agent 后，确认它能识别 video-shotcraft，并让它对一个非敏感示例前端执行最小只读产品检查：应能说明 Ink Press、自由创作与共同创作三种模式及各自取舍；本页没有执行实际渲染。
- Windows 手动安装不能直接照抄 README 中的 ln -s 命令，应改用本机支持的链接或复制方式
- 模板渲染会执行 React/Node 代码并安装依赖，使用前审查脚本与锁文件
- 目标产品截图、客户数据、商标和音频许可需要在对外发布前独立复核
- 商业使用前查看 Remotion 与 Mixkit 当前许可，不要只依赖仓库主许可证
使用场景
Web 或桌面产品宣传片
读取产品页面与视觉线索，用真实截图、2.5D 运镜和镜头卡制作发布或营销视频。
单个功能动效镜头
从 Gallery 选择 spotlight-hero-card、before-after-slider-scrub 等镜头卡，并按配方和 TSX demo 适配自己的素材。
Ink Press 模板快速换片
保留模板的 10 镜头结构和节奏，用目标产品截图、文案和品牌设计替换演示内容。
成片后的剪映精修
将已经交付的影片导出为剪映草稿，继续调整镜头速度、字幕、调色和独立音轨。
使用评价
从 README、SKILL.md、模板工程和仓库结构看，video-shotcraft 的价值在于把镜头语言、Remotion 代码、声音设计和验收标准放进同一套 Agent 工作流，而不只是提供提示词。限制主要来自渲染依赖、素材隐私与多层许可；本评价只基于公开材料，没有安装或渲染实际项目。
值得一试的地方
- 152 张镜头卡与 209 条动态样片让镜头选择有具体参考，而不是只靠抽象描述
- Ink Press 提供完整可运行模板，镜头结构、时长、分辨率和依赖都有明确文件
- Skill 同时覆盖产品检查、分镜、实现、声音设计、节奏卡点和最终 QA
- README 对无头渲染、数据脱敏、剪映平台验证和第三方许可均给出明确边界
使用前要知道
- 主要面向 Web 与桌面产品宣传片；其他题材需重新设计素材和叙事
- 本页没有实测安装、浏览器采集、Remotion 渲染或成片质量
- README 只明确剪映 Pro 11.2 for macOS 的导出验证，Windows 导出未验证
- 无头 Linux 渲染可能需要限制并发并自行提供 chrome-headless-shell
- 商业使用时需独立核对 Remotion 与随附音频素材的当前许可
README
video-shotcraft
Overview
video-shotcraft 是一套面向 Claude Code 与 Codex 的产品视频制作 Skill，提供 152 张镜头配方卡、209 条动态样片、Remotion 实现、Ink Press 成片模板与声音设计素材。 AI video skill for Claude Code & Codex — cinematic product videos with Remotion: 152 shot recipe cards, 209 motion previews, a production-ready template
Getting started
- 优先使用 README 给出的 Skills CLI 命令安装到 Claude Code 或 Codex；安装后先让宿主识别 Skill，并用非敏感示例项目完成只读产品检查，再决定是否进入渲染。
- 项目定位：为 Claude Code 与 Codex 提供电影感产品视频的规划、Remotion 实现、声音设计与验收方法。
- 公开内容：152 张镜头配方卡、209 条动态样片、对应 TSX demo、36.2 秒 Ink Press 成片模板，以及 149 个按 16 类整理的 SFX。
- 重启或刷新 Agent 后，确认它能识别 video-shotcraft，并让它对一个非敏感示例前端执行最小只读产品检查：应能说明 Ink Press、自由创作与共同创作三种模式及各自取舍；本页没有执行实际渲染。
Configuration
npx skills add Vincentwei1021/video-shotcraft