SkillPartly tested (needs an account)
Make video files smaller safely
Video Compressor Agent Skill
Free skill that shrinks video files on your computer, fits clips under WhatsApp, Discord or email limits, checks each result and keeps the original.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Graphic designers, Daily work and research
What it does
This skill lets your assistant make video files smaller for you. It first checks what your computer can do, then looks at each file and decides if compressing it is worth it. A file that is already small enough is skipped with a reason, so a new copy is never bigger than the original.
You can pick one of four quality levels (premium, high, balanced, max-saving) or ask it to fit a clip under a size limit, such as WhatsApp, Discord, email or Slack. It handles iPhone videos carefully: it keeps HDR, rotation and metadata, and it skips Live Photo, Cinematic and spatial videos instead of damaging them.
Every result is checked for length, sound, frame rate, size and resolution. The new file is saved as <name>.compressed.mp4 next to the original, and the original is never changed, moved or deleted.
Example prompts
- "Compress this video so it is much smaller but still looks the same."
- "Fit this screen recording under the Discord upload limit."
- "Compress every video in this folder and tell me which ones were not worth compressing."
- "Convert this video to H.264 so it plays on an old TV."
How to install
/plugin marketplace add AvdLee/Video-Compression-Agent-Skill/plugin install video-compression@video-compression-agent-skillHow to use it
Ask, for example: "Compress this video so it is much smaller but still looks the same" or "Fit this screen recording under the Discord upload limit."
Check it works
Run /plugin in Claude Code and check that video-compression is listed. Then ask your assistant to compress a short clip. It runs the steps doctor, probe, plan, run and verify, and a file named <name>.compressed.mp4 appears next to the original.
Common problems
- No size targets on a Mac — without ffmpeg it falls back to macOS avconvert with fixed presets; install ffmpeg with
brew install ffmpeg— https://github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/README.md - It only prints commands — no encoder was found, so it switched to advisor mode; install ffmpeg (Windows:
winget install Gyan.FFmpeg, Linux: your package manager) — https://github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/README.md - A file was skipped — it was already efficient or the saving would be under 10%; the skill gives the reason — https://github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/README.md
- Gemini CLI says "No valid skills found" — add
--path skillsto the install command; Gemini CLI looks for SKILL.md only at the top of the folder and one level down — https://github.com/google-gemini/gemini-cli/blob/v0.66.0/packages/core/src/skills/skillLoader.ts
Other assistants
- Codex: the README's Codex section says to use the skills.sh command
npx skills@latest add AvdLee/Video-Compression-Agent-Skill, or to copy theskills/video-compressionfolder into the folder your agent reads skills from. There is no separate Codex command — https://github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/README.md - Gemini CLI:
gemini skills install https://github.com/AvdLee/Video-Compression-Agent-Skill --path skills, then check withgemini skills list. INSTALLATION.md gives the same command without--path skills; in Gemini CLI v0.66.0 that form finds no skill, because the skill sits two folders down. The skill is not in the Gemini extensions gallery — https://github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/INSTALLATION.md - Manual install: copy
skills/video-compression/into your skills folder; to check, runpython3 scripts/video_compress.py doctor --humanfrom that folder (it installs nothing) — https://github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/INSTALLATION.md
What to watch out for
- Runs one Python 3 script (skills/video-compression/scripts/video_compress.py) and ffmpeg, ffprobe or macOS avconvert on your computer. It writes a new <name>.compressed.mp4 next to each video and never overwrites an existing file or changes the original
- No network use by default and no telemetry. The only download is the optional --allow-download flag: it runs pip to install imageio-ffmpeg (from PyPI) into the skill folder, which gives ffmpeg without ffprobe
- It does not install ffmpeg for you. Without ffmpeg it uses macOS avconvert with four fixed presets and no size targets; with no encoder at all it only prints commands for you to run
- Quality and size numbers in the README are the author's own benchmark on 8 iPhone clips, not a promise for your videos
- The README links to the author's paid iPhone app; the skill itself is free and does not need it
Licence and author
- Licence
- MIT
- Author
- Antoine van der Lee (AvdLee)
How we tested it
We installed it on an empty test computer on 3 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
Technical details of the test
- Date
- 3 Nov 2026
- Method
- Reviewed by our team against the repository, its README and docs.
Checked again on 3 Nov 2026
Alternatives
- HyperFrames — makes videos from web pages rather than compressing them
- HandBrake — a free desktop app for compressing video by hand
- Plain ffmpeg — the same engine, without the safety checks and decisions
FAQ
- Q: Will it delete my original video? A: No. Originals are never changed, moved or deleted.
- Q: Does it upload my videos? A: No. Everything runs on your computer and there is no telemetry. The only network use is the optional
--allow-download. - Q: Can it work on my iPhone? A: No. It works on files on a computer.
- Q: Does it cost money? A: No. It is free under MIT.
Sources
- github.com/AvdLee/Video-Compression-Agent-Skill
- github.com/AvdLee/Video-Compression-Agent-Skill/tree/ddc795ae87838cf3b72fe90a396a544edc141005
- github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/README.md
- github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/INSTALLATION.md
- github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/.claude-plugin/marketplace.json
- github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/skills/video-compression/SKILL.md
- github.com/AvdLee/Video-Compression-Agent-Skill/blob/ddc795ae87838cf3b72fe90a396a544edc141005/skills/video-compression/scripts/video_compress.py
- github.com/google-gemini/gemini-cli/blob/v0.66.0/packages/core/src/skills/skillLoader.ts