Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add siviter-xyz/dot-agent --skill media-processing -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/media-processing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/media-processing/

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.

media-processing mrgoonie media-processing — a skill for Claude Code, Codex, Cursor and other AI agents that brings FFmpeg and ImageMagick into the chat workflow. Handles video transcoding, audio extraction, image resizing and batch processing on command. CX Codex +1 575installs transloadit-media-processing official github transloadit-media-processing is a GitHub Copilot skill for processing video, audio, images and documents through Transloadit, including encoding, thumbnails and text extraction. CX Codex +1 8,700installs raw-video-processing zc277584121 raw-video-processing cleans up raw screen recordings by cutting silent pauses and speeding up the footage. Useful before publishing demos or tutorials. CX Codex +1 3,900installs video-processing-editing curiositech video-processing-editing is a Claude Code skill that automates FFmpeg video editing, from trimming clips to mixing audio. It activates for requests about video edits, FFmpeg, transitions, or export settings. CX Codex +1 1,500installs FFmpeg docker MCP server for processing video files using FFmpeg. It provides tools for editing video, manipulating graphics, and verifying file presence. CX Codex +1 image-processing jezweb image-processing is a Claude Code skill for routine web image work: resize, trim whitespace, convert formats, and create thumbnails and OG cards through a Pillow-based CLI. CX Codex +1 2,500installs image-manipulation-image-magick official github image-manipulation-image-magick is a GitHub Copilot skill that resizes images, converts formats and reads metadata. It creates thumbnails and processes image batches. CX Codex +1 9,723installs

From the same set11

The whole set →
software-engineer software-engineer — a skill that gives the agent rules for code style, documentation and workflow: no filler comments, no git commits on its own, questions when something is unclear. CX Codex +1 637installs python Gives the agent one set of Python conventions: typing, dependency injection, module and test layout. Useful when edits land in an existing codebase. CX Codex +1 353installs create-agents-md create-agents-md generates repo-committed AGENTS.md files for inline rules. Useful for keeping code style, build commands, and safety boundaries close to the code. CX Codex +1 306installs typescript typescript is a Claude Code skill that sets standards for writing and changing TypeScript. It activates for TypeScript and TypeScript React files. CX Codex +1 239installs cli-building cli-building guides AI agents to build command-line tools using async-first patterns, modular command composition, and terminal formatting with NO_COLOR support. CX Codex +1 201installs semantic-git The semantic-git skill groups related changes into atomic commits and formats messages as Conventional Commits. Use it when an agent is preparing Git changes for commit. CX Codex +1 201installs debugging debugging is a Claude Code skill that guides root cause analysis for errors and test failures. It helps localize bugs and prepare minimal, verified fixes. CX Codex +1 151installs psi psi structures development around planning, specifications and test-first implementation. It runs only when the user asks for it or the project’s AGENTS.md mentions it. CX Codex +1 144installs

Project sponsors

Companies that keep this analytics open