Skip to content

datit309/supergraph / plugins/supergraph/skills/video-shotcraft

video-shotcraft

Unverified

Create 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 模板或要求复刻模板片效果,或要用镜头卡做单个动效镜头时使用。

FileKindSize
.claude-plugin/plugin.jsonconfig549 B
.github/ISSUE_TEMPLATE/showcase.ymlconfig3.0 KB
.github/scripts/showcase-publish.pyscript8.0 KB
.github/workflows/deploy-pages.ymlconfig4.7 KB
.github/workflows/pr-checks.ymlconfig7.3 KB
.github/workflows/showcase-publish.ymlconfig2.3 KB
.gitignoreother949 B
LICENSEother11.1 KB
README.mdmarkdown18.5 KB
README_CN.mdmarkdown18.3 KB
README_JA.mdmarkdown21.1 KB
README_RU.mdmarkdown26.4 KB
SKILL.mdskill md20.4 KB
agents/openai.yamlconfig531 B
assets/audio/ATTRIBUTION.mdmarkdown21.9 KB
assets/audio/AUDITION-2026-07-27.mdmarkdown35.6 KB
assets/audio/bgm/bgm-tech-house.mp3binary8.8 MB
assets/audio/bgm/cat-walk.mp3binary3.8 MB
assets/audio/bgm/g-eazy-nba-type.mp3binary3.2 MB
assets/audio/bgm/house-vibez.mp3binary4.3 MB
assets/audio/bgm/tonight-hiphop.mp3binary3.5 MB
assets/audio/sfx/camera/camera-autofocus.mp3binary306.6 KB
assets/audio/sfx/camera/camera-lens-shutter.mp3binary46.0 KB
assets/audio/sfx/camera/camera-shutter-hard.mp3binary17.9 KB
assets/audio/sfx/camera/camera-shutter-vintage.mp3binary29.8 KB
assets/audio/sfx/camera/click-camera.mp3binary14.1 KB
assets/audio/sfx/camera/ui-zoom-in.mp3binary19.2 KB
assets/audio/sfx/camera/ui-zoom-out.mp3binary34.0 KB
assets/audio/sfx/camera/zoom-air-fast.mp3binary41.1 KB
assets/audio/sfx/camera/zoom-futuristic.mp3binary67.8 KB
assets/audio/sfx/camera/zoom-swipe-fast.mp3binary34.8 KB
assets/audio/sfx/counter/clock-knob-spin.mp3binary16.1 KB
assets/audio/sfx/counter/clock-mech-retract.mp3binary44.6 KB
assets/audio/sfx/counter/clock-tick-single.mp3binary20.0 KB
assets/audio/sfx/counter/countdown-bleeps.mp3binary37.1 KB
assets/audio/sfx/crowd/applause-rhythmic-loop.mp3binary162.5 KB
assets/audio/sfx/crowd/clap-single.mp3binary3.5 KB
assets/audio/sfx/crowd/heartbeat-single.mp3binary35.8 KB
assets/audio/sfx/data/break-glitch-digital.mp3binary37.4 KB
assets/audio/sfx/data/data-compute.mp3binary108.5 KB
assets/audio/sfx/data/data-load-os.mp3binary85.7 KB
assets/audio/sfx/data/data-scan.mp3binary69.9 KB
assets/audio/sfx/data/glitch-electric-small.mp3binary35.7 KB
assets/audio/sfx/data/glitch-static-electric.mp3binary51.0 KB
assets/audio/sfx/data/glitch-static.mp3binary47.0 KB
assets/audio/sfx/data/glitch-virtual-quick.mp3binary64.9 KB
assets/audio/sfx/data/power-up-electronic.mp3binary150.0 KB
assets/audio/sfx/data/power-up-static.mp3binary97.5 KB
assets/audio/sfx/data/static-electric-present.mp3binary125.8 KB
assets/audio/sfx/data/sweep-digital.mp3binary37.4 KB
assets/audio/sfx/data/whoosh-electric.mp3binary70.3 KB
assets/audio/sfx/film/cassette-stretch.mp3binary69.8 KB
assets/audio/sfx/film/cassette-working.mp3binary64.4 KB
assets/audio/sfx/film/projector-spin-antique.mp3binary743.9 KB
assets/audio/sfx/film/reel-rewind.mp3binary120.7 KB
assets/audio/sfx/film/tape-rewind-cine.mp3binary132.5 KB
assets/audio/sfx/film/tape-rewind-fast.mp3binary57.6 KB
assets/audio/sfx/film/vinyl-needle-drop.mp3binary12.0 KB
assets/audio/sfx/film/vinyl-scratch-small.mp3binary36.9 KB
assets/audio/sfx/fluid/liquid-bubble.mp3binary35.5 KB
assets/audio/sfx/fluid/sand-swish.mp3binary61.4 KB
assets/audio/sfx/fluid/water-bubble.mp3binary12.6 KB
assets/audio/sfx/fluid/water-drop-cave.mp3binary60.7 KB
assets/audio/sfx/fluid/water-splash.mp3binary51.1 KB
assets/audio/sfx/glass/glass-break-hammer.mp3binary35.7 KB
assets/audio/sfx/glass/glass-debris-sweep.mp3binary78.9 KB
assets/audio/sfx/glass/glass-hit-cine.mp3binary142.1 KB
assets/audio/sfx/glass/glass-plate-slide.mp3binary28.8 KB
assets/audio/sfx/impact/bass-hit-futuristic.mp3binary71.8 KB
assets/audio/sfx/impact/bass-hit-short.mp3binary35.4 KB
assets/audio/sfx/impact/gravel-fall-hit.mp3binary42.8 KB
assets/audio/sfx/impact/hit-blow.mp3binary16.6 KB
assets/audio/sfx/impact/hit-fast-exciting.mp3binary57.1 KB
assets/audio/sfx/impact/hit-weak.mp3binary12.5 KB
assets/audio/sfx/impact/impact-cine-big.mp3binary220.2 KB
assets/audio/sfx/impact/impact-deep-whoosh.mp3binary113.2 KB
assets/audio/sfx/impact/impact-epic-trailer.mp3binary150.8 KB
assets/audio/sfx/impact/impact-movie-epic.mp3binary157.3 KB
assets/audio/sfx/impact/impact-transition.mp3binary150.8 KB
assets/audio/sfx/impact/impact-zoom-quick.mp3binary39.0 KB
assets/audio/sfx/impact/metal-spring-hit.mp3binary61.2 KB
assets/audio/sfx/impact/stomp-apocalyptic.mp3binary89.6 KB
assets/audio/sfx/light/light-aura.mp3binary170.4 KB
assets/audio/sfx/light/light-spell.mp3binary214.1 KB
assets/audio/sfx/light/light-sweep-magic.mp3binary146.5 KB
assets/audio/sfx/light/light-transition-magic.mp3binary155.1 KB
assets/audio/sfx/light/shimmer-sparkle-sweep.mp3binary92.6 KB
assets/audio/sfx/light/sparkle-poof-hit.mp3binary82.0 KB
assets/audio/sfx/light/sparkle-touch.mp3binary71.7 KB
assets/audio/sfx/light/sparkle-wand.mp3binary75.3 KB
assets/audio/sfx/light/sparkle.mp3binary140.4 KB
assets/audio/sfx/light/stardust-swish.mp3binary147.3 KB
assets/audio/sfx/mech/door-open-futuristic.mp3binary34.1 KB
assets/audio/sfx/mech/gear-lock-metallic.mp3binary34.8 KB
assets/audio/sfx/mech/lock-digital.mp3binary33.2 KB
assets/audio/sfx/mech/lock-quick.mp3binary37.0 KB
assets/audio/sfx/mech/machine-activate-short.mp3binary75.8 KB
assets/audio/sfx/mech/mech-robotic-futuristic.mp3binary294.6 KB
assets/audio/sfx/mech/mech-tech-movement.mp3binary72.2 KB
assets/audio/sfx/mech/metal-drop-scifi-small.mp3binary44.6 KB
assets/audio/sfx/paper/paper-book-browse-fast.mp3binary299.1 KB
assets/audio/sfx/paper/paper-crumple-quick.mp3binary41.2 KB
assets/audio/sfx/paper/paper-move-quick.mp3binary30.9 KB
assets/audio/sfx/paper/paper-page-turn-big.mp3binary29.7 KB
assets/audio/sfx/paper/paper-page-turn.mp3binary17.6 KB
assets/audio/sfx/paper/paper-scissors-cut.mp3binary58.9 KB
assets/audio/sfx/paper/paper-slice-quick.mp3binary13.6 KB
assets/audio/sfx/paper/paper-slide.mp3binary36.3 KB
assets/audio/sfx/paper/paper-staple.mp3binary9.8 KB
assets/audio/sfx/paper/paper-wind-blow.mp3binary167.2 KB
assets/audio/sfx/riser/riser-cine.mp3binary141.7 KB
assets/audio/sfx/scifi/hitech-bleep.mp3binary20.4 KB
assets/audio/sfx/scifi/scifi-click.mp3binary19.9 KB
assets/audio/sfx/scifi/scifi-computer-ambience.mp3binary758.5 KB
assets/audio/sfx/scifi/space-intro-futuristic.mp3binary212.4 KB
assets/audio/sfx/scifi/tech-hum-futuristic.mp3binary152.9 KB
assets/audio/sfx/text/chalk-line.mp3binary35.2 KB
assets/audio/sfx/text/keyboard.mp3binary501.8 KB
assets/audio/sfx/text/marker-pen-line.mp3binary38.1 KB
assets/audio/sfx/text/pen-click-twice.mp3binary20.5 KB
assets/audio/sfx/text/pen-write-paper.mp3binary45.1 KB
assets/audio/sfx/text/pencil-write-short.mp3binary24.7 KB
assets/audio/sfx/text/typewriter-digital.mp3binary63.8 KB
assets/audio/sfx/text/typewriter-hit-hard.mp3binary34.0 KB
assets/audio/sfx/text/typewriter-hit-single.mp3binary20.9 KB
assets/audio/sfx/text/typewriter-hit-soft.mp3binary15.0 KB
assets/audio/sfx/text/typewriter-return-bell.mp3binary54.7 KB
assets/audio/sfx/text/write-blackboard.mp3binary434.5 KB
assets/audio/sfx/text/write-fast.mp3binary21.1 KB
assets/audio/sfx/transition/air-whoosh-powerful.mp3binary57.6 KB
assets/audio/sfx/transition/air-woosh-deep.mp3binary90.0 KB
assets/audio/sfx/transition/air-woosh-quick.mp3binary47.4 KB
assets/audio/sfx/transition/air-zoom-vacuum.mp3binary40.1 KB
assets/audio/sfx/transition/sweep-fast-small.mp3binary26.6 KB
assets/audio/sfx/transition/sweep-fast.mp3binary60.4 KB
assets/audio/sfx/transition/sweep-metal-quick.mp3binary50.7 KB
assets/audio/sfx/transition/sweep-scifi-fast.mp3binary27.9 KB
assets/audio/sfx/transition/sweep-short.mp3binary17.6 KB
assets/audio/sfx/transition/swoosh-quick.mp3binary26.6 KB
assets/audio/sfx/transition/swoosh-slow.mp3binary164.2 KB
assets/audio/sfx/transition/transition-snap.mp3binary18.6 KB
assets/audio/sfx/transition/transition-soft.mp3binary40.1 KB
assets/audio/sfx/transition/transition-tech-slide.mp3binary25.6 KB
assets/audio/sfx/transition/transition-tech.mp3binary92.1 KB
assets/audio/sfx/transition/warp-slide.mp3binary48.7 KB
assets/audio/sfx/transition/whoosh-big.mp3binary70.0 KB
assets/audio/sfx/transition/whoosh-fast.mp3binary56.3 KB
assets/audio/sfx/transition/whoosh-swirl.mp3binary77.9 KB
assets/audio/sfx/transition/wind-pass-vibrate.mp3binary179.0 KB
assets/audio/sfx/transition/wind-swoosh-short.mp3binary43.0 KB
assets/audio/sfx/transition/wind-woosh-throw.mp3binary27.8 KB
assets/audio/sfx/transition/wing-flutter.mp3binary130.8 KB
assets/audio/sfx/ui/chime-crystal.mp3binary51.2 KB
assets/audio/sfx/ui/hitech-touch-magnet.mp3binary53.7 KB
assets/audio/sfx/ui/pop-electric.mp3binary36.5 KB
assets/audio/sfx/ui/pop.mp3binary14.9 KB
assets/audio/sfx/ui/switch-click-quick.mp3binary34.6 KB
assets/audio/sfx/ui/switch-light.mp3binary5.9 KB
assets/audio/sfx/ui/switch-tap.mp3binary35.0 KB
assets/audio/sfx/ui/ui-click-tone.mp3binary8.3 KB
assets/audio/sfx/ui/ui-confirm-bleep.mp3binary17.5 KB
assets/audio/sfx/ui/ui-confirm-tone.mp3binary42.6 KB
assets/audio/sfx/ui/ui-message-pop.mp3binary12.8 KB
assets/audio/sfx/ui/ui-notify-tech.mp3binary65.7 KB
assets/audio/sfx/ui/ui-option-select.mp3binary50.1 KB
assets/audio/sfx/ui/ui-popup-dry.mp3binary9.5 KB
assets/audio/sfx/ui/ui-select-click.mp3binary34.8 KB
assets/audio/sfx/ui/ui-select-modern.mp3binary4.6 KB
assets/audio/sfx/ui/ui-success-soft.mp3binary52.5 KB
assets/audio/sfx/ui/ui-tone-quick.mp3binary42.4 KB
assets/brand/BRAND.mdmarkdown1.9 KB
assets/brand/brand-board.svgother5.0 KB
assets/brand/logo-lockup-reverse.svgother562 B
assets/brand/logo-lockup.svgother554 B
assets/brand/logo-mark-mono.svgother381 B
assets/brand/logo-mark-reverse.svgother375 B
assets/brand/logo-mark.svgother362 B
assets/lib/Caption.tsxother1.8 KB
assets/lib/ClipCard.tsxother6.7 KB
assets/lib/DigitRoll.tsxother1.7 KB
assets/lib/FlashCut.tsxother726 B
assets/lib/FlatPanel.tsxother2.1 KB
assets/lib/PageCam.tsxother6.7 KB
assets/lib/VerticalTicker.tsxother4.0 KB
assets/lib/helpers/__tests__/helpers.test.tsscript6.1 KB
assets/lib/helpers/camera.tsxother2.0 KB
assets/lib/helpers/motion.tsscript1.7 KB
assets/lib/helpers/rand.tsscript380 B
assets/lib/helpers/shake.tsscript423 B
assets/readme/cover.webpbinary1.2 MB
assets/readme/examples/camera.webpbinary166.2 KB
assets/readme/examples/data.webpbinary177.7 KB
assets/readme/examples/effects.webpbinary79.8 KB
assets/readme/examples/interaction.webpbinary264.6 KB
assets/readme/examples/opening.webpbinary167.3 KB
assets/readme/examples/outro.webpbinary51.9 KB
assets/readme/examples/rhythm.webpbinary132.2 KB
assets/readme/examples/transition.webpbinary197.5 KB
assets/readme/examples/typography.webpbinary221.4 KB
assets/readme/examples/ui-entrance.webpbinary142.2 KB

