Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-content@Claudest
Open on GitHub

What 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.mp4 so it lands under 50 MB
  • Shrink call-recording.mov without visible quality loss
  • Re-encode trailer.mov as H.265 to get the smallest file

How to install compress-video

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-content@Claudest

This installs the whole claude-content plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill compress-video -a claude-code

3Manually: put the files in place

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

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

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.

compress-video pixel-point The compress-video Claude Code skill compresses videos and compares codec and CRF quality. It can also inspect embedded website videos and optimize assets across a source project. CX Codex +1 ★ 64repo stars video-format-conversion eachlabs video-format-conversion — a Claude Code skill that converts video between formats, codecs, and aspect ratios through each::sense AI. Handles MP4, WebM, GIF, ProRes, and platform-ready outputs. CX Codex +1 248installs caveman-compress JuliusBrussee Compresses agent memory files (CLAUDE.md, todo lists) into caveman format — short phrases without articles or connectives. Triggered by /caveman-compress <path>. CX Codex +1 440,900installs PDF Compress claude-office-skills PDF Compress — a skill that cuts PDF file size for email, web or archive, picking a compression preset and reporting what each step saved. CX Codex +1 4,900installs halfsize YKLovePython The halfsize Claude Code skill compresses videos to a target size and measures quality with VMAF and SSIM. It activates when a file must fit a platform limit or its quality loss needs measuring. CX Codex +1 ★ 116repo stars ffmpeg-analyse-video fabriqaai ffmpeg-analyse-video pulls frames out of a video with ffmpeg, hands the images to sub-agents and returns a step-by-step summary with timestamps. CX Codex +1 1,900installs video-analysis Starchild-ai-agent video-analysis inspects video files using native multimodal processing or frame sampling with Whisper speech transcription. CX Codex +1 1,800installs

From the same set47

The whole set →
manage-memory manage-memory controls the conversation memory database in Claude Code through manual syncing, full-text searches, and usage statistics. CX Codex +1 ★ 276repo stars make-gif make-gif is a Claude Code skill that turns a selected video segment into a GIF with a two-stage palette process. Set the start point, duration, output width, and frame rate. CX Codex +1 ★ 276repo stars extract-audio extract-audio pulls sound tracks from video containers using ffmpeg and selects suitable codec presets. CX Codex +1 ★ 276repo stars get-pr-comments get-pr-comments collects GitHub pull request feedback and separates required fixes from optional suggestions. Use it to review discussion, formal reviews, and inline notes in one report. CX Codex +1 ★ 276repo stars share-social share-social reshapes a clip to a network's upload spec — frame ratio, resolution, length and bitrate — from built-in presets. CX Codex +1 ★ 276repo stars convert-video convert-video handles video tasks in Claude Code via FFmpeg: remuxes containers, trims clips, adjusts playback speed, and scales footage. CX Codex +1 ★ 276repo stars commit This skill reviews Git changes and creates Conventional Commits. Use it to split unrelated work into separate commits and push when requested. CX Codex +1 ★ 276repo stars signal-discoverer The signal-discoverer subagent for Claude Code mines recent sessions for undocumented user corrections, architectural decisions, behavioral patterns and preferences to save to project memory. CX Codex ★ 276repo stars

Project sponsors

Companies that keep this analytics open