AI 에이전트가 네이티브 바이너리, Electron 앱, .NET 어셈블리, 웹사이트를 역공학하도록 돕는 MCP 서버 및 CLI입니다.
- 스타
- 2,000
- 포크
- 164
- 열린 이슈
- 4
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
ffmpeg-skill을 사용하면 코딩 에이전트가 ffmpeg와 ffprobe를 로컬에서 실행하는 구조화된 Python 스크립트를 호출해 동영상과 오디오 파일을 편집할 수 있습니다. 42개 도구로 클립 자르기와 이어 붙이기, 무음 제거, 영상 길이나 화면 비율 맞추기, 자막 삽입, 오버레이 추가, HDR을 SDR로 변환, 음량 정규화, 녹음 간 싱크 조정, TikTok, Reels, YouTube, X 같은 플랫폼에 맞춘 파일 내보내기를 할 수 있습니다.
각 도구는 필터 문자열을 직접 받는 대신 타입이 지정된 인자를 사용하고, --dry-run 및 --json 출력을 지원하며, 처리 결과를 probe합니다. 기계가 읽을 수 있는 계약 문서에 모든 도구의 입력과 출력이 정의되어 있으며, 같은 도구를 MCP로도 사용할 수 있습니다. 처리는 API 키 없이 오프라인으로 실행되며 Python 표준 라이브러리만 사용하지만, ffmpeg와 python3를 설치해야 합니다.
이 프로젝트는 로컬 영상 파일을 클라우드 서비스에 업로드하지 않고 에이전트가 반복적인 편집을 처리하게 하고, 완료를 보고하기 전에 에이전트가 결과를 직접 확인하도록 하려는 개발자를 대상으로 합니다.
핵심 기능
- 01가능한 경우 무손실 스트림 복사를 사용해 클립을 자르고 이어 붙이며 무음을 제거합니다.
- 029:16 자르기 및 블러 채우기를 포함해 영상 길이와 화면 비율을 지정한 값에 맞춥니다.
- 03노래방 스타일의 타이밍과 플랫폼별 안전 영역에 맞춘 줄바꿈을 적용해 자막을 삽입합니다.
- 04음량을 EBU R128 기준에 맞춰 정규화하고 HDR 영상을 SDR로 변환합니다.
- 05argparse 정의에서 생성한 계약 문서를 바탕으로 모든 도구를 MCP로 제공합니다.
활용 사례
- 에이전트가 긴 녹화 영상에서 Reels나 TikTok에 올릴 60초 세로 영상을 만들게 합니다.
- 폴더 안의 파일을 일괄적으로 음량 정규화하고 팟캐스트나 소셜 미디어용 결과물을 내보냅니다.
- 영상을 클라우드 편집기에 업로드하지 않고 자막과 오버레이를 삽입합니다.
- 각 결과물을 다음 단계로 넘기기 전에 ffprobe로 확인하는 스크립트 기반 영상 파이프라인을 구축합니다.
빠른 시작
- 1
Claude Code용 스킬 설치
npx ffmpeg-skill - 2
ffmpeg, ffprobe 및 필요한 구성 요소가 있는지 확인
npx ffmpeg-skill doctor - 3
기계가 읽을 수 있는 도구 계약 읽기
npx ffmpeg-skill contract --json | head -40
사용 전 알아둘 점
- PATH에 ffmpeg와 python3가 미리 설치되어 있어야 합니다.
- 설치 프로그램이 복사한 파일은 자동으로 업데이트되지 않습니다. 업데이트하려면 설치 명령을 다시 실행하세요.
- caption.py와 같은 일부 도구는 기본 Homebrew 빌드에 없을 수 있는 subtitles 필터 등의 FFmpeg 구성 요소가 필요합니다.
토픽
자주 묻는 질문
- ffmpeg-skill은(는) 무엇인가요?
- Claude Code, Cursor, Codex 같은 코딩 에이전트에 로컬 FFmpeg 편집 도구 42개를 제공하는 Agent Skill 및 MCP 서버입니다. ffmpeg-skill을 사용하면 코딩 에이전트가 ffmpeg와 ffprobe를 로컬에서 실행하는 구조화된 Python 스크립트를 호출해 동영상과 오디오 파일을 편집할 수 있습니다. 42개 도구로 클립 자르기와 이어 붙이기, 무음 제거, 영상 길이나 화면 비율 맞추기, 자막 삽입, 오버레이 추가, HDR을 SDR로 변환, 음량 정규화, 녹음 간 싱크 조정, TikTok, Reels, YouTube, X 같은 플랫폼에 맞춘 파일 내보내기를 할 수 있습니다.
- ffmpeg-skill은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- ffmpeg-skill은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- ffmpeg-skill은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. ffmpeg-skill의 마지막 커밋은 2026년 10월 17일입니다.
- ffmpeg-skill은(는) 어디에 사용할 수 있나요?
- 에이전트가 긴 녹화 영상에서 Reels나 TikTok에 올릴 60초 세로 영상을 만들게 합니다. 폴더 안의 파일을 일괄적으로 음량 정규화하고 팟캐스트나 소셜 미디어용 결과물을 내보냅니다. 영상을 클라우드 편집기에 업로드하지 않고 자막과 오버레이를 삽입합니다. 각 결과물을 다음 단계로 넘기기 전에 ffprobe로 확인하는 스크립트 기반 영상 파이프라인을 구축합니다.
- ffmpeg-skill는 어떻게 설치하나요?
- Claude Code용 스킬 설치: npx ffmpeg-skill ffmpeg, ffprobe 및 필요한 구성 요소가 있는지 확인: npx ffmpeg-skill doctor 기계가 읽을 수 있는 도구 계약 읽기: npx ffmpeg-skill contract --json | head -40
- ffmpeg-skill은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kajisho5/ffmpeg-skill
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code, Codex 및 기타 코딩 에이전트에서 에이전트, 스킬, 훅, 메모리와 보안 검사를 공유하는 플러그인 기반 하네스입니다.
AI가 생성한 작업 트리 변경 사항을 깔끔한 Conventional Commits, 브랜치, 안전한 pull·push와 GitHub PR로 정리하는 에이전트 스킬입니다.
코딩 에이전트가 아트 디렉션과 실제 사진, 브라우저 자체 점검으로 개성 있는 프런트엔드를 만들도록 돕는 Agent Skills입니다.
아이디어, 계획, 코드베이스를 인터랙티브 HTML 다이어그램으로 만드는 에이전트 스킬
Claude Code, Codex CLI 등에서 사용하는 플러그인 94개, 에이전트 202개, 스킬 185개와 명령어 105개 모음