오픈소스✓ 공식 문서로 확인11월 17일 수집
ffmpeg-skill로 클로드 코드·코덱스에서 로컬 영상 편집하는 법
ffmpeg-skill은 클로드 코드(Claude Code)·코덱스(Codex)·커서 같은 코딩 에이전트가 내 컴퓨터의 FFmpeg로 영상을 자르고 자막을 넣거나 화면 비율·음량을 맞추게 하는 에이전트 스킬이다. 도구는 42개다. 편집이 끝나면 결과 파일을 다시 재고 장면 모음 이미지를 만들어 에이전트가 눈으로 확인하게 한다. 클라우드나 API 키 없이 파이썬 표준 라이브러리만 쓴다.
- FFmpeg 6.1 이상과 파이썬 3.10 이상을 준비한다. macOS에서는 자막·글자 필터가 든
ffmpeg-full을 깐다. 기본ffmpeg포뮬러에는 subtitles·drawtext·zscale 필터가 없다.
brew install ffmpeg-full
ffmpeg-full은 keg-only라 PATH에 ffmpeg가 아예 없으면 export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"를 셸 설정 파일에 넣는다.
- 스킬을 설치하고 필요한 FFmpeg 구성 요소가 다 있는지 점검한다. 기본은 클로드 코드(
~/.claude/skills/ffmpeg-skill)에 깔리고, 코덱스는--codex, 커서는--cursor, 셋 다는--all을 붙인다. 클로드 코드 2.1.275 이상이면/plugin install ffmpeg-skill --marketplace kajisho5/ffmpeg-skill로 플러그인 설치도 된다.
npx ffmpeg-skill
npx ffmpeg-skill doctor
- 에이전트에게 평소 말로 편집을 맡긴다.
Take interview.mp4, keep 0:45–3:10 and 5:00–6:30, and make it exactly 60 seconds for Reels.
에이전트는 파일부터 분석한 뒤 구간 자르기, 9:16 자르기와 60초 맞추기, 릴스용 내보내기, 플랫폼 규격 점검을 차례로 돌리고 길이·해상도·프레임 레이트를 적어 보고한다. 원본은 덮어쓰지 않는다. 결과는 <원본>_<작업>.<확장자> 이름의 새 파일로 남는다.
음성을 받아써 자막을 만드는 --transcribe는 pip install faster-whisper 같은 음성 인식 엔진을 따로 깔아야 쓸 수 있고, 첫 실행 때 모델을 내려받는다. 설치한 스킬은 저절로 갱신되지 않아서 새 버전은 npx ffmpeg-skill을 다시 돌려 받는다. 라이선스는 MIT다.