# compresso

compresso is a Claude Code skill for compressing video and image files through a desktop app. It handles batch jobs, trimming, format conversion, and subtitle embedding.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 277 installs · ★ 61 repo stars
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/compresso/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/compresso

## What it does

compresso routes video and image tasks to a desktop app that processes files locally. The app can compress multiple files, trim a clip or split it into segments, convert formats, and embed SRT or ASS subtitles. It also supports metadata edits and settings for codecs, bitrate, and audio.

Video processing uses FFmpeg; PNG, JPEG, and GIF compression uses pngquant, jpegoptim, and gifski. Processing stays on the machine, with no network calls. CLI workflows require those programs on `PATH`; building the app requires Rust, Node.js, and pnpm.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill compresso -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill compresso -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill compresso -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/compresso/SKILL.md
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill compresso -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/compresso
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill compresso -a opencode
```

### 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/akillness/jeo-skills/tree/HEAD/.agent-skills/compresso/SKILL.md

## When to use it
- compress several video or image files in one batch
- trim a clip or split it into segments
- convert video and image files to other formats
- embed SRT or ASS subtitles in a video
- edit file metadata during compression

## Example prompts
- Compress `demo.mp4` and `cover.png` with compresso.
- Trim the start of `recording.mp4` and split the rest into segments.
- Embed `captions.srt` in `episode.mp4`.

## Similar
- [video-processing-editing](https://affpapa.org/en/nevibecode/skills/video-processing-editing.md) — skill · 1500 installs
- [cli-anything-quietshrink](https://affpapa.org/en/nevibecode/skills/cli-anything-quietshrink.md) — skill · 449 installs
- [ai-video-studio](https://affpapa.org/en/nevibecode/skills/ai-video-studio.md) — skill · ★ 62 repo stars
- [video-understand](https://affpapa.org/en/nevibecode/skills/video-understand.md) — skill · 1500 installs
- [video-use](https://affpapa.org/en/nevibecode/skills/video-use.md) — skill · 6000 installs
- [ffmpeg-skill](https://affpapa.org/en/nevibecode/skills/ffmpeg-skill.md) — skill · 1600 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 99 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
