🧭 Decision Guide
Why trending now: Cannot be determined from the provided materials.
Try it if you
-
You use Claude Code or Codex and want to turn product page screenshots and copy into an MP4 promo.The README's “What it does” and “Use” sections say the agent captures pages, selects shots, and builds the film.
-
You want to choose UI, data, or transition effects from 124 recipe cards and 150 shots.The README's “Shot library” section lists 124 recipe cards, 150 shots, and 10 categories.
-
You need to edit shots, captions, speed, or colors after delivery instead of receiving only a non-editable video.The README's “Motion Workbench” and “What you get” sections describe editable tracks, shot properties, and Remotion source.
-
You use macOS with JianYing Pro 11.2 and need per-shot clips, captions, and audio tracks.The README's “What's new” section says JianYing export was verified on JianYing Pro 11.2 for macOS.
Skip it if you
-
You need a general video generator rather than a Remotion project that draws every frame from code, screenshots, and copy.The README's “What it does” section explicitly says, “It is not a video generator.”
-
You must rely on the Windows JianYing export installer for delivery.The README's repository structure marks jianying-export as “mac tested / win untested.”
-
Your Linux rendering environment cannot provide chrome-headless-shell or cannot handle remotion.media download restrictions.The README's “Headless Linux / CI notes” says system Chromium fails and automatic downloads fail when the CDN is unreachable.
Requirements
- Node.js and npm: for Remotion rendering, the template, and Motion Workbench.
- ffmpeg / ffprobe: for frame checks and final QA.
- uv: only for BGM beat analysis using a one-off Python script.
- puppeteer: only for page capture; the capture script installs it on demand.
- Remotion downloads its own headless Chrome on the first render.
- Low-core Linux environments need --concurrency=1 and chrome-headless-shell; when the CDN is unreachable, pass --browser-executable=.
First step (verbatim from README)
npx skills add Vincentwei1021/video-shotcraft
Watch out
-
When remotion.media is blocked in mainland China, automatic headless-shell download can fail.The README's “Headless Linux / CI notes” lists the blocked CDN issue and requires --browser-executable=.
-
On low-core Linux machines, default concurrency can trigger the remotion still/render error that the maximum concurrency is 2.The README's “Headless Linux / CI notes” records “Maximum for --concurrency is 2.”
-
Motion Workbench requires editing output, preview, and rendering to remain frame-identical.The README's “Motion Workbench” section says, “Preview and render are frame-identical.”
-
Page capture depends on puppeteer, while BGM beat analysis depends on uv and a one-off Python script.The README's “Requirements” table states the purposes of puppeteer and uv.
Not stated in the README
- The README does not state installed disk usage or first-render time for Remotion.
- The README does not state minimum Claude Code or Codex versions.
- The README does not provide average generation time or resource usage per promo.
- The README does not state whether the 124 recipe cards cover specific languages, industries, or brand guidelines.
- The README does not state import compatibility for JianYing versions other than Pro 11.2.
- The README does not provide automated test coverage or production failure rates.
💡 Deep Analysis
6
Yes
I use JianYing Pro 11.2 on macOS and need to keep editing individual shots, native captions, SFX, and BGM rather than receiving only an MP4. Does this project's JianYing export fit my workflow?
Yes, because your macOS and JianYing Pro 11.2 setup matches the environment explicitly verified by the README, and the export preserves separate editing structures.
- The “What’s new” section says JianYing (CapCut CN) export turns the final film into an editable draft rather than flattening it into one file.
- The exported project contains per-shot video clips, native caption tracks, and separate SFX and BGM tracks, matching the editing boundaries you described.
- The repository structure includes a
jianying-export/installer directory and areferences/jianying-export.mdguide, indicating a dedicated delivery path. - The README explicitly says it was verified on JianYing Pro 11.2 for macOS. Windows is still marked untested, so your platform is within the documented compatibility boundary.
It is well suited to shot-level and audio-track-level finishing, but it should not be treated as a replacement for every advanced compositing feature in JianYing.
- What’s new: JianYing (CapCut CN) export; per-shot clips, native caption tracks, separate SFX/BGM tracks
- What’s new: Verified on JianYing Pro 11.2 for macOS
- Repository structure: `jianying-export/`; `references/jianying-export.md`
npx skills add Vincentwei1021/video-shotcraft
It depends
I need to render Remotion videos on a 2-core, Node 22 headless Linux CI machine, and remotion.media may be unreachable. Can video-shotcraft run without changing the project architecture?
It depends: the README documents a viable path for this environment, but you must provide a compatible Chrome headless-shell and explicitly constrain rendering.
- The “Headless Linux / CI notes” were tested on 2 cores with Node 22, which directly matches your stated machine profile.
- On low-core machines,
remotion still/rendercan hit the concurrency limit; the README instructs users to pass--concurrency=1. - Recent Chrome and Chromium releases removed the old headless mode. The notes say not to point Remotion at system Chromium, but to use a chrome-headless-shell binary instead.
- If remotion.media is unreachable, automatic headless-shell download fails. The documented workaround is to pass
--browser-executable=and point to a local browser. The project also requires ffmpeg/ffprobe for frame checks and final QA.
The architecture does not need to be replaced, but the CI image, executable path, and concurrency settings cannot remain at their defaults.
- Headless Linux / CI notes: tested: 2 cores, Node 22
- Headless Linux / CI notes: Pass `--concurrency=1`
- Headless Linux / CI notes: Use a chrome-headless-shell binary instead of full Chrome
- Headless Linux / CI notes: Pass `--browser-executable=`
Yes
I only have product pages, screenshots, a logo, and a few selling points. I want to use Claude Code or Codex and natural language to create an editable product promo instead of learning a full video-editing workflow. Is video-shotcraft suitable for me?
Yes, because the project is explicitly designed to let Claude Code or Codex orchestrate a product promo from a natural-language request, while delivering more than a final MP4.
- The “What it does” section says you can tell the agent “make a promo for my product.” It captures real pages, selects shots, storyboards the film, adds beat-synced sound, and checks every frame.
- The “Use” section presents the Ink Press template as the fastest path: insert your screenshots, copy, and logo into a validated template. You can also copy shot names from the Gallery.
- Frames are drawn from your own screenshots and copy, rather than being randomly generated, and the Remotion source remains editable.
- Installation can be handled through the skills CLI, although the local setup still requires Node.js, npm, Remotion, and Chrome-related rendering dependencies.
It reduces production complexity, but it does not remove the need to prepare usable assets or decide what the product story should emphasize.
- What it does: Tell Claude Code or Codex "make a promo for my product"
- Use: The fastest path: your screenshots, copy and logo dropped into a validated template
- What it does: Every frame is drawn by code from your own screenshots and copy
- Requirements: Node.js and npm; Remotion downloads its own headless Chrome on first render
npx skills add Vincentwei1021/video-shotcraft
Yes
We must deliver a 1920×1080, 30fps H.264 product-launch video. Marketing also needs browser-based edits to copy, colors, positions, duration, and speed, while developers retain the Remotion source. Does this project match those delivery constraints?
Yes, because the project covers the requested MP4 specification, browser-based post-editing, and delivery of the Remotion source project.
- The project insights specify 1920×1080, 30fps, H.264 MP4 output together with the complete Remotion project source, matching your delivery format.
- The “What’s new” section introduces Motion Workbench as a CapCut-style browser editor. The project insights state that it can edit copy, fonts, colors, positions, duration, and speed, replace shots, and export again.
- The “What it does” section says the finished MP4 can remain editable, while the repository structure identifies the Workbench as a Vite plus Remotion Player application.
- Code-based rendering is described as keeping preview and final render frame-consistent, which helps marketing and engineering work from the same structure.
The boundary is that the README does not present Workbench as a complete professional NLE. Complex masking, 3D compositing, and arbitrary timeline operations may still require Remotion or another editor.
- Project insights / key_features: Output includes 1920×1080, 30fps, H.264 MP4 and the complete Remotion project source
- Project insights / key_features: Motion Workbench can edit copy, fonts, colors, positions, duration, and speed
- What’s new: Motion Workbench; Keep editing the delivered film in a CapCut-style browser editor
- Project insights / architectural_strengths: Preview and rendering both use Remotion and remain frame-consistent
npx skills add Vincentwei1021/video-shotcraft
Yes
I already use React, TypeScript, and Remotion. I want to start from the 124 shot recipe cards and existing components, then extend shots myself when needed. Can this repository serve as a reusable code base for video production?
Yes, particularly as a reusable Remotion asset and template base rather than as a one-off video generator.
- The “Shot library” contains 124 recipe cards and 150 shots across 10 categories, including Opening, Camera, Transitions, Typography, UI Entrance, Data, Rhythm, and Outro. This gives you a searchable vocabulary for composing sequences.
- Each card lives under
references/shots/and has a Remotion implementation underdemos/; the README explicitly describes how to wire one into your own project. - The repository structure includes reusable Remotion components in
assets/lib/, a runnable complete template intemplate/, and a Vite plus Remotion Player workbench for post-delivery editing. - The project is primarily TypeScript, and the README states that every frame is drawn by code, which fits versioned, reproducible, extensible video logic.
The trade-off is that the library imposes a visual vocabulary. A concept outside the recipe-card style will still require a new Remotion implementation.
- Shot library: 124 recipe cards in 10 categories, 150 shots in total
- Shot library: Each card lives in `references/shots/`, with its Remotion implementation in `demos/`
- Repository structure: `assets/lib/`, `template/`, and `workbench/`
- Project data: `main_language` is TypeScript
It depends
I manage a SaaS product that requires login, permission controls, and substantial interaction. The promo must show the real UI because I do not want AI-generated fake screens. Can video-shotcraft capture these pages reliably?
It depends: the project is designed around real webpages and screenshots, but the README-related guidance explicitly warns that Puppeteer capture may be unstable for authenticated, permission-protected, highly interactive, or highly dynamic pages.
- “What it does” says the agent captures your real pages and builds the film from screenshots and copy, which matches your requirement to avoid fabricated UI.
- The “Requirements” section identifies Puppeteer as the dependency for page capture and says the capture script installs it on demand.
- The project insights list pages requiring login, protected permissions, strong interaction, or highly dynamic rendering as a common pitfall because they may not capture reliably.
- Even a successful capture must produce a page state suitable for recording; the project is optimized for software-product interface promos, not arbitrary web-session automation.
Real UI is therefore the intended input, but your authentication flow, dynamic state, and reproducible capture method remain decisive engineering constraints.
- What it does: The agent captures your real pages
- Requirements: puppeteer; Only for page capture
- Project insights / common_pitfalls: Pages requiring login, protected permissions, strong interaction, or highly dynamic rendering may not capture reliably
- Project insights / usage_limitations: The project is mainly optimized for software-product promos and digital-interface presentation
npx skills add Vincentwei1021/video-shotcraft
✨ Highlights
-
124 recipe cards cover 150 Remotion shots
-
Motion Workbench enables browser editing and export
-
JianYing Pro 11.2 can receive editable drafts
-
Outputs 1920×1080, 30fps MP4 films
🔧 Engineering
-
Claude Code or Codex uses page screenshots and copy to generate promos with Remotion
-
Motion Workbench edits shot, caption, and SFX tracks before Remotion export
-
Optional JianYing export includes per-shot clips, captions, and audio tracks
⚠️ Risks
-
Low-core Linux machines must handle Remotion's concurrency cap with --concurrency=1
-
System Chromium may fail to launch because the old headless mode was removed
-
JianYing export is verified on macOS, while the Windows installer is untested
-
The README requires Node.js, npm, ffmpeg, and ffprobe among the runtime dependencies
👥 For who?
-
Developers using Claude Code or Codex to make product promos
-
Teams that need React source components and continued Remotion editing
-
Creators delivering editable drafts with macOS and JianYing Pro 11.2