Vincentwei1021/video-shotcraft

# video-shotcraft 🎬 **video-shotcraft** 是一个 AI agent 技能，它可以将 Claude Code 或 Codex 变成一个动态设计工作室：将其指向你的产品，它就会利用 [Remotion](https://www.remotion.dev/) 进行分镜、动画制作和声音设计，生成一部电影级别的宣传、营销、发布或演示视频——包含真实的页面截图、2.5D 摄像机移动、节拍同步剪辑和电影级音效（SFX）。 ## 🎬 案例展示 下方 38 秒的 Gallery 介绍视频本身就是使用该技能制作的——分镜、镜头实现和声音设计均由一个遵循该工具包方法论的 agent 完成： https://github.com/user-attachments/assets/cba2df8a-4b2e-4247-bace-d0b1dea9c2bd ▶️ [在 YouTube 上观看高清版](https://youtu.be/gcVvRM_P3SM) ## 🚀 快速开始 **最直接的方法：把仓库链接发给你的 agent。** 在 Claude Code / Codex 或类似的 agent 中，只需输入： ``` Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft ``` Agent 会克隆该仓库并将其链接到你的技能目录中。或者使用 [skills](https://skills.sh/) CLI / 手动安装： ``` npx skills add Vincentwei1021/video-shotcraft ``` ``` git clone https://github.com/Vincentwei1021/video-shotcraft.git cd video-shotcraft ln -s "$(pwd)" ~/.claude/skills/video-shotcraft # Claude Code # 或 ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex ``` 然后提出如下需求： ``` Use video-shotcraft to create a promo for my desktop product. Use the deck-deal-flyin and row-embed shot cards to present this feature. Design a product close-up inspired by spotlight-hero-card. ``` 如果没有指定镜头卡，该技能会首先介绍内置的视频模板，并询问是否使用它；你也可以在开始前从 [Gallery](https://vincentwei1021.github.io/video-shotcraft/) 中挑选镜头。 ## 📼 视频模板：Ink Press 该技能附带了 **Ink Press** —— 一个经过验证的、完整的宣传模板：36.2 秒，1920×1080，30fps，包含 10 个采用纸-墨-琥珀风格的镜头，具备 2.5D 真实页面摄像机移动、标题卡、转场，以及完全匹配的电影级音效（SFX）处理： https://github.com/user-attachments/assets/4cf5af51-98f3-4af2-8ab2-7267f470513d ▶️ [在 YouTube 上观看高清版](https://youtu.be/iShab28B_ak) 要使用它，只需告诉你的 agent： ``` Use video-shotcraft to make a promo for my product with the Ink Press template. ``` Agent 会替换为你产品的截图、文案和品牌标识，以重现同样的高质量——这是制作出完整影片最快、最可靠的途径。 ## 📦 包含内容 | 内容 | 描述 | | --- | --- | | 106 张镜头配方卡 | 目的、能量、建议时长、参数、实现说明以及已知陷阱 | | 161 个动态预览 | 涵盖 162 种风格；可在在线 Gallery 中搜索和筛选 | | Remotion 实现 | 经过调优的 TSX 演示，包含适用于每张卡片的实际缓动和计时参数 | | 完整的视频模板 | 一个经过验证的 36.2 秒、1920×1080、30fps 的产品宣传片，包含 10 个镜头 | | 组件和资产 | 2.5D 页面摄像机、字幕、闪光转场、数字滚动、音效（SFX）以及捕获脚本 | | 生产方法论 | 捕获、视觉指导、分镜、声音设计、节拍同步以及最终 QA | 该工具包主要针对 Web 和桌面产品的宣传视频，同时各个单独的镜头卡也可用于功能演示、品牌影片、发布视频和其他动态项目中。 ## 🗂 仓库结构 ``` video-shotcraft/ ├── SKILL.md # Agent entry point and core production rules ├── references/ │ ├── pipeline.md # End-to-end production workflow │ ├── shots/ # 106 shot recipe cards │ ├── sequences/ # Reusable full-video structures and sequence patterns │ ├── aesthetic-rules.md # Visual QA criteria │ ├── music-beat-sync.md # BGM analysis and beat-sync methodology │ └── sound-design.md # Sound-design guidance and examples ├── demos/ # Remotion reference implementations for shot cards ├── gallery/ # Static motion-preview Gallery ├── template/ # Runnable complete video template └── assets/ ├── lib/ # Reusable Remotion components ├── scripts/ # Page-asset capture scripts └── audio/ # SFX and attribution details ``` 有关完整的工作流程和实现要求，请参阅 [SKILL.md](SKILL.md)、[生产流水线](references/pipeline.md)以及[视觉 QA 标准](references/aesthetic-rules.md)。 ## 🔊 音频和资产说明 `assets/audio/` 下的音频文件可以根据其各自的许可条款使用。 有关来源和许可详细信息，请参阅 [ATTRIBUTION.md](assets/audio/ATTRIBUTION.md)。 模板中附带的产品截图属于演示资产。在发布前，请将其替换为目标产品的截图，并确认是否需要对任何产品、客户或个人数据进行匿名化处理。 ## ⭐ Star 历史

标签：AI代理技能, Remotion, 动画模板, 电影级运镜, 自动化攻击, 视频制作, 音效设计