datit309/supergraph / plugins/supergraph/skills/video-shotcraft
video-shotcraft
UnverifiedCreate cinematic product videos from shot recipe cards, a validated template, and code/audio assets (Remotion + real page screenshots + 2.5D camera moves + beat-synced cuts + sound design). Use when the user asks to turn a frontend project or webpage into a product video, says "use video-shotcraft to make a video/promo", names the Ink Press template or asks to reproduce its effect, or wants a single shot card's motion. 用镜头配方卡 + 已验收模板 + 代码/音频资产制作电影感产品视频(Remotion + 真实页面截图 + 2.5D 运镜 + 节奏卡点 + 声音设计)。当用户要求"用 video-shotcraft 做视频/宣传片"、把前端项目/网页做成产品视频、点名 Ink Press 模板或要求复刻模板片效果,或要用镜头卡做单个动效镜头时使用。
README_JA.md
View on GitHub<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/brand/logo-mark-reverse.svg">
<source media="(prefers-color-scheme: light)" srcset="./assets/brand/logo-mark.svg">
<img alt="video-shotcraft logo" src="./assets/brand/logo-mark.svg" width="96" height="96">
</picture>
# video-shotcraft
[English](README.md) | [中文](README_CN.md) | **日本語** | [Русский](README_RU.md)
[](https://vincentwei1021.github.io/video-shotcraft/)
[](https://vincentwei1021.github.io/video-shotcraft/showcase.html)
[](https://github.com/Vincentwei1021/video-shotcraft/stargazers)
[](LICENSE)
[](SKILL.md)
[](SKILL.md)
[](https://atomgit.com/VincentWei/video-shotcraft)
<a href="https://trendshift.io/repositories/88911?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-88911" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/88911" alt="Vincentwei1021%2Fvideo-shotcraft | Trendshift" width="250" height="55"/></a>
<img src="./assets/readme/cover.webp" width="100%" alt="Gallery の 6 ショット、左から右・上から下:graze-face-tour、logo-shrink-wordmark-lockup、panel-grid-moves、product-card-progressive-assemble、space-camera-moves · exploded-view、spotlight-hero-card">
[**▶ Gallery で 150 ショットをすべて見る**](https://vincentwei1021.github.io/video-shotcraft/) · [**🎬 Showcase の作品を見る**](https://vincentwei1021.github.io/video-shotcraft/showcase.html)
</div>
## できること
Claude Code や Codex に「プロダクトのプロモーション動画を作って」と頼むだけ。エージェントが実際のページを
キャプチャし、調整済みのモーションレシピからショットを選んで絵コンテを組み、[Remotion](https://www.remotion.dev/)
でアニメーションを作り、音楽のビートに合わせてカットし、サウンドデザインを加え、全フレームを確認して、
そのまま編集を続けられる MP4 を納品します。
動画生成モデルではありません。すべてのフレームはあなた自身のスクリーンショットとコピーからコードで描かれるので、
くっきりとブランドに忠実で、細部まで編集できます。
**仕組み**

## 最新情報
> [!IMPORTANT]
> ### 🎬 2026-10 · ショットライブラリ更新
> 216 本の demo を磨き込み・レビューし、ベストな版を **124 カード / 150 ショット**に整理。
> Gallery のプレビューを再レンダリングし、video-shotcraft のブランド素材に統一しました。
- **2026-09 · [モーションワークベンチ](#モーションワークベンチ)**:納品した映像を CapCut 風のブラウザエディタで編集し続けられます。
- **2026-08 · シリーズ新作 [video-talkcraft](https://github.com/Vincentwei1021/video-talkcraft)**:ナレーション動画版。
原稿とボイスオーバーを渡すと、すべてのモーションが音声にロックされます
([78 本のナレーション用プレビュー](https://vincentwei1021.github.io/video-talkcraft/))。
- **2026-08 · 剪映(CapCut 中国版)書き出し**:完成映像を編集可能な剪映ドラフトに。ショット単位のクリップ、
ネイティブ字幕トラック、独立した SFX/BGM トラック。macOS 版剪映 11.2 で検証済み([ガイド](references/jianying-export.md))。
## ❤️ Sponsors
<table>
<tr>
<td align="center" valign="middle" width="25%">
<a href="https://www.packyapi.ai/register?aff=l9IZ"><img src="./assets/readme/sponsors/packycode.png" width="200" alt="PackyCode ロゴ"></a><br>
<a href="https://www.packyapi.ai/register?aff=l9IZ"><b>PackyCode</b></a>
</td>
<td>
<p>PackyCode は、1 つの API エンドポイントと API キーで主要な AI モデルにアクセスできる、高速で安定した API 中継サービスです。自動フェイルオーバーと、Codex / Claude Code 専用の高速ルートを提供します。</p>
<p>新規ユーザーには $1 分の無料クレジットと初回チャージ割引があり、対象ルートでは最大 80% オフ。人民元でチャージでき、為替レートへの上乗せや追加のチャージ手数料はありません。</p>
<p><a href="https://www.packyapi.ai/register?aff=l9IZ">PackyCode を始める →</a></p>
</td>
</tr>
<tr>
<td align="center" valign="middle" width="25%">
<a href="https://aws.amazon.com/"><img src="./assets/readme/sponsors/aws.svg" width="200" alt="AWS ロゴ"></a><br>
<a href="https://aws.amazon.com/"><b>AWS</b></a>
</td>
<td>
<p>Amazon Web Services(AWS)は、コンピューティング、ストレージ、AI など、信頼性と拡張性を備えたクラウドサービスを提供します。</p>
<p><a href="https://aws.amazon.com/">AWS を見る →</a></p>
</td>
</tr>
</table>
## インストール
Claude Code と Codex 向けに作り、調整しています。いちばん簡単なのは、エージェントにリンクを渡すことです:
```text
このスキルをインストールして:https://github.com/Vincentwei1021/video-shotcraft
```
[skills](https://skills.sh/) CLI でも:
```bash
npx skills add Vincentwei1021/video-shotcraft
```
手動の場合:
```bash
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
```
## 使い方
作りたい映像を説明するだけ。コマンドは不要です。
| 言うこと | 起きること |
|---|---|
| `video-shotcraft でプロダクトのプロモーション動画を作って。` | エージェントがまず Ink Press テンプレートを紹介して使うか確認し、ページをキャプチャして映像を作ります |
| `Ink Press テンプレートでこのリポジトリのローンチ動画を作って。` | 最速ルート:検証済みテンプレートにあなたのスクリーンショット・コピー・ロゴを入れます |
| `deck-deal-flyin と row-embed のショットカードでこの機能を紹介して。` | ショットを名前で指定(名前は Gallery からそのままコピーできます) |
| `spotlight-hero-card を参考に、このページの製品クローズアップを作って。` | 1 ショットをあなたのプロダクト向けにアレンジ |
## ショットライブラリ
レシピカード 124 枚、10 カテゴリ、計 150 ショット。[Gallery](https://vincentwei1021.github.io/video-shotcraft/)
で検索・絞り込み・カード名のコピーができます。
<table>
<tr>
<td align="center" width="50%"><b>オープニングとブランド</b> · 11 本<br><img src="./assets/readme/examples/opening.webp" width="100%" alt="text-as-mask:巨大な文字の向こうにダッシュボードが見える"><br><sub>text-as-mask:タイトルの文字からプロダクトが見える</sub></td>
<td align="center" width="50%"><b>カメラ</b> · 13 本<br><img src="./assets/readme/examples/camera.webp" width="100%" alt="exploded-view:ページが 3D に傾き、パーツが分解する"><br><sub>exploded-view:ページが傾き、分解する</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>トランジション</b> · 19 本<br><img src="./assets/readme/examples/transition.webp" width="100%" alt="card-flock-tumble:カードの群れが転がって大見出しになる"><br><sub>card-flock-tumble:カードの群れが見出しになる</sub></td>
<td align="center" width="50%"><b>タイポグラフィ</b> · 25 本<br><img src="./assets/readme/examples/typography.webp" width="100%" alt="flying-words:機能名が文字のトンネルを飛ぶ"><br><sub>flying-words:文字のトンネルがモットーに収束</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>UI 登場</b> · 22 本<br><img src="./assets/readme/examples/ui-entrance.webp" width="100%" alt="card-stack:レシピカードが扇状に配られる"><br><sub>card-stack:カードの束が扇状に配られて着地</sub></td>
<td align="center" width="50%"><b>インタラクション</b> · 13 本<br><img src="./assets/readme/examples/interaction.webp" width="100%" alt="palette-theme-ripple:テーマ変更が波紋のように UI に広がる"><br><sub>palette-theme-ripple:新テーマが波紋のように広がる</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>データ</b> · 9 本<br><img src="./assets/readme/examples/data.webp" width="100%" alt="axis-rescale-shock:グラフが急上昇し軸が再スケール"><br><sub>axis-rescale-shock:急上昇が軸を突き破る</sub></td>
<td align="center" width="50%"><b>光と強調</b> · 23 本<br><img src="./assets/readme/examples/effects.webp" width="100%" alt="spotlight-sweep:スポットライトがタイトルを照らす"><br><sub>spotlight-sweep:舞台の光がタイトルを見つける</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>リズム</b> · 8 本<br><img src="./assets/readme/examples/rhythm.webp" width="100%" alt="paparazzi-flash:3 回のフラッシュで別の構図に切り替わる"><br><sub>paparazzi-flash:3 回のフラッシュ、3 つの構図、ひとつの数字</sub></td>
<td align="center" width="50%"><b>アウトロ</b> · 7 本<br><img src="./assets/readme/examples/outro.webp" width="100%" alt="input-morph-assemble:入力欄がロゴになる"><br><sub>input-morph-assemble:チャット入力欄がロゴを組み立てる</sub></td>
</tr>
</table>
各カードは `references/shots/<カテゴリ>/<カード名>.md`、Remotion 実装は `demos/<カテゴリ>/<カード名>/` にあります
(プロジェクトへの組み込み方は [demos/README.md](demos/README.md) を参照)。
## モーションワークベンチ
納品後、skill がブラウザで CapCut 風のエディタを開きます(`node workbench/scripts/open.mjs <project>`)。
映像は元の構成どおりにショット / トランジション / 字幕 / SFX のトラックへ分解され、任意のショットを選んで
文言・フォントサイズ・色を編集、クリップの移動・トリム・速度変更、ライブラリの 150 ショットのドラッグ追加、
Remotion での書き出しができます。プレビューとレンダリングはフレーム単位で一致します。

[ワークベンチガイド(各パネルをスクリーンショット付きで)](workbench/GUIDE.md)(中国語)·
[連携コントラクト](references/workbench.md)
## 納品物
| 成果物 | 内容 |
|---|---|
| 完成映像 | `MP4`、1920×1080、30fps、h264、音楽とサウンドデザイン付き |
| Remotion プロジェクト | 映像のソース一式。各ショットは React コンポーネントで、あなたもエージェントも変更できます |
| モーションワークベンチ | 納品後に自動で開く:トラック、インスペクタ、速度変更、ショット差し替え、書き出し([詳細](#モーションワークベンチ)) |
| 剪映ドラフト | 任意:ショット単位のクリップ・字幕・音声トラックを編集できる剪映プロジェクト |
| SNS 投稿 | 任意、依頼があれば:Upload-Post で完成映像を TikTok・Instagram・YouTube・LinkedIn・X などへ投稿。キャプションと投稿先を確認し、dry-run の後に投稿([ガイド](references/publish-upload-post.md)) |
ほかにも、再利用できる Remotion コンポーネント(2.5D ページカメラ、字幕、フラッシュカット、数字ロール)、
SFX 149 種と BGM 5 曲、ページキャプチャスクリプト、そして制作手法そのもの(素材キャプチャ、ビジュアルの方向付け、
絵コンテ、サウンドデザイン、ビート同期、最終 QA)を [references/](references/pipeline.md) に収録しています。
## ショーケース
**作品を投稿**:video-shotcraft で映像を作ったら、Showcase の投稿フォームから
[提出](https://github.com/Vincentwei1021/video-shotcraft/issues/new?template=showcase.yml)してください。審査後、
[Showcase ページ](https://vincentwei1021.github.io/video-shotcraft/showcase.html)に掲載されます。
## 動作環境
| 必要なもの | 用途 |
|---|---|
| Node.js と npm | Remotion のレンダリング、テンプレート、ワークベンチ |
| ffmpeg / ffprobe | フレーム確認と最終 QA |
| [uv](https://docs.astral.sh/uv/) | BGM のビート解析のみ(使い捨ての Python スクリプトを実行) |
| puppeteer | ページキャプチャのみ。キャプチャスクリプトが必要に応じてインストール |
Remotion は初回レンダリング時にヘッドレス Chrome を自動でダウンロードします。macOS で検証済み、Linux は下の注意点を参照してください。
<details>
<summary><b>ヘッドレス Linux / CI の注意点</b></summary>
ディスプレイのない Linux サーバー(検証環境:2 コア、Node 22)でレンダリングすると、3 つの壁にぶつかります:
1. **並列数の上限**:低コアのマシンでは `remotion still/render` が "Maximum for --concurrency is 2" で失敗します。
`--concurrency=1` を指定してください。
2. **旧ヘッドレスモードの廃止**:最近の Chrome/Chromium は旧ヘッドレスモードを削除したため、システムの Chromium を
指定すると起動に失敗します。フル版 Chrome ではなく chrome-headless-shell を使ってください。
3. **CDN に届かない**:remotion.media にアクセスできない環境では、headless-shell の自動ダウンロードが失敗します。
`--browser-executable=<ローカルの chrome-headless-shell のパス>` を指定してください。
この 3 つを指定すれば、同梱テンプレートのレンダリングは動きます。
</details>
<details>
<summary><b>リポジトリ構成</b></summary>
```text
video-shotcraft/
├── SKILL.md # エージェントの入口と制作の基本ルール
├── references/
│ ├── pipeline.md # 制作ワークフロー全体
│ ├── shots/ # 10 カテゴリ 124 枚のショットレシピカード
│ ├── sequences/ # 再利用できる映像全体の構成とシーケンス
│ ├── aesthetic-rules.md # ビジュアル QA の基準
│ ├── music-beat-sync.md # BGM 解析とビート同期の手法
│ ├── sound-design.md # サウンドデザインの指針と事例
│ ├── jianying-export.md # 剪映(CapCut 中国版)書き出しガイド
│ ├── publish-upload-post.md # SNS 投稿(任意、Upload-Post API)
│ └── workbench.md # ワークベンチ:マニフェスト契約と編集可能性のルール
├── demos/ # Remotion 参照実装(同じカテゴリ構成)
├── gallery/ # 静的なモーションプレビュー Gallery
├── template/ # そのまま動く完成映像テンプレート
├── jianying-export/ # 剪映ドラフトのインストーラ(mac 検証済み / win 未検証)
├── publish/ # SNS 投稿スクリプト(Python 標準ライブラリ)+ オフラインテスト
├── workbench/ # 納品後のモーションワークベンチ(Vite + Remotion Player)
└── assets/
├── lib/ # 再利用できる Remotion コンポーネント
├── scripts/ # ページ素材のキャプチャスクリプト
└── audio/ # 音声素材
├── bgm/ # BGM 5 曲
└── sfx/<category>/ # 16 シーンカテゴリ、149 種の SFX
```
ワークフロー全体は [SKILL.md](SKILL.md)、[制作パイプライン](references/pipeline.md)、
[ビジュアル QA 基準](references/aesthetic-rules.md) を参照してください。
</details>
## 音声と素材
SFX はシーン / 素材ごとに 16 カテゴリ(`transition` `impact` `riser` `camera` `ui` `text` `paper` `film` `light`
`data` `scifi` `mech` `glass` `fluid` `crowd` `counter`)に分かれています。まずカテゴリを決めてから音色を選んでください。
索引とファイルごとの用途は [sound-design.md](references/sound-design.md)、出典とライセンスは
[ATTRIBUTION.md](assets/audio/ATTRIBUTION.md) にあります。
テンプレートに同梱のプロダクトスクリーンショットはデモ用素材です。公開前に対象プロダクトのスクリーンショットに
差し替え、プロダクト・顧客・個人のデータを匿名化する必要がないか確認してください。
## ライセンス
- コードとドキュメント:[Apache-2.0](LICENSE)。
- `assets/audio/` の音声:各ファイルのライセンスに従います。[ATTRIBUTION.md](assets/audio/ATTRIBUTION.md) を参照。
- [Remotion](https://www.remotion.dev/) には独自の[ライセンス](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md)があります:
個人と小規模チームは無料、企業は有料ライセンスが必要な場合があります。
## 謝辞
ライブラリの多くのレシピは、優れた公式プロダクト映像のモーション言語を研究して抽出しました。**ClickUp、Perplexity、
Slack、Notion、Figma、Framer、Bear、Raycast、Pitch、Miro、Superhuman、Loom** などのプロモーション映像です。
カードに記録しているのはゼロから再実装した技法(タイミング、イージング、振り付け)で、これらの映像の素材・
アートワーク・ブランド資産はリポジトリに含まれていません。商標はそれぞれの所有者に帰属し、これらの企業は
本プロジェクトと提携・推薦の関係にありません。
また、すべての demo とテンプレートを支える **[Remotion](https://www.remotion.dev/)**、同梱の SFX と音楽の提供元
**[Mixkit](https://mixkit.co/)**(無料ライセンス)、いくつものカードに影響を与えたゲームフィールとアニメーションの
コミュニティ、そしてこの skill が教えるのと同じワークフローでライブラリの構築・改善・QA を行った
**Claude Code** に感謝します。
## フォロー
<p>
<a href="https://x.com/VincentWei93"><img alt="X で Vincent をフォロー" src="https://img.shields.io/badge/X-Follow_Me-000000?style=for-the-badge&logo=x&logoColor=white"></a>
<a href="https://www.douyin.com/user/MS4wLjABAAAAK1pkjBxilk2Oi_9h_vFyD-lTAu9CTlvhmOtkosDvvxg"><img alt="Douyin で Vincent をフォロー" src="https://img.shields.io/badge/Douyin-Follow_Me-000000?style=for-the-badge&logo=tiktok&logoColor=white"></a>
<a href="https://xhslink.cn/m/At9iP2d5C1V"><img alt="RED で Vincent をフォロー" src="https://img.shields.io/badge/Red_Note-Follow_Me-FF2442?style=for-the-badge&logo=xiaohongshu&logoColor=white"></a>
</p>
## Star の推移
<a href="https://www.star-history.com/?repos=Vincentwei1021%2Fvideo-shotcraft&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft&type=date&theme=dark&legend=top-left&sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft&type=date&legend=top-left&sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft&type=date&legend=top-left&sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR" />
</picture>
</a>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |