Skip to main content
skill CX Codex

video-edit · video-db — Claude Code skill: what it does, how to install

Claude Code skill for timeline video editing, audio mixing, and captioning. It runs when combining clips, inserting background music, or adjusting aspect ratios.

MIT 177 installs ★ 152 updated 2026-09-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add video-db/skills --skill video-edit -a claude-code
Open on GitHub

What video-edit does

The skill composes video clips on a multi-track timeline, places image overlays, and adds animated captions. Video rendering runs remotely on VideoDB servers without local FFmpeg or MoviePy encoding.

In Claude Code, the Python videodb library handles track orchestration, voice generation, and dubbing. Running these tasks requires a VIDEO_DB_API_KEY inside .env.

What it helps with

  • combine multiple clips with fade transitions
  • add background music at reduced volume
  • place animated karaoke captions on speech
  • change video resolution to vertical format

Example prompts for the agent

  • Join intro.mp4 and main.mp4 with a fade transition and background music
  • Add animated karaoke captions to the uploaded video
  • Crop the composition to vertical 1080x1920 for social media

How to install video-edit

1Skills CLI (Vercel)

npx skills add video-db/skills --skill video-edit -a claude-code

2Manually: put the files in place

~/.claude/skills/video-edit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/video-edit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about video-edit

How to install video-edit in Claude Code?

Run npx skills add video-db/skills --skill video-edit -a claude-code.

What does video-edit do?

It edits multi-track video timelines, syncs audio tracks, and renders finished clips using VideoDB cloud infrastructure.

What is required to run video-edit?

You need a VideoDB account with an API key stored as VIDEO_DB_API_KEY in .env, plus the videodb Python package.

Source text

SKILL.md · MIT
---
name: video-edit
description: Edit and compose video on a timeline. Use when the user wants to add background music, a voiceover or another audio track, put text, a logo or an image overlay on a video, join several videos or images into one with fades or other transitions, add animated or word-by-word karaoke captions, change the resolution or aspect ratio of a composition, or generate music, voiceover, images or video with AI for a composition. Static subtitles with a chosen font and position belong to video-subtitles.
---

# Edit and compose

## Which path

