claude-mediakit

claude-mediakit

A Claude Code plugin that gives Claude hands-on media engineering skills. It bundles ffmpeg-powered workflows so Claude can transcode, package, and preview video without you spelling out ffmpeg flags — plus a safety hook that stops it from clobbering your source files.

What's inside

Skill	Triggers on	Does
video-to-hls	"convert to HLS", "make this streamable"	Adaptive-bitrate HLS ladder + faststart MP4
thumbnail-grid	"contact sheet", "thumbnail grid"	Evenly-sampled tiled frame grid (PNG)
extract-subtitles	"extract subtitles", "get the SRT"	Embedded subtitle tracks → SRT + VTT
gif-preview	"make a GIF", "animated preview"	Optimized two-pass-palette GIF

Also included:

• media-engineer agent — a subagent that probes before transcoding, picks the right format for the goal, and never overwrites a source.
• PreToolUse safety hook — blocks any ffmpeg command that would write its output over one of its own inputs (a silent, destructive in-place overwrite).

Each skill ships a small, self-contained shell script under its scripts/ directory, so the workflows are deterministic and don't depend on Claude re-deriving ffmpeg incantations.

Requirements

ffmpeg and ffprobe on your PATH. That's it.

Install

/plugin marketplace add danrigoli/claude-mediakit
/plugin install claude-mediakit

Or point Claude Code at a local checkout while developing:

claude --plugin-dir /path/to/claude-mediakit

Use it

Just ask in natural language — the matching skill loads automatically:

• "Convert demo.mov to HLS so I can stream it."
• "Make a 4×3 thumbnail grid of intro.mp4."
• "Pull the English subtitles out of movie.mkv as an SRT."
• "Turn the first 5 seconds of clip.mp4 into a GIF."

You can also run the scripts directly:

skills/video-to-hls/scripts/transcode-hls.sh input.mp4 out
skills/thumbnail-grid/scripts/contact-sheet.sh input.mp4 sheet.png 4 3
skills/extract-subtitles/scripts/extract-subs.sh input.mkv
skills/gif-preview/scripts/make-gif.sh input.mp4 preview.gif 5 4 480 12

Companion project

For heavier HLS work — a typed library, progress bars, and a drag-and-drop web player — see hls-forge. This plugin's video-to-hls skill is the quick, in-session version of the same idea.

License

MIT — see LICENSE.