# compress-video

compress-video is a Claude Code skill that re-encodes videos with ffmpeg by quality or target file size, then reports the compression.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-content/skills/compress-video/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/compress-video

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-content@Claudest
```
This installs the whole claude-content plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill compress-video -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/compress-video/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/compress-video/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill compress-video -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/compress-video/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill compress-video -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/compress-video/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-content/skills/compress-video
```

2. **Manually: put the files in place**
- File: `.github/skills/compress-video/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill compress-video -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-content/skills/compress-video
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/compress-video/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-content/skills/compress-video/SKILL.md

## When to use it
- 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
- 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

## Similar
- [video-format-conversion](https://affpapa.org/en/nevibecode/skills/video-format-conversion.md) — skill · 248 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 440900 installs
- [PDF Compress](https://affpapa.org/en/nevibecode/skills/pdf-compress.md) — skill · 4900 installs
- [halfsize](https://affpapa.org/en/nevibecode/skills/halfsize.md) — skill · ★ 116 repo stars
- [ffmpeg-analyse-video](https://affpapa.org/en/nevibecode/skills/ffmpeg-analyse-video.md) — skill · 1900 installs
- [video-analysis](https://affpapa.org/en/nevibecode/skills/video-analysis.md) — skill · 1800 installs

## Other versions with the same name
- [compress-video · pixel-point](https://affpapa.org/en/nevibecode/skills/pixel-point-compress-video.md) — ★ 64 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
