# Video Subtitle

> 동영상에서 자막을 자동 생성하고 발표자료 기반으로 교정하는 스킬. "자막 생성", "영상 자막", "STT", "subtitle" 요청에 사용. mlx-whisper로 추출 → 중복 정리 → 발표자료 기반 교정까지 자동화.

- Skill: `majiayu000/video-subtitle` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/video-subtitle`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/video-subtitle/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/video-subtitle

---


# Video Subtitle Generator

동영상에서 자막을 생성하고 발표자료 기반으로 교정하는 스킬.

## 사용법

```bash
# 자막만 생성
/video-subtitle --video /path/to/video.mp4

# 자막 생성 + 발표자료 기반 교정
/video-subtitle --video /path/to/video.mp4 --reference /path/to/slides.pdf
```

## 워크플로우

```
┌─────────────────┐
│  동영상 입력    │
└────────┬────────┘
         ▼
┌─────────────────┐
│ subtitle-       │  mlx-whisper (large-v3)
│ generator       │  → SRT 파일 생성
└────────┬────────┘
         ▼
┌─────────────────┐
│ subtitle-       │  중복/hallucination 제거
│ cleaner         │  → 정리된 SRT
└────────┬────────┘
         ▼
┌─────────────────┐
│ subtitle-       │  발표자료 기반 STT 오류 교정
│ corrector       │  → 최종 SRT
└────────┬────────┘  (reference 있을 때만)
         ▼
┌─────────────────┐
│  최종 자막      │
└─────────────────┘
```

## 실행 단계

### Step 1: 자막 생성 (subtitle-generator)

```
Task: video-subtitle:subtitle-generator
Prompt: |
  다음 동영상에서 한국어 자막을 생성해주세요.
  - video_path: $video
  - language: ko
  - model: large-v3
```

출력: `{video_basename}.srt`

### Step 2: 중복 정리 (subtitle-cleaner)

```
Task: video-subtitle:subtitle-cleaner
Prompt: |
  다음 자막 파일에서 중복과 hallucination을 정리해주세요.
  - srt_path: {output_from_step1}
```

### Step 3: STT 교정 (subtitle-corrector) - reference가 있을 때만

```
Task: video-subtitle:subtitle-corrector
Prompt: |
  발표자료를 참조하여 STT 오류를 찾고 수정해주세요.
  - srt_path: {output_from_step2}
  - reference_path: $reference
```

## 예시

### 입력
```
/video-subtitle --video community/ai-builders-meetup/2-echo-delta/videos/meetup_02_서진님.mp4 --reference community/ai-builders-meetup/2-echo-delta/slides/1-김서진-AI-Native.pdf
```

### 출력
```
## 자막 생성 완료

### 1. 자막 추출
- 입력: meetup_02_서진님.mp4 (9.8분)
- 출력: meetup_02_서진님.srt
- 세그먼트: 116개
- 소요: 4분 30초

### 2. 중복 정리
- 원본: 116개 → 정리 후: 81개
- 제거: 35개 (30%)

### 3. STT 교정
- 발견된 오류: 23개
- 수정 완료: 23개

### 최종 파일
community/ai-builders-meetup/2-echo-delta/videos/meetup_02_서진님.srt
```

## 시스템 요구사항

- Apple Silicon Mac (M1/M2/M3)
- Python 3.10+
- 메모리: 16GB+ (large-v3 모델용)
- 저장공간: 3GB+ (모델 다운로드)

## 지원 형식

- 입력: mp4, mov, mkv, webm, avi
- 출력: srt
- 발표자료: pdf