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 模板或要求复刻模板片效果,或要用镜头卡做单个动效镜头时使用。
.github/workflows/pr-checks.yml
View on GitHubname: PR checks
# Catches problems BEFORE merge that deploy-pages.yml would only surface after:
# generated artifacts (gallery/source, library.json, library.html, sitemap,
# llms.txt) drifting from the shot cards, and library.json referencing preview
# MP4s that don't exist on the gallery-media release.
on:
pull_request:
branches: [main]
paths:
- 'references/shots/**'
- 'gallery/**'
- 'demos/**'
- 'assets/lib/**'
- 'assets/scripts/**'
- 'template/src/**'
- 'workbench/**'
- 'package.json'
- 'package-lock.json'
- '.github/workflows/pr-checks.yml'
permissions:
contents: read
jobs:
unit-tests:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
cache-dependency-path: package-lock.json
- name: Helpers pure functions unit tests
run: |
npm ci
npm test
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Generated artifacts are in sync with cards
run: |
python3 gallery/sync-from-cards.py
python3 gallery/build-seo.py
# git status --porcelain (not diff --exit-code): a brand-new card's
# regenerated source copy is UNTRACKED, which diff can't see — that's
# exactly the "added a card, forgot to commit the copy" mistake this
# gate exists to catch.
if [ -n "$(git status --porcelain -- gallery)" ]; then
git status --porcelain -- gallery
echo '::error::gallery artifacts drift from cards — run' \
'sync-from-cards.py + build-seo.py and commit the result'
exit 1
fi
- name: Every library.json preview exists on the gallery-media release
env:
GH_TOKEN: ${{ github.token }}
run: |
# 与 deploy-pages 同一套组装(整包 zip + 晚于它的单个 mp4),查的是部署时真正拿到的文件
python3 gallery/assemble-media.py /tmp/gallery-media
python3 - <<'EOF'
import json, os, re, sys
lib = json.load(open('gallery/api/library.json'))
assets = set(os.listdir('/tmp/gallery-media'))
missing, malformed = [], []
# app.js interpolates these URLs into innerHTML without escaping,
# so gate the exact shape here: same-origin relative ./media/ path
# only — no absolute/protocol-relative URLs, no quotes/angle brackets
CANONICAL = re.compile(r'^\./media/[a-z0-9-]+\.(mp4|gif)(\?v=\d+)?$')
for card in lib['cards']:
for style in card['styles']:
media = style.get('media')
url = media.get('url') if isinstance(media, dict) else media
if not url:
continue
if not CANONICAL.match(url):
malformed.append(f"{card['name']}/{style['key']}: {url}")
continue
name = url.split('?')[0].rstrip('/').split('/')[-1]
if name not in assets:
missing.append(f"{card['name']}/{style['key']}: {name}")
if malformed:
print('::error::non-canonical media URLs (must be ./media/<name>.mp4?v=N):')
print(*malformed, sep='\n ')
sys.exit(1)
if missing:
print('::error::previews missing from the gallery-media release:')
print(*missing, sep='\n ')
sys.exit(1)
print(f"all previews present on release "
f"({len(lib['cards'])} cards checked)")
EOF
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
cache-dependency-path: template/package-lock.json
- name: Demo components compile (tsc strict)
run: |
cd template && npm ci
# 4 current demos + 2 legacy snapshots import @remotion/motion-blur, which the template
# deliberately doesn't ship. Install it transiently, pinned to the
# template's remotion version — a bare latest install nests a second
# remotion copy and trips checkMultipleRemotionVersions.
npm i --no-save "@remotion/motion-blur@$(node -p "require('./package.json').dependencies.remotion")"
# demos/ live outside template/, so give tsc a module-resolution
# root at the repo top via a transient symlink
cd .. && ln -s template/node_modules node_modules
find demos -name '*.tsx' | sed 's|^|./|' > /tmp/demo-files.txt
# assets/lib components that only need remotion also get compiled.
# (three-dependent ones — FlatPanel, helpers/camera — are excluded
# because the template doesn't ship three.)
for f in assets/lib/ClipCard.tsx assets/lib/Caption.tsx \
assets/lib/DigitRoll.tsx assets/lib/FlashCut.tsx \
assets/lib/PageCam.tsx assets/lib/VerticalTicker.tsx \
assets/lib/helpers/motion.ts assets/lib/helpers/rand.ts \
assets/lib/helpers/shake.ts; do
echo "./$f" >> /tmp/demo-files.txt
done
echo "checking $(wc -l < /tmp/demo-files.txt | tr -d ' ') tsx files"
./node_modules/.bin/tsc --noEmit --strict --skipLibCheck \
--esModuleInterop --jsx react-jsx --target es2022 \
--module esnext --moduleResolution bundler --lib dom,es2022 \
--resolveJsonModule \
$(cat /tmp/demo-files.txt)
workbench-build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
cache-dependency-path: workbench/package-lock.json
- name: Workbench type-checks and bundles with all demos linked in
run: |
cd workbench
# prepare hook builds the active index and the hidden compatibility index
npm ci
npx tsc -b
npx vite build
- name: Template (incl. workbench manifest) compiles against the workbench toolchain
run: |
# template/ has no node_modules in CI; borrow the workbench's (same remotion / react pins)
ln -s ../workbench/node_modules template/node_modules
cd template && ../workbench/node_modules/.bin/tsc --noEmit -p tsconfig.json
- name: Theme and palette regressions
run: npm --prefix workbench run test:themes
- name: Retired demos remain compatible with saved projects
run: npm --prefix workbench run test:legacy
demo-smoke:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
cache-dependency-path: template/package-lock.json
- name: Render first frame of every runnable demo
run: |
cd template && npm ci
npm i --no-save "@remotion/motion-blur@$(node -p "require('./package.json').dependencies.remotion")"
cd ..
# Generated smoke roots import demos outside template/. Make the
# template dependencies resolvable from those source directories.
ln -s template/node_modules node_modules
python3 assets/scripts/smoke-render-demos.py
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: 197k | 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: 197k | 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: 197k | Updated | Claude CodeCodex | Verified | Install |