compress-video · gupsammy — Claude Code skill: shrink video files with ffmpeg
compress-video is a Claude Code skill that re-encodes videos with ffmpeg by quality or target file size, then reports the compression.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-content@ClaudestWhat compress-video does
The skill re-encodes a video in one of two modes: quality-driven CRF, or a two-pass run aimed at a target file size. It probes the file first with ffprobe to read duration, size, codec and audio bitrate, and stops right there if the file will not open.
H.264 is the default pick. It encodes quickly and plays nearly everywhere. Switch to H.265 when the goal is halving the file or the user asks for HEVC; the skill then adds the hvc1 tag so Apple hardware will play the result. Before encoding it prints input size, codec and mode, and waits for a go-ahead.
Both ffmpeg and ffprobe have to be on PATH. A size-targeted run also needs python3, since a bundled calc_bitrate.py does the bitrate math and exits with code 1 when the target is too small to fit. Audio survives untouched in CRF mode; the two-pass route re-encodes it to AAC 128k because the first pass handles video only.
What it helps with
- shrink a clip to fit an upload limit
- cut a screen recording down for a web page
- re-encode to H.265 when the file has to be as small as possible
- work out the bitrate for a target file size
- keep the original audio while the picture is re-encoded
Example prompts for the agent
- Compress
demo.mp4so it lands under 50 MB - Shrink
call-recording.movwithout visible quality loss - Re-encode
trailer.movas H.265 to get the smallest file
How to install compress-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 compress-video -a claude-code3Manually: put the files in place
~/.claude/skills/compress-video/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/compress-video/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill compress-video -a codex2Manually: put the files in place
.agents/skills/compress-video/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill compress-video -a cursor2Manually: put the files in place
.cursor/skills/compress-video/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-content/skills/compress-video2Manually: put the files in place
.github/skills/compress-video/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill compress-video -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-content/skills/compress-videoManually: put the files in place
.devin/skills/compress-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 compress-video
How do I install compress-video in Claude Code?
Add the marketplace with /plugin marketplace add gupsammy/Claudest, then install the plugin: /plugin install claude-content@Claudest.
What does compress-video do?
It re-encodes a video with ffmpeg: reads the source parameters, encodes at a fixed CRF or in two passes toward a target size, and reports the resulting size drop.
What does the skill need to run?
ffmpeg and ffprobe on PATH. Size-targeted mode also needs python3 for calc_bitrate.py, which exits with code 1 when the target cannot be reached.
Similar skills
All skills for Agent setup: memory, context, orchestration →compress-video by other authors comes first.