Communitygithub.com

Doc Real

다큐멘터리 리얼리즘 스타일: 레터박스 프레임, 필름 그레이딩, 소문자 자막 및 위치 태그. 미니 다큐멘터리, 창업자 이야기, 여행, 인터뷰, 브랜드 필름에 적합합니다. video-studio-core 엔진을 사용하여 원본 클립을 완성된 9:16 편집본으로 변환합니다(받아쓰기, 자동 편집, 모션 그래픽, 사운드, 그레이딩).

Doc Real란 무엇인가요?

Doc Real은 다큐멘터리 스타일의 비디오 편집을 위한 AI 스킬입니다. 레터박스 프레임, 필름 그레이딩, 잔잔한 카메라 워킹, 소문자 자막, 위치 태그 등을 자동으로 적용하여 미니 다큐멘터리, 창업자 인터뷰, 여행 브이로그, 브랜드 영화 등에 적합한 결과물을 만들어냅니다. 이 스킬은 `video-studio-core` 엔진 위에서 동작하며, 사용자는 단일 클립 파일을 입력하고 명령어 몇 줄로 받아쓰기, 자동 편집, 모션 그래픽, 사운드, 색보정이 포함된 완성된 9:16 영상을 얻을 수 있습니다. 또한 `plan.json` 파일을 수동으로 보정하여 훅(hook)을 개선하고, 오인식된 단어를 수정하며, 위치 정보를 추가하는 등 세부 조정이 가능합니다. 최종 결과물은 `contact_sheet.png`로 미리 확인하고 `final.mp4`로 내보내집니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/doc-real

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

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

문서

Doc Real은(는) 무엇을 하나요?

다큐멘터리 리얼리즘: 레터박스 프레임, 필름 그레이딩, 소문자 자막 및 위치 태그.

  • 최적: 미니 다큐멘터리, 창업자 이야기, 여행, 인터뷰, 브랜드 필름
  • 카테고리: 토킹헤드 릴
  • 기본 포맷: 9:16 (--format 9:16 | 1:1 | 4:5 | 16:9 로 변경 가능)
  • 카메라 영상 필요: 예, 원본 토킹 클립
  • 화자 뒤 텍스트: 아니오

시작하기 전에

이 스타일은 video-studio-core 스킬 위에서 실행됩니다. 같은 스킬 폴더에 설치되어 있어야 합니다.

  • CORE = 이 스킬 옆에 있는 video-studio-core 폴더 (예: ~/.claude/skills/video-studio-core)
  • STYLE = 이 스킬의 폴더 (theme.json과 theme.css를 포함합니다)
  • 처음 사용하는 머신에서: python CORE/scripts/check_env.py 를 실행하고, 보고된 문제를 모두 해결하세요.
  • CORE가 없으면, 사용자에게 동일한 팩에서 video-studio-core를 설치하라고 안내하세요.

편집 실행

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "장소, 시간"
# edit-*/plan.json을 보정 (아래 참조), 그런 다음 스틸 확인:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json

contact_sheet.png를 열고 전체 렌더링 전에 확인하세요. 최종 비디오는 작업 폴더의 final.mp4입니다. finish.py에 --formats 1:1,16:9를 사용하여 추가 크기를 생성하세요. 계획에 "music": {"src": "track.mp3", "volume": 0.12}를 추가하여 음악을 넣으세요.

비주얼 스타일

  • 레터박스 바, 필름 그레이딩, 그레인, 느린 푸시. 자막은 작게, 소문자, 흰색, 하단 중앙 정렬.
  • 처음 3초 동안 왼쪽 상단에 작은 위치 또는 챕터 태그. 줌 없음, 이모지 없음, 효과음 없음.

계획 보정

make_plan.py의 초안은 자동 생성됩니다. 이를 개선하세요:

  • words.json을 읽고 훅(처음 2-3초)을 짧고 구체적인 약속으로 다시 작성하세요.
  • 자동 선택된 약한 키워드를 의미를 전달하는 단어(숫자, 결과, 이름, 대비)로 교체하세요.
  • words 배열에서 잘못 들은 단어를 수정하세요 (타임은 유지).
  • 위치/컨텍스트를 --title로 전달하세요 (예: '줄라나, 하리아나 — 오전 6:40').
  • 긴 영화의 경우 dr-chapter 클래스를 사용하여 titlecard 챕터 구분을 추가하세요.
  • 요소 유형 및 필드: CORE/references/plan-schema.md 참조.

전달 전 확인 사항

  • 콘택트 시트: 텍스트 읽기 가능, 잘린 부분 없음, 의도적이지 않은 얼굴 가림 없음, 안전 영역 준수 (9:16: 텍스트는 높이의 10%~85% 사이 유지).
  • 타이밍 확인: 오버레이가 음성과 동시에 나타나고, 뒤처지지 않아야 함.
  • ffprobe로 최종 파일 확인: 올바른 크기, 길이, 오디오.
  • 사용자에게 잘라낸 부분 (제거된 초), 룩이 추가한 효과, 파일 위치를 알리세요.

룩 변경

색상과 폰트는 theme.json (vars, fontsUrl) 및 theme.css에 있습니다. 일회성 변경을 원한다면 스킬 파일 대신 plan.json (theme.vars, 요소 style)을 편집하세요.

요청 예시

  • "다큐멘터리 스타일로 편집해줘."
  • "내 이야기가 넷플릭스 다큐멘터리처럼 느껴지게 해줘."
  • "위치 태그가 있는 시네마틱 다큐 룩."

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