AI 칼럼

영상@donghyeok99운영진

ffmpeg-skill: 에이전트에게 쥐여 주는 내 컴퓨터 영상 편집기

「두 구간만 남겨 60초 릴스로」 한마디에 에이전트가 자르고, 세로로 맞추고, 결과까지 열어 봐요

긴 영상에서 0:45–3:10과 5:00–6:30만 남겨 60초로 잇고, 9:16 세로로 잘라 릴스 규격 검사를 통과하기까지예요.
긴 영상에서 0:45–3:10과 5:00–6:30만 남겨 60초로 잇고, 9:16 세로로 잘라 릴스 규격 검사를 통과하기까지예요.
누가
kajisho5(Kajiyama S.)가 만든 개인 프로젝트예요. 영상 편집을 코딩 에이전트에게 맡기고 싶은 사람을 위한 스킬이에요.
언제
2026년 9월 3일 공개, 최신은 2026년 10월 30일 v2.21.0이에요. 10월 29~30일에만 세 번 릴리스했어요.
어디서
Claude Code, Cursor, Codex와 MCP 클라이언트에서 써요. macOS·Linux·Windows, 모두 내 컴퓨터에서 돌고 클라우드나 API 키가 없어요.

이게 불편했어요

찍어 둔 영상 하나를 릴스용으로 바꾸려 해도 구간 자르기, 세로로 맞추기, 음량 맞추기, 내보내기 설정을 하나하나 찾아야 했어요. 에이전트에게 FFmpeg 명령을 맡기면 프레임레이트를 짐작하거나 다시 인코딩할 필요 없는 파일을 다시 인코딩하고, 결과를 열어 보지도 않고 끝났다고 말하곤 했어요.

그래서 이렇게 풀어요

ffmpeg-skill은 에이전트에게 정해진 작업 순서와 42개의 도구를 줘요. 셸 문자열 대신 인자가 정해진 파이썬 스크립트가 ffmpeg를 돌리고, 결과 파일을 다시 재서 길이와 해상도를 JSON으로 돌려줘요. 화면이 바뀐 작업이면 에이전트가 contact sheet 그림을 직접 보고 나서야 끝났다고 보고해요.

안에서는 이렇게 돌아가요

  1. 1

    나 → Claude Code

    「interview.mp4를 60초 릴스로」남길 구간과 올릴 곳(릴스)을 말로 전해요.
  2. 2

    Claude Code → SKILL.md

    probe → 편집 → check → look 순서SKILL.md의 작업 순서와 요청→스크립트 표를 읽고 어떤 도구를 쓸지 정해요.SKILL.md
  3. 3

    Claude Code → probe · cut · fit · check.py

    probe.py interview.mp4길이, fps, 해상도, 오디오를 먼저 재요. 파일 이름이 아니라 잰 숫자로 계획해요.scripts/probe.py
  4. 4

    Claude Code → probe · cut · fit · check.py

    cut.py --segments 0:45-3:10,5:00-6:30건드릴 필요 없는 부분은 다시 인코딩하지 않고 스트림 복사로 잘라요.scripts/cut.py
  5. 5

    probe · cut · fit · check.py → ffmpeg / ffprobe

    셸 없이 인자 목록으로 실행도구가 ffmpeg를 직접 부르고, 멈춰 버리면 --timeout으로 끊고 반쯤 쓴 파일을 지워요.scripts/_common/runner.py
  6. 6

    Claude Code → probe · cut · fit · check.py

    fit.py --duration 60 --aspect 9:16길이를 60초로, 화면을 9:16으로 맞춘 뒤 export.py --preset reels로 내보내요.scripts/fit.py
  7. 7

    probe · cut · fit · check.py → final.mp4와 contact sheet

    check.py --platform reels, look.py규격을 PASS/WARN/FAIL로 따지고, 화면이 바뀌었으면 contact sheet PNG를 에이전트가 직접 봐요.scripts/check.py

넣으면 이렇게 나와요

interview.mp4에서 0:45–3:10과 5:00–6:30만, 릴스용 60초final.mp4: 59.98 s, 1080×1920, 30 fps, AAC stereo
talk.mp4와 cues.txt, TikTok 템플릿9:16 크롭, 설명줄 위에 단어별 자막, −14 LUFS, check.py 결과까지
같은 편집에 --template all플랫폼마다 한 파일씩과 결과 표 <name>_pack.md

나한테 맞을까요

이럴 때 좋아요

  • 찍어 둔 인터뷰나 강의를 릴스, 쇼츠, 틱톡용으로 자주 바꾸는 사람
  • 올리고 싶지 않은 영상을 내 컴퓨터 안에서만 편집하고 싶을 때
  • 자막 넣기, 무음 자르기, 음량 맞추기 같은 반복 작업을 에이전트에게 맡기고 싶을 때
  • Claude Code뿐 아니라 Cursor, Codex, MCP 클라이언트에서도 같은 도구를 쓰고 싶을 때

이건 안 돼요

  • 무엇을 자를지, 어느 장면이 재미있는지는 정하지 않아요. 편집을 실행할 뿐 판단은 에이전트나 사람 몫이에요(README 기준).
  • 얼굴이나 피사체를 스스로 찾지 않아요. 세로로 자를 때 기본은 가운데이고, 위치는 에이전트가 contact sheet를 보고 정해요.
  • 말소리로 자막을 만들려면(--transcribe) faster-whisper 같은 로컬 음성 엔진을 따로 설치해야 해요.
  • macOS의 기본 Homebrew ffmpeg에는 자막·drawtext 필터가 없어 ffmpeg-full이 필요해요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기