/video

name: claude-video
description: >
  AI-powered video production suite: editing, transcoding, captioning, analysis, creation,
  shortform pipeline, image/video generation, web screenshots, AI audio/video enhancement.
  Uses FFmpeg, Whisper, PySceneDetect, FLUX.2, Veo, Playwright, Real-ESRGAN, Demucs, and
  Remotion. GPU-accelerated with NVIDIA NVENC. Use when user says "video", "ffmpeg", "trim",
  "cut", "transcode", "caption", "export", "analyze", "download", "create video", "shorts",
  "tiktok clips", "generate image", "generate video", "screenshot", "upscale", "enhance",
  "denoise", "separate vocals", "face restore", "slow motion", "remove background", or "/video".
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep

claude-video — CLI-Native Video Editing for Claude Code

Quick Reference

| Command | What it does | |---------|-------------| | `/video` | Interactive mode — describe what you want in plain English | | `/video setup` | Install all dependencies (faster-whisper, auto-editor, scenedetect, yt-dlp, mediainfo) | | `/video edit` | Trim, cut, split, merge, speed, crop, overlay, stabilize, transitions | | `/video transcode` | Convert codecs, compress, GPU-accelerated encoding, two-pass | | `/video audio` | Normalize loudness, reduce noise, mix, extract, remove silence | | `/video caption` | Transcribe speech → animated word-by-word subtitles (Whisper + ASS) | | `/video analyze` | Inspect with ffprobe, measure quality (VMAF/SSIM/PSNR), detect scenes | | `/video export <platform>` | One-command export: youtube, tiktok, instagram, linkedin, web, gif, podcast | | `/video download <url>` | Download video via yt-dlp with format selection | | `/video create` | Programmatic video creation via Remotion (React-based motion graphics) | | `/video shorts` | Longform → shortform pipeline: transcribe, score, crop 9:16, caption, export | | `/video image` | AI image generation (Gemini 3 Pro Image, FLUX.2 local, SD 3.5, OpenAI, rembg) | | `/video generate` | AI video generation (Veo 3.1, Runway Gen-4, local SVD) | | `/video screenshot` | Web capture via Playwright (screenshots, recordings, Ken Burns) | | `/video enhance-audio` | AI audio (Demucs separation, DeepFilter denoise, TTS, diarize, AudioSR) | | `/video enhance` | AI video (Real-ESRGAN upscale, RIFE interpolation, CodeFormer, rembg) | | `/video promo` | Stock footage + Remotion promo videos with contrast-aware text overlays | | `/video setup --ai` | Install AI dependencies (PyTorch, WhisperX, FLUX.2, Real-ESRGAN, etc.) |

Orchestration Logic

Command Routing

When the user provides a specific command, load the matching sub-skill:

• `/video edit` or intent is trim/cut/split/merge/speed/crop/overlay/stabilize/transition → Read `skills/claude-video-edit/SKILL.md`
• `/video transcode` or intent is convert/compress/encode/codec/format change → Read `skills/claude-video-transcode/SKILL.md`
• `/video audio` or intent is audio normalize/noise/mix/extract/silence/volume/LUFS → Read `skills/claude-video-audio/SKILL.md`
• `/video caption` or intent is transcribe/subtitle/caption/whisper/SRT/ASS → Read `skills/claude-video-caption/SKILL.md`
• `/video analyze` or intent is inspect/info/quality/VMAF/metadata/scene detect/ffprobe → Read `skills/claude-video-analyze/SKILL.md`
• `/video export` or intent is export for youtube/tiktok/instagram/linkedin/web/gif/podcast → Read `skills/claude-video-export/SKILL.md`
• `/video download` or intent is download video from URL → Read `skills/claude-video-download/SKILL.md`
• `/video create` or intent is create/generate programmatic video/motion graphics/title card → Read `skills/claude-video-create/SKILL.md`
• `/video shorts` or intent is shortform/clips/TikTok shorts/reels from longform → Read `skills/claude-video-shorts/SKILL.md`
• `/video image` or intent is generate image/AI image/FLUX/stable diffusion/remove background → Read `skills/claude-video-image/SKILL.md`
• `/video generate` or intent is generate video/AI video/Veo/Runway/text-to-video → Read `skills/claude-video-generate/SKILL.md`
• `/video screenshot` or intent is screenshot/web capture/screen recording/Ken Burns → Read `skills/claude-video-screenshot/SKILL.md`
• `/video enhance-audio` or intent is separate vocals/denoise AI/diarize/TTS/voice clone/upsample audio → Read `skills/claude-video-enhance-audio/SKILL.md`
• `/video enhance` or intent is upscale/super resolution/interpolate/face restore/remove background video → Read `skills/claude-video-enhance/SKILL.md`
• `/video promo` or intent is promo video/stock footage/marketing video/stock clips with text → Read `skills/claude-video-promo/SKILL.md`
• `/video setup` → Run `bash scripts/setup.sh`
• `/video setup --ai` → Run `bash scripts/setup.sh --ai`

Interactive Mode

When user says `/video` without arguments or describes a task in natural language: 1. Run `bash scripts/check_deps.sh` to verify tools are available 2. Run `bash scripts/detect_gpu.sh` to know encoding capabilities 3. Identify intent from the user's description 4. Route to the appropriate sub-skill 5. If intent is ambiguous, ask the user to clarify

Multi-Step Pipelines

For complex requests that span multiple sub-skills (e.g., "download this YouTube video, remove silence, add captions, export for TikTok"), execute sub-skills sequentially: 1. Download → edit → caption → export 2. Pass output of each step as input to the next 3. Use temp files in `/tmp/claude-video/` for intermediate outputs 4. Clean up temp files after final output is produced

Safety Rules — MANDATORY

1. **Always use `-n` flag** (no-overwrite) unless user explicitly requests overwrite 2. **Never let output path equal input path** — run `bash scripts/preflight.sh "$INPUT" "$OUTPUT"` before any write 3. **Never delete source files** — all operations produce new files 4. **Run preflight before every write operation**: `bash scripts/preflight.sh <input> <output>` 5. **Confirm before**: batch operations (>3 files), downloads