1. **VideoDB connector tools present** (names such as `render_timeline`, `upload_media`, `download_timeline_render`): use them. This is the path in Claude chat on web, desktop and mobile, and in Cowork. Do not install anything and do not ask for an API key.
2. **No VideoDB tools, but you have a shell** (Claude Code, Cowork, any agent that can run Python): ask for the VideoDB API key in one friendly line (free at https://console.videodb.io, $20 of credits, no card). When the user gives it, in chat or any other way, save it yourself to the project's `.env` as `VIDEO_DB_API_KEY`, never print it, and continue with the Python SDK path at the end of this file. In Claude Code, `/mcp` then authorizing videodb also works.
3. **No VideoDB tools and no shell**: you are in Claude chat. Reply with only this, adapted to the request: "VideoDB isn't connected yet. Open Settings → Connectors, find VideoDB, click Connect and log in (free, no card). Then send this request again and I'll take it from there." Do not mention API keys, `.env`, shells, Claude Code or `/mcp` here; none of them apply in chat, and a key pasted into chat cannot be used because nothing runs code there.

Talking to the user: never write "index", "indexed" or "indexing" in a reply. Say "searchable" ("it is now searchable by what was said and what is shown"), and "transcribe" rather than naming a job. One line of status at a time, then the result.

Rendering is a long job: the call returns `status: processing`. The reply carries an `output_url` and names the tool to poll (`poll_with`, or `retry_with` on older servers). Call that tool with the `output_url` until it is `done`; several `processing` replies in a row are normal (a 10-minute YouTube upload takes about five), and a `done` reply with an empty result means poll once more. Never re-run the write; that starts a second job. Share the finished `player_url`.

Do not fall back to ffmpeg, moviepy or local encoding for anything below; it all runs on VideoDB's servers.

## With the connector tools

**Assets first.** Every piece of media needs a VideoDB id: videos `m-`, audio `a-`, images `img-`. `upload_media(url)` takes a public URL or YouTube link (`media_type="audio"` for a music file, `"image"` for a logo). `list_videos`, `list_audios`, `list_images` show what is already there. Local files cannot come through the connector; the user uploads at https://console.videodb.io.

**One call composes everything:** `render_timeline(tracks=[...], resolution="1920x1080", background="#000000")`. Each track holds clips; each clip has `start` (seconds on the timeline), `duration`, and an `asset`. Tracks stack by `z_index` (higher on top).

| The user wants | Asset in the clip |
|---|---|
| A video, from second 10 of the source | `{"type": "video", "id": "m-...", "start": 10, "volume": 1}` |
| Background music at 20% | `{"type": "audio", "id": "a-...", "volume": 0.2}` on its own track |
| A title or lower-third | `{"type": "text", "text": "Launch day", "font": {"size": 64, "color": "#FFFFFF"}, "background": {"color": "#000000", "opacity": 0.6, "border_width": 12}}` with clip `fit: "contain"` and `position: "bottom"` |
| A logo or image | `{"type": "image", "id": "img-..."}` with clip `scale: 0.2`, `position: "top_right"`, `opacity: 0.9` |
| Captions from speech | `{"type": "caption", "src": "auto", "animation": "box_highlight"}`; the video must already be transcribed (`generate_transcript`, or a `spoken_words` analyzer run) or the render shows no captions and no error |
| A fade between clips | clip `transition: {"in": "fade", "out": "fade", "duration": 0.5}` |
| Vertical for social | `resolution="1080x1920"`, clip `fit: "crop"` |

Text assets: `width` and `height` are honoured only with `fit: "contain"`; the default `crop` scales the text box up to fill the frame.

Example, a 20-second clip with a title and quiet music:

```
render_timeline(resolution="1920x1080", tracks=[
  {"z_index": 0, "clips": [{"start": 0, "duration": 20, "asset": {"type": "video", "id": "m-abc", "start": 30}}]},
  {"z_index": 1, "clips": [{"start": 0, "duration": 4, "fit": "contain", "position": "bottom",
                            "transition": {"in": "fade", "out": "fade"},
                            "asset": {"type": "text", "text": "Launch day", "font": {"size": 64}}}]},
  {"z_index": 0, "clips": [{"start": 0, "duration": 20, "asset": {"type": "audio", "id": "a-xyz", "volume": 0.2}}]}
])
```

**An MP4 file:** `download_timeline_render(stream_url)`, poll, share the download URL.

**Generating music, voiceover, images or video with AI, and dubbing:** not available through the connector. In Claude Code the SDK does it (below). In chat, ask the user for a hosted audio or image URL to upload instead, and say that generation needs Claude Code or the SDK.

## With the Python SDK (Claude Code)

Set up first with `/videodb:setup` if `import videodb` fails. Full guide: `${CLAUDE_PLUGIN_ROOT}/python/reference/editor.md`; generation: `${CLAUDE_PLUGIN_ROOT}/python/reference/generative.md`.

```python
from dotenv import load_dotenv; load_dotenv(".env")
import videodb
from videodb.editor import Timeline, Track, Clip, VideoAsset, AudioAsset, TextAsset, Fit, Transition
conn = videodb.connect(); coll = conn.get_collection()
video = coll.upload(url="https://www.youtube.com/watch?v=VIDEO_ID")
music = coll.generate_music(prompt="warm acoustic background", duration=20)   # or coll.upload(url=..., media_type="audio")
voice = coll.generate_voice(text="Welcome to the show", voice_name="Default")
timeline = Timeline(conn); timeline.resolution = "1920x1080"
v = Track(); v.add_clip(0, Clip(asset=VideoAsset(id=video.id, start=30), duration=20))
a = Track(); a.add_clip(0, Clip(asset=AudioAsset(id=music.id, volume=0.2), duration=20))
timeline.add_track(v); timeline.add_track(a)
stream_url = timeline.generate_stream()
print(f"https://console.videodb.io/player?url={stream_url}")
```

Dubbing: `coll.dub_video(video.id, language_code="es")`.

© video-db · MIT · video-db/skills

Similar skills

All skills for AI and ML →

video-edit by other authors comes first.

video-edit prime-skills This skill routes video edits to the right RunComfy model for restyling, background or packaging swaps, and motion transfer. Use it when edit intent matters. CX Codex +1 450,700installs video-edit calesthio Local video editing via ready-made instructions for the ffmpeg CLI tool. It helps slice footage, adapt aspect ratios for social networks, and compress tracks. CX Codex +1 1,600installs video-edit 0xSero The video-edit Claude Code skill turns a screen, OBS, or talk recording into a publishable video. It trims pauses, masks on-screen leaks, improves audio, and prepares upload materials. CX Codex +1 ★ 92repo stars video-edit YildizDikme The video-edit Claude Code skill edits spoken-word videos, cutting raw takes and adding graphics or sound effects. It runs for tasks from trimming footage to rendering a finished cut. CX Codex +1 ★ 57repo stars video-edit hoodini video-edit turns a raw clip into a captioned video: transcribes the speech, lets you fix the text, then renders 16:9 or 9:16 from the same file. CX Codex +1 ★ 301repo stars video-understand calesthio video-understand — a skill for Claude Code, Codex, Cursor and other agents that pulls frames with ffmpeg and transcribes audio with Whisper entirely on your machine. No external keys, no network calls. CX Codex +1 1,500installs edit-timeline-studio MartinDelophy edit-timeline-studio — a skill for Claude Code and Codex edits Timeline Studio projects and exports videos. It analyzes local media and builds a plan while keeping the timeline editable. CX Codex +1 ★ 1,002repo stars open-edit veedstudio open-edit is a Claude Code skill for making and editing video through VEED services and a CLI. It runs when an agent needs a video, edit, or captions. CX Codex +1 1,400installs layer-video-timeline layerai layer-video-timeline turns clips, images and audio you already have into a finished video: sequencing, transitions, text overlays, logo, music. Built for editing approved shots, not generating them. CX Codex +1 4,900installs layer-video-looks layerai layer-video-looks — a Claude Code skill for styling, grading, and keying video items on the Layer timeline. Operates during clip post-processing to unify mismatched shots or add retro and film filters. CX Codex +1 1,100installs fal-video-edit nexu-io Use fal-video-edit to remix a video’s style, upscale it, remove its background, or add audio with fal.ai-hosted video models. CX Codex +1 2,900installs

From the same set6

Project sponsors

Companies that keep this analytics open