BoosAPI/desktop/src-tauri/builtin-skills/ffmpeg-media/SKILL.md

name, description

name	description
ffmpeg-media	FFmpeg media processing workflow for professional video/audio analysis, compression, conversion, clipping, transcoding, timestamp summaries, subtitles, audio extraction, concat, normalization, and command generation. Use when the user asks to inspect, cut, compress, convert, batch process, or repair media files with FFmpeg.

FFmpeg Media Skill

Use this skill when the task needs reliable command-line video or audio processing.

Primary tool: https://ffmpeg.org Example agent skill: https://github.com/fabriqaai/ffmpeg-analyse-video-skill

Workflow

1. Inspect the input media first with ffprobe when duration, streams, codecs, dimensions, frame rate, or timestamps matter.
2. Preserve quality by copying streams with -c copy for simple trims/containers when possible.
3. Re-encode only when required for compression, compatibility, scaling, burn-in subtitles, filters, or codec changes.
4. For social/video platform outputs, specify codec, pixel format, audio codec, dimensions, frame rate, and faststart metadata explicitly.
5. For destructive edits, write to a new output file and never overwrite the source unless the user explicitly asks.

Common Commands

• Analyze: ffprobe -hide_banner -show_streams -show_format input.mp4
• Trim copy: ffmpeg -ss 00:00:05 -to 00:00:20 -i input.mp4 -c copy output.mp4
• H.264 web MP4: ffmpeg -i input.mov -c:v libx264 -pix_fmt yuv420p -crf 20 -preset medium -c:a aac -b:a 160k -movflags +faststart output.mp4
• Extract audio: ffmpeg -i input.mp4 -vn -c:a pcm_s16le output.wav

On macOS install system FFmpeg with brew install ffmpeg; on Windows use winget install Gyan.FFmpeg.