shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

blitzreels-clipping

Repurpose long-form video into short vertical clips with the BlitzReels API. Use when the task mentions clipping, repurposing a long video into shorts, YouTube-to-shorts, transcript-backed short suggestions, podcast-to-shorts reframing, split-speaker podcast layouts, highlight reel extraction, choosing the best moment from a long source, vertical video from horizontal, making TikToks or Reels or Shorts from a longer asset, repairing weak framing on an applied clip, or exporting a final vertical short. Also use when the user says "clip this", "cut me a short", "best parts of this video", or "repurpose this content".

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

BlitzReels Clipping

Use the managed clip state machine. It owns ingest, transcription, selection, layout, captions, QA, repair, and export sequencing.

Steps

  1. Resolve the source as a supported public video URL or workspace asset ID and resolve selection intent. Use a provided time range or suggestion; use automatic best selection only when choice is delegated. Complete when source and selection mode are explicit.
  2. Choose the available surface. Prefer the bundled MCP clips_create tool; otherwise discover the current contract with blitzreels agent-context --command "clips create" --json or the OpenAPI /clips operations. Complete when required inputs, mutation effects, and state fields are known.
  3. Create with a caller-generated idempotency key. Complete when the response contains a clip ID, project ID, state, and next_action.
  4. For MCP batches, follow batch.polling with clips_get. For managed API clips, follow next_action: poll, reselect, repair, export, or stop. Complete each transition only when the next response advances or reaches a terminal state.
  5. When the user retained selection choice, present available alternatives with title, hook, range, duration, and score; reselect the approved ID or range. Complete when the chosen selection is persisted.
  6. Validate layout intent. Tutorial layout is for flattened screen-share plus facecam footage. Interview and podcast footage use automatic, split, or focus layouts. Complete when applied layout and content type agree.
  7. Review QA previews and warnings; run only the repair action offered by current state. Complete when QA passes or the state reports a specific unresolved block.
  8. Start a paid export only after user approval and an export-ready state. Poll to terminal and verify output duration, aspect ratio, captions, framing, and download location.

Manual branch

Use low-level project media, transcript, timeline, caption, and preview operations only when managed state reports a specific block requiring manual control.

Return to the managed clip after the repair instead of rebuilding its state machine with low-level calls.

Completion

Return clip and project IDs, selected range, applied layout, QA result, warnings, export status, and download location.

If blocked, return next_action, the exact blocking state, and the user choice or system state required. Completion requires a verified terminal output or an explicit managed-state blocker.