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-skill

How 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

Other assistants

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)
Source code
github.com/AvdLee/Video-Compression-Agent-Skill

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.

Test level
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