Engineering
ffmpeg-skill avatar

ffmpeg-skill

Universal media processing agent skill for converting, compressing, trimming, and editing audio/video files using FFmpeg.

Introduction

The FFmpeg Media Processing skill serves as a comprehensive interface for performing complex audiovisual operations directly within your agent workspace. Designed for developers, content creators, and power users who need to handle multimedia files programmatically, this skill encapsulates the immense power of the FFmpeg command-line suite into a streamlined, intent-based execution model. Whether you are dealing with professional video workflows, extracting audio from existing clips, or automating batch processing for large media libraries, this skill provides the necessary abstractions to handle codecs, containers, and complex filter graphs without requiring manual shell script configuration.

  • Full support for format conversion (MP4, MKV, WebM, MP3, WAV, etc.) and transcoding tasks.

  • Advanced video manipulation features including resizing, cropping, rotating, mirroring, and frame rate adjustment.

  • Stream-based operations for trimming, cutting, merging, and fast-copying media without re-encoding, preserving original quality.

  • Specialized filtering capabilities such as burning subtitles, adding text overlays, applying visual effects, and adjusting audio channels.

  • Automated metadata extraction and analysis using ffprobe to gain deep insights into file streams, bitrates, and encoding parameters.

  • Complex pipeline support for streaming protocols (HLS, DASH, RTMP) and multi-output synchronization.

  • Always verify file availability and paths before execution, as the skill operates directly on the local file system.

  • Use the -c copy option whenever possible for lossless operations to save computational resources and time.

  • For quality-sensitive tasks, leverage the -crf parameter to balance file size against visual fidelity; typical values range between 18 and 28.

  • The skill maintains strict adherence to the FFmpeg global syntax, where option order relative to inputs and outputs is critical.

  • Ensure you have appropriate permissions to read/write files in the target directory and confirm the presence of an FFmpeg installation on the system host.

Repository Stats

Stars
4,437
Forks
1,203
Open Issues
7
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
Apr 29, 2026, 12:47 PM
View on GitHub