Communitygithub.com

스타일 비디오 캡션

Codex 스킬: 오디오를 텍스트로 변환하고 세련된 스타일의 캡션을 비디오에 입힙니다.

스타일 비디오 캡션란 무엇인가요?

이 스킬은 비디오에 전문적이고 일관된 스타일의 자막을 제작하는 Codex 에이전트용 도구입니다. 기존 .srt 또는 .vtt 파일이 있으면 이를 사용하고, 없으면 faster-whisper tiny 모델로 자동 전사하여 SRT 파일을 생성합니다. 생성된 자막은 Archivo 가변 폰트를 사용하여 흰색 본문, 전기청색 키워드 강조, 잉크블루 반투명 배경 등 정해진 디자인 시스템에 따라 ASS(Advanced SubStation Alpha) 포맷으로 스타일링됩니다. 최종 출력물은 ffmpeg의 libass/subtitles 필터를 통해 렌더링되며, 스타일링된 ASS 파일, MP4 비디오, 미리보기 JPG 이미지가 생성됩니다. 주로 Windows PowerShell 환경에서 실행되며, CapCut에 내장된 ffmpeg 대신 전체 빌드된 ffmpeg가 필요합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add OscarCode9/style-video-captions-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스타일 비디오 캡션은(는) 무엇을 하나요?

원본을 보존하면서 새 캡션이 포함된 비디오를 만듭니다. 기존 .srt 파일이 있으면 우선 사용하고, 타임드 트랜스크립트가 없는 경우에만 faster-whisper tiny로 전사합니다.

기본 디자인 방향

다음 편집-기술 시스템과 함께 번들로 제공되는 Archivo 가변 폰트를 사용합니다.

  • 흰색 기본 텍스트: #FFFFFF
  • 전기청색 키워드: #2F80FF
  • 청색 키워드는 가벼운 Barlow Condensed 이탤릭체로 설정하고 약 16% 더 크게
  • 잉크블루 반투명 상자/윤곽선: #071A33
  • 최대 두 줄, 짧은 구문
  • 모바일 UI 안전 영역 위의 하단 중앙 배치
  • 짧은 등장 및 페이드 효과; 지속적인 바운싱이나 글자별 혼란은 피함

시각적 방향을 변경할 때는 references/design-guidelines.md를 참조하세요.

워크플로우

  1. 비디오의 크기와 길이를 확인합니다.
  2. 일치하는 .srt 또는 .vtt 파일을 찾습니다. 없으면 scripts/transcribe_tiny.py로 SRT를 생성합니다.
  3. scripts/make_styled_ass.py로 스타일링된 ASS 파일을 생성합니다.
  4. subtitles/libass 필터가 포함된 전체 ffmpeg 빌드로 렌더링합니다. CapCut에 번들된 ffmpeg에는 이러한 필터가 없을 수 있습니다.
  5. 최종 길이, 비디오 스트림, 오디오 스트림, 캡처한 프레임에서 가독성을 확인합니다.
  6. 입력 비디오와 트랜스크립트를 보관합니다.

표준 명령어

powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-dir>\scripts\style-video-captions.ps1" `
  -InputVideo "C:\path\video.mp4"

기존 SRT 사용:

powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-dir>\scripts\style-video-captions.ps1" `
  -InputVideo "C:\path\video.mp4" `
  -SubtitleFile "C:\path\captions.srt"

출력물:

  • <video>_subtitulos_estilo.ass
  • <video>_subtitulos_estilo.mp4
  • <video>_subtitulos_preview.jpg

디자인 판단

파란색은 강조용으로만 사용하고, 유일한 텍스트 색상으로는 사용하지 않습니다. 흰색은 변화하는 영상에서도 더 신뢰할 수 있습니다. 캡션이 예측 불가능한 휘도의 이미지 위에 표시되므로 어두운 윤곽선/상자 대비를 유지합니다.

불용어는 강조하지 않습니다. 명사, 동사, 숫자 및 의미 있는 긴 용어를 선호합니다. 애니메이션은 읽기에 방해가 되지 않도록 합니다.

관련 스킬