{"id":52095546,"url":"https://github.com/Vincentwei1021/video-shotcraft","last_synced_at":"2026-08-04T19:00:38.921Z","repository":{"id":373369617,"uuid":"1305663861","full_name":"Vincentwei1021/video-shotcraft","owner":"Vincentwei1021","description":"AI video skill for Claude Code \u0026 Codex — cinematic product videos with Remotion: 106 shot recipe cards, 161 motion previews, a production-ready template","archived":false,"fork":false,"pushed_at":"2026-07-28T07:18:42.000Z","size":185695,"stargazers_count":2941,"open_issues_count":2,"forks_count":255,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-07-31T11:11:20.185Z","etag":null,"topics":["agent-skills","ai-agents","ai-video","claude-code","claude-code-skills","claude-skills","codex","motion-design","motion-graphics","product-video","promo-video","remotion","video-generation","video-production"],"latest_commit_sha":null,"homepage":"https://vincentwei1021.github.io/video-shotcraft/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vincentwei1021.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2026-07-19T11:44:41.000Z","updated_at":"2026-07-31T11:10:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Vincentwei1021/video-shotcraft","commit_stats":null,"previous_names":["vincentwei1021/video-shotcraft"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Vincentwei1021/video-shotcraft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vincentwei1021%2Fvideo-shotcraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vincentwei1021%2Fvideo-shotcraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vincentwei1021%2Fvideo-shotcraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vincentwei1021%2Fvideo-shotcraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vincentwei1021","download_url":"https://codeload.github.com/Vincentwei1021/video-shotcraft/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vincentwei1021%2Fvideo-shotcraft/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36286158,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-08-04T02:00:06.901Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","ai-video","claude-code","claude-code-skills","claude-skills","codex","motion-design","motion-graphics","product-video","promo-video","remotion","video-generation","video-production"],"created_at":"2026-08-04T12:00:17.071Z","updated_at":"2026-08-04T19:00:38.915Z","avatar_url":"https://github.com/Vincentwei1021.png","language":"TypeScript","funding_links":[],"categories":["⭐ 精选第三方技能","🧠 Agent Skills","Source Catalog","Diagram and Visual Skills"],"sub_categories":["🎨 内容创作"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./assets/brand/logo-mark-reverse.svg\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./assets/brand/logo-mark.svg\"\u003e\n  \u003cimg alt=\"video-shotcraft logo\" src=\"./assets/brand/logo-mark.svg\" width=\"112\" height=\"112\"\u003e\n\u003c/picture\u003e\n\n\u003ch1\u003evideo-shotcraft\u003c/h1\u003e\n\n[![GitHub stars](https://img.shields.io/github/stars/Vincentwei1021/video-shotcraft)](https://github.com/Vincentwei1021/video-shotcraft/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/Vincentwei1021/video-shotcraft)](https://github.com/Vincentwei1021/video-shotcraft/network/members)\n[![Gallery](https://img.shields.io/badge/Gallery-live%20previews-d3923c)](https://vincentwei1021.github.io/video-shotcraft/)\n[![AtomGit Star](https://atomgit.com/VincentWei/video-shotcraft/star/badge.svg)](https://atomgit.com/VincentWei/video-shotcraft)\n\n\u003ca href=\"https://trendshift.io/repositories/88911?utm_source=trendshift-badge\u0026utm_medium=badge\u0026utm_campaign=badge-trendshift-88911\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/trendshift/repositories/88911/daily?language=TypeScript\" alt=\"Vincentwei1021%2Fvideo-shotcraft | Trendshift\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://trendshift.io/repositories/88911?utm_source=trendshift-badge\u0026utm_medium=badge\u0026utm_campaign=badge-trendshift-88911\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/trendshift/repositories/88911/weekly?language=TypeScript\" alt=\"Vincentwei1021%2Fvideo-shotcraft | Trendshift\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n\n**An agent skill for crafting cinematic product videos: 104 shot recipe cards · 161 styles · 161 motion previews · a production-ready template**\n\n[English](README.md) | [中文](README_CN.md) | [日本語](README_JA.md)\n\n\u003c/div\u003e\n\n**video-shotcraft** is an AI agent skill that turns Claude Code or Codex into a\nmotion-design studio: point it at your product and it storyboards, animates, and\nsound-designs a cinematic promo, marketing, launch, or demo video with\n[Remotion](https://www.remotion.dev/) — real page captures, 2.5D camera moves,\nbeat-synced cuts, and film-grade SFX included.\n\n🖼️ [**Browse all 161 motion previews in the live Gallery »**](https://vincentwei1021.github.io/video-shotcraft/)\n\n## 🎬 Showcase\n\nThe 38-second Gallery intro below was itself produced with this skill —\nstoryboard, shot implementation, and sound design were all done by an agent\nfollowing the toolkit's methodology:\n\nhttps://github.com/user-attachments/assets/cba2df8a-4b2e-4247-bace-d0b1dea9c2bd\n\n▶️ [Watch in HD on YouTube](https://youtu.be/gcVvRM_P3SM)\n\n\u003e Browse every shot card and motion preview online: **[Gallery](https://vincentwei1021.github.io/video-shotcraft/)**\n\u003e — search, filter, switch between variants, and copy selected shot-card names.\n\n## 🚀 Quick start\n\n**The most direct way: hand the repo link to your agent.**\nIn Claude Code / Codex or a similar agent, just say:\n\n```text\nInstall this skill for me: https://github.com/Vincentwei1021/video-shotcraft\n```\n\nThe agent will clone the repo and link it into your skills directory. Or install\nwith the [skills](https://skills.sh/) CLI / manually:\n\n```bash\nnpx skills add Vincentwei1021/video-shotcraft\n```\n\n```bash\ngit clone https://github.com/Vincentwei1021/video-shotcraft.git\ncd video-shotcraft\nln -s \"$(pwd)\" ~/.claude/skills/video-shotcraft   # Claude Code\n# or\nln -s \"$(pwd)\" ~/.codex/skills/video-shotcraft    # Codex\n```\n\nThen make requests like:\n\n```text\nUse video-shotcraft to create a promo for my desktop product.\nUse the deck-deal-flyin and row-embed shot cards to present this feature.\nDesign a product close-up inspired by spotlight-hero-card.\n```\n\nIf no shot card is specified, the skill introduces the built-in video template\nfirst and asks whether to use it; you can also pick shots in the\n[Gallery](https://vincentwei1021.github.io/video-shotcraft/) before starting.\n\n## 📼 Video template: Ink Press\n\nThe skill ships with **Ink Press** — a validated, complete promo template:\n36.2 seconds, 1920×1080, 30fps, 10 shots in a paper-ink-amber style, with 2.5D\nreal-page camera moves, title cards, transitions, and a fully pinned cinematic\nSFX pass:\n\nhttps://github.com/user-attachments/assets/4cf5af51-98f3-4af2-8ab2-7267f470513d\n\n▶️ [Watch in HD on YouTube](https://youtu.be/iShab28B_ak)\n\nTo use it, just tell your agent:\n\n```text\nUse video-shotcraft to make a promo for my product with the Ink Press template.\n```\n\nThe agent swaps in your product's screenshots, copy, and branding to reproduce\nthe same quality — the fastest, most reliable path to a finished film.\n\n\u003e More templates are on the way.\n\n### Headless / CI notes\n\nRendering on a headless Linux box (tested: 2 cores, Node 22) hits three walls\nworth knowing:\n\n1. **Concurrency cap** — `remotion still/render` fails with \"Maximum for\n   --concurrency is 2\" on low-core machines. Fix: pass `--concurrency=1`.\n2. **Old Headless removal** — recent Chrome/Chromium dropped old headless mode;\n   pointing Remotion at system chromium fails to launch. Fix: use a\n   chrome-headless-shell binary instead of full Chrome.\n3. **Blocked CDN** — if remotion.media is unreachable, the automatic\n   headless-shell download is rejected. Fix:\n   `--browser-executable=\u003cpath-to-local chrome-headless-shell\u003e`.\n\nWith these three flags, frame renders from the bundled template work.\n\n## 📦 What's included\n\n| Content | Description |\n| --- | --- |\n| 104 shot recipe cards | Purpose, energy, suggested duration, parameters, implementation notes, and known pitfalls |\n| 161 motion previews | Covering 161 styles; searchable and filterable in the online Gallery |\n| Remotion implementations | Tuned TSX demos containing the actual easing and timing parameters for each card |\n| Complete video template | A validated 36.2-second, 1920×1080, 30fps product promo with 10 shots |\n| Components and assets | 2.5D page camera, captions, flash cuts, digit rolls, SFX, and capture scripts |\n| Production methodology | Capture, visual direction, storyboarding, sound design, beat sync, and final QA |\n\nThe toolkit primarily targets web and desktop product promos, while individual\nshot cards can also be used in feature demos, brand films, launch videos, and\nother motion projects.\n\n## 🗂 Repository structure\n\n```text\nvideo-shotcraft/\n├── SKILL.md                 # Agent entry point and core production rules\n├── references/\n│   ├── pipeline.md          # End-to-end production workflow\n│   ├── shots/               # 104 shot recipe cards in 10 functional categories\n│   ├── sequences/           # Reusable full-video structures and sequence patterns\n│   ├── aesthetic-rules.md   # Visual QA criteria\n│   ├── music-beat-sync.md   # BGM analysis and beat-sync methodology\n│   └── sound-design.md      # Sound-design guidance and examples\n├── demos/                   # Remotion reference implementations (same categories)\n├── gallery/                 # Static motion-preview Gallery\n├── template/                # Runnable complete video template\n└── assets/\n    ├── lib/                 # Reusable Remotion components\n    ├── scripts/             # Page-asset capture scripts\n    └── audio/               # Audio assets\n        ├── bgm/             # 5 BGM options\n        └── sfx/\u003ccategory\u003e/  # 149 SFX across 16 scene categories\n```\n\nFor the complete workflow and implementation requirements, see [SKILL.md](SKILL.md),\nthe [production pipeline](references/pipeline.md), and the\n[visual QA criteria](references/aesthetic-rules.md).\n\n## 🔊 Audio and asset notes\n\nAudio files under `assets/audio/` may be used according to their respective license terms.\nSee [ATTRIBUTION.md](assets/audio/ATTRIBUTION.md) for sources and license details.\n\nSFX are organized into 16 scene/material categories (`transition` `impact` `riser`\n`camera` `ui` `text` `paper` `film` `light` `data` `scifi` `mech` `glass` `fluid`\n`crowd` `counter`) — **pick the category first, then the timbre**. See\n[sound-design.md](references/sound-design.md) for the category index and per-file usage.\n\nProduct screenshots bundled with the template are demonstration assets. Replace them with\nscreenshots from the target product before publishing, and verify whether any product,\ncustomer, or personal data needs to be anonymized.\n\n## 📝 Changelog\n\n| Date | Update |\n|---|---|\n| 2026-07-27 | Restructured the audio library into `bgm/` + `sfx/\u003ccategory\u003e/`, with SFX grouped into 16 scene/material categories; expanded the library to 149 SFX (added previously missing texture layers: paper/print, typewriter, handwriting, film projector, counters/gauges, ink/fluid, glass) ; deduplicated the library by md5 and recovered original license URLs for 7 files |\n| 2026-07-27 | Gallery cards support multi-category tags; flat, alphabetically sorted All view; recovered GridWaveFlip and WireframeDrawOn sources |\n| 2026-07-26 | Gallery auto-deploys to GitHub Pages; preview mp4s moved out of git to a release, slimming the repo |\n\n## 🙏 Acknowledgements\n\nMany shot recipes in this library were distilled by studying the motion language\nof outstanding official product films — including promos from **ClickUp,\nPerplexity, Slack, Notion, Figma, Framer, Bear, Raycast, Pitch, Miro, Superhuman,\nand Loom**. The cards document motion techniques (timing, easing, choreography)\nre-implemented from scratch; no footage, artwork, or brand assets from these\nfilms are included in this repository. All trademarks belong to their respective\nowners, and none of these companies are affiliated with or endorse this project.\n\nSpecial thanks to:\n\n- **[Remotion](https://www.remotion.dev/)** — the React-based video framework\n  that powers every demo and template here. Note that Remotion has its own\n  [license](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md)\n  (free for individuals and small teams; companies may need a paid license).\n- **[Mixkit](https://mixkit.co/)** — source of the SFX and music assets bundled\n  under their free commercial license.\n- The game-feel and animation communities whose published principles (e.g.\n  Vlambeer's screenshake talks, classic animation timing) inform several cards.\n- **Claude Code** — this library itself was built, iterated, and QA'd with an\n  AI coding agent, using the same workflow the skill teaches.\n\n## ⭐ Star history\n\n\u003ca href=\"https://www.star-history.com/?repos=Vincentwei1021%2Fvideo-shotcraft\u0026type=date\u0026legend=top-left\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft\u0026type=date\u0026theme=dark\u0026legend=top-left\u0026sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR\" /\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft\u0026type=date\u0026legend=top-left\u0026sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR\" /\u003e\n    \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft\u0026type=date\u0026legend=top-left\u0026sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR\" /\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVincentwei1021%2Fvideo-shotcraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVincentwei1021%2Fvideo-shotcraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVincentwei1021%2Fvideo-shotcraft/lists"}