claude-skill-video-breakdown은(는) 무엇을 하나요?
로컬 숏폼 비디오를 분석 팩으로 변환: 숏폼 QA를 위한 장면 감지 키프레임 생성
개요
이 스킬은 로컬에 저장된 짧은 비디오(숏폼)에서 장면을 감지하고, 각 장면의 대표 키프레임을 추출하여 구조화된 분석 팩을 생성합니다. 이를 통해 AI 에이전트(Claude Code, Cursor, Codex 등)와 개발자가 비디오 콘텐츠에 대한 질의응답(QA)을 효율적으로 수행할 수 있습니다.
사용 방법
- 비디오 파일 준비: 분석할 로컬 비디오 파일 경로를 확인합니다.
- 스킬 실행: 다음 명령어를 통해 스킬을 실행합니다.
claude-skill-video-breakdown --input /path/to/video.mp4 --output /path/to/output
- 결과 확인: 출력 디렉토리에 생성된 분석 팩(JSON 파일 및 키프레임 이미지)을 확인합니다.
지원 환경
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 플랫폼
주요 기능
- 자동 장면 감지: 비디오에서 장면 전환을 자동으로 감지합니다.
- 키프레임 추출: 각 장면의 대표 키프레임을 이미지 파일로 저장합니다.
- 분석 팩 생성: 키프레임과 메타데이터를 포함한 구조화된 JSON 패키지를 생성합니다.
- QA 최적화: 추출된 데이터를 바탕으로 비디오 콘텐츠에 대한 질의응답을 지원합니다.
기술 스택
- FFmpeg: 비디오 처리 및 키프레임 추출
- 장면 감지 라이브러리: 장면 전환 감지
- Python: 스킬 로직 구현 (필요 시)
- JSON: 분석 팩 데이터 포맷
설정
분석 전 다음 환경 변수를 설정할 수 있습니다.
export SKILL_VIDEO_INPUT_DIR=/path/to/videos
export SKILL_VIDEO_OUTPUT_DIR=/path/to/analysis_output
export SKILL_VIDEO_SCENE_THRESHOLD=0.3 # 장면 감지 민감도 (0~1, 낮을수록 더 세밀)
예제 출력 구조
/output
├── analysis.json # 메타데이터 및 키프레임 정보
├── frames/
│ ├── scene_001.jpg
│ ├── scene_002.jpg
│ └── ...
└── preview/
└── overview.html # 시각적 프리뷰 (선택 사항)
참고 사항
- 지원 비디오 포맷:
.mp4,.mov,.avi,.webm - 권장 비디오 길이: 30초 ~ 5분
- 장면 감지 알고리즘은 콘텐츠 유형에 따라 결과가 다를 수 있습니다.
- 더 자세한 내용은 GitHub 저장소를 참조하세요.