# Video Compress To Size

> Compresses video files to stay under a user-specified max file size using FFmpeg. Prefers GPU encoders (NVENC / AMF / QSV) with VBR bitrate targeting; falls back to CPU two-pass H.264/HEVC. Use when the user wants to compress video, reduce video file size, shrink MP4/MKV/MOV under N MB, GPU encode, NVENC compress, 压缩视频, 缩小视频体积, or batch-compress clips to a size limit.

- **Type:** Skill
- **Install:** `agentstack add skill-godot-fun-godot-framework-video-compress-to-size`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [godot-fun](https://agentstack.voostack.com/s/godot-fun)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [godot-fun](https://github.com/godot-fun)
- **Source:** https://github.com/godot-fun/godot-framework/tree/main/.cursor/skills/video-compress-to-size

## Install

```sh
agentstack add skill-godot-fun-godot-framework-video-compress-to-size
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Video Compress To Size

Re-encode supported videos so each output is **at or under** a given max file size.

**Default:** probe and use a GPU encoder when available (NVIDIA NVENC → AMD AMF → Intel QSV), single-pass VBR. If no GPU works, fall back to **CPU two-pass** (`libx264` / `libx265`).

## Rules

When this skill applies, read and follow [skill-dependency-manager](../../rules/skill-dependency-manager.md) — run scripts as documented, install missing tools into `.dependency/`.

## Quick Start

```bash
.dependency/python/python .cursor/skills/video-compress-to-size/scripts/compress.py path/to/video_or_folder --max-size 50MB
```

Bare numbers mean **MB** (`--max-size 50` ≡ `50MB`):

```bash
.dependency/python/python .cursor/skills/video-compress-to-size/scripts/compress.py assets/intro.mp4 --max-size 50
```

Force CPU (slow, more precise two-pass):

```bash
.dependency/python/python .cursor/skills/video-compress-to-size/scripts/compress.py clip.mp4 --max-size 50MB --cpu
```

## Size Syntax

| Input | Meaning |
|-------|---------|
| `50` / `50MB` / `50M` | 50 mebibytes (1024² bytes) |
| `500KB` / `500K` | 500 kibibytes |
| `1GB` / `1G` | 1 gibibyte |
| `52428800B` | exact bytes |

`--max-size` is **required**.

## Format Defaults

| Setting | Default | Notes |
|---------|---------|-------|
| Encoder | GPU first | `h264_nvenc` → `h264_amf` → `h264_qsv` → `libx264` |
| HEVC | `--hevc` | Same order with `hevc_*` / `libx265` |
| Container | `.mp4` | Always MP4 |
| Audio | AAC 128k | Lowered automatically on tiny budgets |
| Preset | `medium` | Mapped (e.g. NVENC `p4`); override with `--preset` |
| Already under limit | Skipped | `[skip] … (already under limit)` |
| Safety margin | GPU ~90% / CPU ~92% | Headroom for mux / VBR overshoot |

## Common Flags

`-r` · `-o` / `--output-dir` · `--max-size` · `--audio-bitrate` · `--preset` · `--hevc` · `--cpu` · `--overwrite` · `--dry-run`

**Never overwrite source files.** Writes only to `compressed/` (or `-o`). Supported inputs: `.mp4`, `.mkv`, `.mov`, `.avi`, `.webm`, `.wmv`, `.flv`, `.m4v`, `.mpeg`, `.mpg`, `.ts`, `.mts`, `.m2ts`, `.3gp`, `.ogv`, `.ogg`.

## Agent Notes

1. Use the bundled script, not hand-written `ffmpeg` commands.
2. Always pass `--max-size` from the user (ask if missing). Prefer their unit wording; bare numbers are MB.
3. **Prefer GPU** — do not pass `--cpu` unless the user asks or GPU encode fails.
4. Do **not** downscale or change fps unless the user asks.
5. Sources already ≤ max size are skipped.
6. Tell the user where `compressed/` files are; they swap assets manually when ready.
7. Missing Python/FFmpeg → populate `.dependency/` per skill-dependency-manager, retry same command.
8. Pipeline details: [reference.md](reference.md)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [godot-fun](https://github.com/godot-fun)
- **Source:** [godot-fun/godot-framework](https://github.com/godot-fun/godot-framework)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-godot-fun-godot-framework-video-compress-to-size
- Seller: https://agentstack.voostack.com/s/godot-fun
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.