How kajisho5/ffmpeg-skill works
ffmpeg-skill is a local, agent-facing FFmpeg toolkit: an agent probes media, selects typed editing tools, then checks and verifies the result. The tools cover editing, captions and graphics, audio, synchronization, rendering, and delivery. Shared modules provide media probing, process execution, encoding decisions, and structured results; MCP exposes the tools, while the contract describes them. The workflow and feature links below follow README claims; source-index references support shared-module links. Unsampled tool internals are not inferred.
Main entry points: _common/probe.py Probe and measure · caption.py Captions and graphics · render.py Project render · scripts/probe.py Probe media
Components 27
Agent interface
- MCP server
mcp/server.py - Tool contract
scripts/_contract.py
Media tools
- Probe media
scripts/probe.py - Cut and join
scripts/cut.py - Captions and graphics
scripts/caption.py - Picture transforms
scripts/fit.py - Audio processing
scripts/audio.py - Sync and multicam
scripts/sync.py - Scene analysis
scripts/scenes.py
Render and delivery
- Project render
scripts/render.py - Batch folders
scripts/batch.py - Export delivery
scripts/export.py - Delivery checks
scripts/check.py - Verify output
scripts/verify.py
Shared engine
- Probe and measure
scripts/_common/probe.py - Encoding decisions
scripts/_common/decision.py - FFmpeg runner
scripts/_common/runner.py - Result documents
scripts/_common/emit.py - Local transcription
scripts/_common/asr.py - Timeline helpers
scripts/_common/timeline.py - Text and fonts
scripts/_common/text.py - Caption wrapping
scripts/_common/wrap.py - Emoji rendering
scripts/_common/emoji.py - ASS overlays
scripts/_ass_overlay.py - Platform profiles
scripts/_platforms.py
Other components
- Coding agent
- FFmpeg and ffprobe
Connections 37
- Coding agent → MCP server: calls tools
- Coding agent → Probe media: probes media
- Coding agent → Cut and join: selects edits
- Coding agent → Captions and graphics: selects captions
- Coding agent → Picture transforms: selects transforms
- Coding agent → Audio processing: selects audio tools
- Coding agent → Sync and multicam: selects sync tools
- Coding agent → Project render: plans edit
- Coding agent → Batch folders: runs batch
- Coding agent → Delivery checks: checks delivery
- Coding agent → Verify output: verifies output
- MCP server → Tool contract: derives definitions
mcp/server.py - Probe media → Probe and measure: measures media
- Cut and join → Probe and measure: reads probe
scripts/cut.py - Captions and graphics → Local transcription: transcribes optionally
scripts/caption.py - Captions and graphics → ASS overlays: uses overlays
scripts/caption.py - Captions and graphics → Platform profiles: reads profiles
scripts/caption.py - Captions and graphics → Text and fonts: formats text
scripts/_common/text.py - Text and fonts → Caption wrapping: uses wrapping
scripts/_common/text.py - Text and fonts → Emoji rendering: uses emoji
scripts/_common/text.py - Project render → Timeline helpers: uses timeline
scripts/render.py - Project render → Batch folders: invokes batch
scripts/render.py - Project render → Export delivery: invokes export
scripts/render.py - Export delivery → Delivery checks: runs checks
scripts/export.py - Delivery checks → Platform profiles: reads specifications
scripts/check.py - Probe media → FFmpeg and ffprobe: uses ffprobe
- Cut and join → FFmpeg and ffprobe: runs FFmpeg
- Probe media → Result documents: emits results
- Probe and measure → FFmpeg runner: runs ffprobe
scripts/_common/probe.py - FFmpeg runner → Result documents: provides execution state
scripts/_common/runner.py - Encoding decisions → FFmpeg runner: selects encode arguments
scripts/_common/decision.py - Local transcription → FFmpeg runner: runs optional engines
scripts/_common/asr.py - Export delivery → Encoding decisions: uses encode choices
scripts/export.py - Project render → Result documents: absorbs stage results
scripts/render.py - Scene analysis → Probe and measure: reads media facts
scripts/scenes.py - Audio processing → Probe and measure: reads media facts
scripts/audio.py - Sync and multicam → Probe and measure: reads media facts
scripts/sync.py