convert-video — Claude Code skill: what it does, how to install
convert-video handles video tasks in Claude Code via FFmpeg: remuxes containers, trims clips, adjusts playback speed, and scales footage.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-content@ClaudestWhat convert-video does
The skill manages everyday video workflows straight from conversational prompts. It evaluates stream codecs and frame dimensions using ffprobe before running tasks. Whenever identical codecs allow it, the tool uses -c copy to remux files instantly without re-encoding. Combined actions like trimming and scaling get merged into a solitary ffmpeg run, saving disk space by eliminating temporary files.
The command always asks for user approval before touching local files. Both ffmpeg and ffprobe must exist in your system PATH, otherwise every execution fails immediately.
What it helps with
- Remux MKV files into MP4 containers without quality loss
- Trim clip segments accurately using start and end timestamps
- Speed up or slow down video footage alongside synced audio
- Downscale dimensions cleanly without upscaling smaller inputs
- Extract image stills to JPEG files at regular time intervals
Example prompts for the agent
- Trim
clip.mp4from 00:00:30 to 00:01:15 without re-encoding - Scale down
capture.movto fit 1280x720 while keeping aspect ratio - Speed up
timelapse.mp4by 2x including the audio track
How to install convert-video
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-content@ClaudestThis installs the whole claude-content plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill convert-video -a claude-code3Manually: put the files in place
~/.claude/skills/convert-video/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/convert-video/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill convert-video -a codex2Manually: put the files in place
.agents/skills/convert-video/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill convert-video -a cursor2Manually: put the files in place
.cursor/skills/convert-video/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-content/skills/convert-video2Manually: put the files in place
.github/skills/convert-video/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill convert-video -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-content/skills/convert-videoManually: put the files in place
.devin/skills/convert-video/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about convert-video
How to install convert-video in Claude Code?
Add the repository with /plugin marketplace add gupsammy/Claudest, then run /plugin install claude-content@Claudest to complete the setup.
What does convert-video do?
It checks video attributes via ffprobe, builds the appropriate ffmpeg command for editing or format conversion, and runs it after confirmation.
Why does video rotation re-encode instead of copying the stream?
Copying streams leaves rotation as a metadata flag that causes playback issues in external software. The skill uses transpose to hardcode rotation into frame pixels.