Video Generator CLI Operations Skill

This skill explains the different terminal commands available to run, resume, or fix video generations.

1. Standard Generation Commands

These commands are used for a "Fresh Start." They clean up old temporary files to prevent conflicts.

npm run generate (or npm run build)

• What it does:
  1. Wipes the .video-cache.json file.
  2. Cleans the public/videos and public/audio folders.
  3. Parses your script from input/input-scripts.json.
  4. Downloads new stock footage and generates voiceovers.
  5. Renders the video scene-by-scene (Segmented Mode).
• When to use: When you have a new script or want to see fresh visuals for an existing script.

2. Advanced Recovery Commands

These commands save time by reusing already-completed work.

npm run resume

• What it does:
  1. Preserves everything in public/ and the .video-cache.json.
  2. Only downloads visuals/audio that are missing.
  3. Only renders segments that don't exist yet in the output folder.
  4. Automatically stitches everything together at the end.
• When to use: If your computer crashed, or you lost internet during a long generation. It will pick up exactly where it left off.

npm run segment

• What it does:
  1. Skips ALL asset fetching and generation.
  2. Jumps directly to "Phase 7: Assembly."
  3. Takes the existing .mp4 segments in your output folder and merges them.
• When to use: Use this if the video was rendered successfully but the final "stitching" failed or if you want to manually re-assemble the segments.

3. Developer / Debugging Tools

npm run dev

• What it does: Starts the local asset server.
• When to use: Only needed if you are manually debugging the Remotion components in the browser.

4. Operational Summary

5. Configuration (JSON Script)

When editing input/input-scripts.json, agents can use these newer properties: