media-processing · siviter-xyz — Claude Code skill: what it does, how to install
media-processing is a Claude Code skill for batch media workflows: resizing images, converting audio, and compressing video with FFmpeg, ImageMagick, and Python scripts.
MIT 151 installs ★ 22 updated 2026-03-21
npx skills add siviter-xyz/dot-agent --skill media-processing -a claude-codeWhat media-processing does
The skill provides ready-to-run automation workflows for common media tasks. It bundles three Python scripts: batch_resize.py for bulk resizing and watermarking, media_convert.py for cross-format conversions with web, archive, or mobile presets, and video_optimize.py for bitrate and CRF adjustments.
All scripts default to non-destructive output paths and include a --dry-run flag to inspect generated commands before execution. Without ffmpeg, ffprobe, and magick available in PATH alongside Python 3.10+, these scripts will fail to process any files.
What it helps with
- Resize image batches while preserving aspect ratios
- Compress videos for web delivery using CRF or two-pass encoding
- Convert audio and video files using target presets
- Add watermarks across directories of images
Example prompts for the agent
- Optimize video files in ./input for web streaming using video_optimize.py
- Run batch_resize.py on ./assets to generate 400px thumbnails in dry-run mode
- Convert all MOV recordings to MP4 with the mobile preset using media_convert.py
How to install media-processing
1Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill media-processing -a claude-code2Manually: put the files in place
~/.claude/skills/media-processing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/media-processing/
1Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill media-processing -a codex2Manually: put the files in place
.agents/skills/media-processing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill media-processing -a cursor2Manually: put the files in place
.cursor/skills/media-processing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install siviter-xyz/dot-agent skills/media-processing2Manually: put the files in place
.github/skills/media-processing/SKILL.md1Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill media-processing -a gemini-cli2Platform CLI
gemini skills install https://github.com/siviter-xyz/dot-agent --path skills/media-processingManually: put the files in place
.devin/skills/media-processing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill media-processing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about media-processing
How to install media-processing in Claude Code?
Run npx skills add siviter-xyz/dot-agent --skill media-processing -a claude-code in your terminal.
What does the media-processing skill do?
It gives your coding agent deterministic Python wrappers and reference guides around FFmpeg and ImageMagick for batch media processing.
What system dependencies are required?
You need Python 3.10+, ffmpeg, ffprobe, and ImageMagick (magick) installed and accessible in your system PATH.
Source text
SKILL.md · MIT
--- name: media-processing description: Media processing utilities for images, audio, and video using FFmpeg and ImageMagick. Use when working with media conversion, optimization, or batch processing tasks. --- # Media Processing Tools and workflows for working with images, audio, and video in a repeatable, scriptable way using standard CLI tools (FFmpeg, ImageMagick) and Python helpers. ## When to Use - Working with image batches (thumbnails, resizing, format conversion) - Converting media between formats (video ↔ audio ↔ image) - Optimizing video size while maintaining acceptable quality - Preparing assets for web, mobile, or archival use - Designing or refining CLI workflows around FFmpeg/ImageMagick ## Key Principles - **CLI-first workflows**: Prefer command-line tools (FFmpeg, ImageMagick) and scripts that can be automated in CI or local tooling. - **Deterministic scripts**: Scripts should be safe to run repeatedly with predictable output paths and options. - **Non-destructive defaults**: Default to writing outputs to new files/directories rather than overwriting originals. - **Cross-platform friendly**: Keep examples and scripts usable on Linux, macOS, and Windows where possible. - **Agent-agnostic**: Guidance should work with any coding agent (Cursor, Claude, Copilot, etc.), not one specific environment. ## Capabilities - **Image workflows** - Batch resize and thumbnail generation - Aspect-ratio–aware resizing (fit, fill, cover, exact) - Optional watermarking - Format conversion (e.g., PNG → WebP, JPEG) - **Media conversion** - Detects media type (video, audio, image) from extension - Uses FFmpeg for video/audio, ImageMagick for images - Quality presets for `web`, `archive`, and `mobile` use cases - Batch conversion with dry-run and verbose modes - **Video optimization** - Resolution and frame-rate adjustments - Single-pass (CRF) or two-pass encoding - Audio bitrate tuning - Basic before/after comparison (size, bitrate, resolution, FPS) ## Scripts Scripts live in `scripts/` and are intended to be run directly from a shell: - `batch_resize.py` - Batch image resizing with multiple strategies (`fit`, `fill`, `cover`, `exact`, `thumbnail`) - Optional watermark overlay - Supports parallel processing and dry-run mode - `media_convert.py` - Unified conversion tool for video, audio, and images - Automatically picks FFmpeg or ImageMagick - Uses quality presets (`web`, `archive`, `mobile`) - Supports batch conversion and format changes (e.g., `.mov` → `.mp4`, `.wav` → `.mp3`) - `video_optimize.py` - Focused on video size/quality trade-offs - Resolution caps, FPS reduction, CRF tuning, optional two-pass encoding - Optional comparison summary between original and optimized outputs See `scripts/requirements.txt` for environment expectations (Python 3.10+, FFmpeg, ImageMagick) and system installation hints. ## Usage Guidelines - **Check dependencies first** - Ensure `ffmpeg` and `ffprobe` are installed and on `PATH` for video/audio tasks. - Ensure `magick` (ImageMagick) is installed and on `PATH` for image tasks. - **Prefer dry-runs when exploring** - Use `--dry-run` and/or `--verbose` flags on scripts to inspect generated commands before running them. - **Keep originals** - Point outputs to a separate directory on first runs (e.g., `--output ./out/`) to avoid accidental overwrites. - **Document workflows** - When you find good command lines or script invocations, promote them into project scripts (e.g., `just`, `npm scripts`, or CI jobs) so they’re repeatable. ## References For deeper tool-specific notes (placeholders for now, extend as needed), see: - `references/ffmpeg-encoding.md` – FFmpeg encoding patterns and flags - `references/ffmpeg-filters.md` – Common filter graphs (scale, crop, audio filters) - `references/ffmpeg-streaming.md` – Streaming-friendly settings and HLS/DASH tips - `references/format-compatibility.md` – Container/codec compatibility notes (web, mobile, desktop) - `references/imagemagick-batch.md` – Batch image processing patterns with ImageMagick - `references/imagemagick-editing.md` – Image editing operations (crop, resize, composite, text, etc.)
© siviter-xyz · MIT · siviter-xyz/dot-agent
Similar skills
All skills for Automation and no-code: n8n, Zapier, Make →media-processing by other authors comes first.