README_RU.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" src="./assets/brand/logo-mark.svg" width="96" height="96">
</picture>

# video-shotcraft

[English](README.md) | [中文](README_CN.md) | [日本語](README_JA.md) | **Русский**

[![Галерея](https://img.shields.io/badge/Gallery-live%20previews-d3923c)](https://vincentwei1021.github.io/video-shotcraft/)
[![Витрина](https://img.shields.io/badge/Showcase-community%20videos-7c3aed)](https://vincentwei1021.github.io/video-shotcraft/showcase.html)

[![Звёзды GitHub](https://img.shields.io/github/stars/Vincentwei1021/video-shotcraft)](https://github.com/Vincentwei1021/video-shotcraft/stargazers)
[![Лицензия](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-skill-d97757)](SKILL.md)
[![Codex](https://img.shields.io/badge/Codex-skill-10a37f)](SKILL.md)
[![Звезда AtomGit](https://atomgit.com/VincentWei/video-shotcraft/star/badge.svg)](https://atomgit.com/VincentWei/video-shotcraft)

<a href="https://trendshift.io/repositories/88911?utm_source=repository-badge&amp;utm_medium=badge&amp;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="Шесть планов из галереи, слева направо, сверху вниз: graze-face-tour, logo-shrink-wordmark-lockup, panel-grid-moves, product-card-progressive-assemble, space-camera-moves · exploded-view, spotlight-hero-card">

[**▶ Все 150 планов в галерее**](https://vincentwei1021.github.io/video-shotcraft/) · [**🎬 Смотреть витрину работ**](https://vincentwei1021.github.io/video-shotcraft/showcase.html)

</div>

## Что это умеет

Скажите Claude Code или Codex: «Сделай проморолик для моего продукта». Агент снимет ваши реальные страницы, подберёт планы
из библиотеки отточенных анимационных приёмов, составит раскадровку, создаст анимацию в
[Remotion](https://www.remotion.dev/), смонтирует под музыку, добавит звуковое оформление, проверит каждый кадр и передаст
готовый MP4, который можно редактировать дальше.

Это не генератор видео. Каждый кадр отрисовывается кодом на основе ваших скриншотов и текстов, поэтому результат —
чёткий, в стиле вашего бренда и полностью редактируемый.

**Как это работает**

![Восьмисекундный цикл работы: продукт → съёмка реальных страниц → раскадровка с карточками планов → анимация в Remotion → синхронизация с музыкой и звуковое оформление → рендер и покадровая проверка → MP4, Motion Workbench и черновик JianYing](assets/readme/workflow.gif)

## Что нового

> [!IMPORTANT]
> ### 🎬 2026-10 · Обновление библиотеки планов
> Все 216 демо доработаны и проверены. Лучшие версии теперь составляют
> **124 карточки / 150 планов** — с обновлёнными превью в галерее и фирменным оформлением video-shotcraft.

- **2026-09 · [Motion Workbench](#motion-workbench).** Продолжайте монтаж готового ролика в браузерном редакторе в духе CapCut.
- **2026-08 · [video-talkcraft](https://github.com/Vincentwei1021/video-talkcraft)** — родственный проект для видео с закадровым голосом:
  на входе сценарий и озвучка, каждое движение синхронизировано с речью
  ([78 примеров с озвучкой](https://vincentwei1021.github.io/video-talkcraft/)).
- **2026-08 · Экспорт в JianYing (CapCut CN).** Готовый ролик превращается в редактируемый черновик JianYing: отдельные клипы для каждого плана,
  нативные дорожки субтитров, отдельные дорожки эффектов и музыки. Проверено в JianYing Pro 11.2 для macOS
  ([руководство](references/jianying-export.md)).

## ❤️ Спонсоры

<table>
<tr>
<td align="center" valign="middle" width="25%">
  <a href="https://go.apimart.ai/tw-video-shotcraft"><img src="./assets/readme/sponsors/apimart.png" width="200" alt="Логотип APIMart"></a><br>
  <a href="https://go.apimart.ai/tw-video-shotcraft"><b>APIMart</b></a>
</td>
<td>
  <p>Спасибо APIMart за поддержку проекта! APIMart — доступная API-платформа для генерации изображений и видео с ИИ: GPT-Image-2 от $0.006 за изображение, 160+ изображений за доллар. Один асинхронный API для изображений и видео: отправьте задачу, получите ID и заберите результат опросом или через обратный вызов. Генерируйте десятки тысяч изображений пакетами без тайм-аутов, меняйте модели без изменения кода. Оплата по использованию, без абонентской платы — <a href="https://go.apimart.ai/tw-video-shotcraft">зарегистрируйтесь здесь</a>, чтобы начать.</p>
</td>
</tr>
<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 с единой точкой доступа API и одним API-ключом. Быстрый и надёжный доступ с автоматическим переключением при сбоях и выделенными высокоскоростными маршрутами для Codex и Claude Code.</p>
  <p>Начните с $1 бесплатных средств, скидки на первое пополнение и экономии до 80% на доступных по акции маршрутах. Платите в RMB без наценок за конвертацию валюты и дополнительных комиссий за пополнение.</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) предлагает надёжные и масштабируемые облачные сервисы, включая вычисления, хранение данных и ИИ.</p>
  <p><a href="https://aws.amazon.com/">Узнать об AWS →</a></p>
</td>
</tr>
</table>

## Установка

Разработано и настроено для Claude Code и Codex. Самый простой способ — передать агенту ссылку:

```text
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft
```

Или через CLI [skills](https://skills.sh/):

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

В материковом Китае, если GitHub работает медленно, клонируйте зеркало AtomGit:
`git clone https://atomgit.com/VincentWei/video-shotcraft.git`.

## Использование

Просто опишите ролик. Специальная команда не нужна.

| Что сказать | Что произойдёт |
|---|---|
| `Use video-shotcraft to make a promo for my product.` | Агент представит шаблон Ink Press и спросит, использовать ли его, затем снимет ваши страницы и соберёт ролик |
| `Make a launch film for this repo with the Ink Press template.` | Самый быстрый путь: ваши скриншоты, тексты и логотип в проверенном шаблоне |
| `Use the deck-deal-flyin and row-embed shot cards to present this feature.` | Вы выбираете планы по имени (копируйте имена прямо из галереи) |
| `Design a product close-up inspired by spotlight-hero-card.` | Один план, адаптированный под ваш продукт |

## Библиотека планов

124 карточки с анимационными приёмами в 10 категориях, всего 150 планов. Ищите, фильтруйте и копируйте имена карточек
в [галерее](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>Появление интерфейса</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: смена темы волной проходит по приложению"><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: три вспышки переключают кадрирование"><br><sub>paparazzi-flash: три вспышки, три кадрирования, одно число</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/<category>/<card>.md`, а её реализация на Remotion —
в `demos/<category>/<card>/` (как подключить её к проекту, см. в [demos/README.md](demos/README.md)).

## Motion Workbench

После сдачи ролика навык открывает в браузере редактор в духе CapCut
(`node workbench/scripts/open.mjs <project>`). Ролик разбит на дорожки планов, переходов, субтитров и звуковых эффектов
точно по исходному монтажу. Выберите план, чтобы изменить текст, размеры шрифтов и цвета, перемещайте, обрезайте клипы и плавно меняйте скорость,
добавляйте любой из 150 планов библиотеки и экспортируйте через Remotion. Превью и рендер совпадают покадрово. Языки интерфейса: English / 中文 / Русский.

![Монтажный стол Motion Workbench](workbench/docs/overview.png)

[Руководство по монтажному столу: все панели со скриншотами](workbench/GUIDE.md) (на китайском) ·
[Контракт интеграции](references/workbench.md)

## Что вы получите

| Результат | Подробности |
|---|---|
| Готовый ролик | `MP4`, 1920×1080, 30 fps, h264, с музыкой и звуковым оформлением |
| Проект Remotion | Полный исходный код ролика: каждый план — React-компонент, который можете изменить вы или агент |
| Motion Workbench | Открывается после сдачи: дорожки, панель свойств, изменение тайминга, замена планов, экспорт ([подробнее](#motion-workbench)) |
| Черновик JianYing | По желанию: редактируемый проект JianYing (CapCut CN) с отдельными клипами для каждого плана, субтитрами и аудиодорожками |
| Публикация в соцсетях | По запросу: публикация готового ролика через Upload-Post в TikTok, Instagram, YouTube, LinkedIn, X и других сервисах. Подтвердите подпись и платформы, затем выполните пробный запуск без публикации ([руководство](references/publish-upload-post.md)) |

Также в комплекте: переиспользуемые компоненты Remotion (2.5D-камера для страниц, субтитры, переходы-вспышки, прокрутка цифр), 149 звуковых эффектов и
5 музыкальных треков, скрипты захвата страниц и сам производственный процесс (захват, визуальная концепция, раскадровка,
звуковое оформление, синхронизация с музыкой, финальная проверка качества) в [references/](references/pipeline.md).

## Витрина работ

**Поделитесь своим роликом.** Сделали что-то с video-shotcraft?
[Отправьте работу](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 | Покадровая проверка и финальный контроль качества |
| [uv](https://docs.astral.sh/uv/) | Только для анализа ритма музыки (однократный запуск Python-скрипта) |
| puppeteer | Только для захвата страниц; скрипт захвата устанавливает его по необходимости |

При первом рендере Remotion скачивает собственный Chrome без графического интерфейса. Проверено на macOS; для Linux см. примечания ниже.

<details>
<summary><b>Linux без графического интерфейса / CI</b></summary>

При рендере на Linux без графического интерфейса (проверено: 2 ядра, Node 22) возникают три препятствия:

1. **Ограничение параллелизма.** На машинах с малым числом ядер `remotion still/render` завершается ошибкой «Maximum for --concurrency is 2».
   Передайте `--concurrency=1`.
2. **Удаление старого режима headless.** Новые версии Chrome/Chromium больше не поддерживают старый режим headless, поэтому Remotion
   не запускается с системным Chromium. Используйте исполняемый файл chrome-headless-shell вместо полного Chrome.
3. **Недоступный CDN.** Если remotion.media недоступен (часто бывает в материковом Китае), автоматическая загрузка headless-shell
   завершается ошибкой. Передайте `--browser-executable=<path-to-local chrome-headless-shell>`.

С этими тремя флагами покадровый рендер встроенного шаблона работает.

</details>

<details>
<summary><b>Структура репозитория</b></summary>

```text
video-shotcraft/
├── SKILL.md                 # Agent entry point and core production rules
├── references/
│   ├── pipeline.md          # End-to-end production workflow
│   ├── shots/               # 124 shot recipe cards in 10 functional categories
│   ├── 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
│   ├── jianying-export.md   # JianYing (CapCut CN) project-export guide
│   ├── publish-upload-post.md # Optional social publishing (Upload-Post API)
│   └── workbench.md         # Motion workbench: manifest contract + editability rules
├── demos/                   # Remotion reference implementations (same categories)
├── gallery/                 # Static motion-preview Gallery
├── template/                # Runnable complete video template
├── jianying-export/         # JianYing draft installers (mac tested / win untested)
├── publish/                 # Optional social publisher (stdlib-only Python) + offline tests
├── workbench/               # Post-delivery motion workbench (Vite + Remotion Player)
└── assets/
    ├── lib/                 # Reusable Remotion components
    ├── scripts/             # Page-asset capture scripts
    └── audio/               # Audio assets
        ├── bgm/             # 5 BGM options
        └── sfx/<category>/  # 149 SFX across 16 scene categories
```

Полный процесс описан в [SKILL.md](SKILL.md), [производственном процессе](references/pipeline.md) и
[критериях визуального качества](references/aesthetic-rules.md).

</details>

## Аудио и ресурсы

Звуковые эффекты распределены по 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**. Карточки описывают техники (тайминг, сглаживание, хореографию), реализованные с нуля; видеоматериалы,
графика и фирменные ресурсы из этих роликов не включены. Все товарные знаки принадлежат их владельцам; ни одна из этих
компаний не связана с проектом и не заявляла о его поддержке.

Также спасибо **[Remotion](https://www.remotion.dev/)**, на котором работают все демо и шаблоны проекта;
**[Mixkit](https://mixkit.co/)** — источнику звуковых эффектов и музыки, включённых по его бесплатной лицензии; сообществам разработчиков игровой обратной связи
и анимации, чьи опубликованные принципы легли в основу ряда карточек; и **Claude Code**, с помощью которого
эту библиотеку создавали, дорабатывали и проверяли тем же способом, которому учит навык.

## Подписаться

<p>
  <a href="https://x.com/VincentWei93"><img alt="Подписаться на Vincent в X" 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="Подписаться на Vincent в Douyin" 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="Подписаться на Vincent в Red Note" src="https://img.shields.io/badge/Red_Note-Follow_Me-FF2442?style=for-the-badge&logo=xiaohongshu&logoColor=white"></a>
</p>

## История звёзд

<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="График истории звёзд" 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>
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall