AI 에이전트를 위한 로컬 기반 영상 편집 스킬

`ffmpeg-skill`은 Claude Code, Cursor, Codex 등 AI 에이전트가 미디어 처리 작업을 수행할 수 있도록 설계된 '에이전트 스킬'입니다. 이 도구는 고정된 워크플로우(탐색 → 가능한 경우 무손실 편집 → 확인 → 검증)를 학습시키며, 자르기, 합치기, 색 보정, 자막 및 아웃레이 등 40가지의 전문적인 기능을 제공합니다. 모든 작업은 FFmpeg과 ffprobe를 사용하여 로컬 환경에서 처리할 수 있어 클라우드 연결이나 API 키가 필요 없습니다.

이 스킬은 단순한 명령어 실행을 넘어 신뢰성을 높이는 설계 원칙을 따릅니다. 첫째, 파일 이름이 아닌 `probe.py`를 통해 길이, 프레임 속도, 해상도 등 미디어를 먼저 측정합니다. 둘째, 모든 작업은 쉘 문자열 대신 타입이 지정된 인수를 가진 스크립트 형태로 이루어지며, 호출자는 이 구조화된 도구만 사용해야 합니다.

또한, `contract --json`을 통해 각 도구가 어떤 입력을 받고 무엇을 출력하는지에 대한 기계가 읽을 수 있는 계약서(Contract)를 제공합니다. 이는 에이전트에게 필요한 FFmpeg 구성 요소의 유무를 사전에 진단(`doctor`)하고, 결과물을 검증할 때까지 체계적인 과정을 거치게 합니다. 이 스킬은 파일 자르기나 측정 같은 '손' 역할을 담당하며, 어떤 부분을 편집할지 결정하는 '뇌'는 별도의 에이전트 시스템에 맡겨야 합니다.