ChatGPT 숏 비디오 편집 Skills — 개념 설명

이것은 무엇인가?

이것은 로컬 파일과 터미널을 조작할 수 있는 AI Agent(예: ChatGPT)를 위한 '스킬 팩'입니다. 목적은: 사용자가 제공한 비디오를 안전하게 '세로형 숏 비디오'(예: 9:16 Reels, 60–90초)로 제작하는 것입니다.

프로젝트 전체는 '보수적, 신뢰 가능, 근거 있음'을 원칙으로 합니다: 원본 파일을 임의로 변경하지 않음, 업로드 또는 결제 전 동의 요청, '계획/지시/검증되지 않은 파일'을 완성품이라고 말하지 않음.

프로젝트는 번체 중국어로 작성되었으며 두 개의 스킬이 포함됩니다. 하나는 환경 관리, 하나는 편집입니다.

두 스킬의 역할 분담

스킬	담당	명시적으로 담당하지 않음
chatgpt-video-editing-setup	편집에 필요한 도구 확인, 설치, 복구, 검증: video-use, FFmpeg, ffprobe, 思源黑體 TW 자막 글꼴, ElevenLabs 자격 증명, 선택적 HyperFrames	자료 업로드, 전사, 편집, 비디오 출력 안 함
chatgpt-short-video-editor	사용자 제공 비디오에 대해 실행: 자막별 전사, 편집 전략, 거친 편집, 자막, 미리보기, QA, 공식 출력	도구를 조용히 설치하지 않음, 미리보기 승인 전 공식 버전 출력 안 함

간단히 말하면: 하나는 '환경을 준비'하고, 하나는 '실제로 비디오를 편집'합니다.

8단계 워크플로우

1. 자료 확인 — ffprobe로 소스 비디오 사양과 디코딩 가능성 확인, 원본 비디오는 변경하지 않음.
2. 자막별 전사 — 먼저 업로드 동의를 얻고 ElevenLabs Scribe v2로 '자막별 수준' 타임코드 획득(각 글자가 몇 초에 나타나는지 알 수 있음).
3. 내용 정리 — 훅(Hook), 핵심 메인 라인, 삭제 가능한 부분, 확인 필요한 정보 찾기.
4. 편집 결정 — 먼저 4–8문장의 평이한 전략을 제안하고 승인 후 컷 포인트와 창의적 요소 결정.
5. 세그먼트 거친 편집 — 완전한 단어 경계에 따라 편집 목록 생성, 30–200ms 경계 공간과 약 30ms 오디오 페이드 유지.
6. 색보정/카드/자막 — 기술적으로 필요하거나 승인된 경우에만 색보정; 정적 카드는 Pillow, 선택적 애니메이션만 HyperFrames, 자막은 思源黑體 TW로 마지막에 합성.
7. 믹싱 및 전체 미리보기 — 먼저 완전한 720p 미리보기 출력 및 확인.
8. QA 및 공식 완성 — 미리보기가 명확히 승인된 후 1080×1920 공식 파일 출력; 공식 파일도 독립적 확인과 완전 디코딩 필요, 통과 후 전달.

설치 방법

npx skills 명령으로 설치:

• 대화형(권장): npx skills add Jaycheng1103/chatgpt-video-editing-skills --full-depth — 설치 시 어떤 스킬을 설치할지, 어떤 Agent를 감지할지 선택 가능.
• 한 번에 전체 설치: npx skills add Jaycheng1103/chatgpt-video-editing-skills --all --full-depth — 모든 스킬과 감지된 모든 Agent를 한 번에 선택.
• 단일 스킬만 설치: --skill 매개변수로 지정, 예: --skill chatgpt-video-editing-setup 또는 --skill chatgpt-short-video-editor.
• 수동 Clone 후 로컬에서 설치: git clone 후 npx skills add . --full-depth 실행. 수동 복사 시 각 스킬의 references/ 폴더도 함께 유지해야 합니다.

업데이트와 제거에도 해당 명령이 있습니다(npx skills update, npx skills remove).

사전 요구 사항

• 로컬 파일 읽기/쓰기와 터미널 명령 실행이 가능한 호환 Agent
• Git, Python 및 uv(Python 패키지 관리자)
• FFmpeg 및 ffprobe
• video-use의 전체 Repo(편집 보조 프로그램 포함)
• 思源黑體 TW 서브셋 OTF(Regular 및 Bold), 번체 중국어 자막 렌더링용
• ElevenLabs Scribe v2 자격 증명 및 사용 가능한 크레딧, 자막별 전사용
• Pillow, 간단한 정적 정보 카드용
• HyperFrames(선택): 승인된 전략이 HTML / CSS / GSAP 애니메이션을 필요로 하는 경우에만, Node.js 22+ 및 Bun 필요

도구 부족 시, 편집 스킬은 안전한 위치에서 멈추고 부족함을 설명하며 Setup 스킬이 확인하도록 합니다. 스스로 억지로 설치하지 않습니다.

개인정보, 자격 증명 및 비용

• API 키를 채팅 창, 명령줄 인수, 공개 파일, Git commit, shell history 또는 log에 붙여넣지 마십시오.
• ELEVENLABS_API_KEY는 로컬 환경 변수 또는 보호된 ~/Developer/video-use/.env를 통해서만 제공; 사용 전 Git이 해당 파일을 무시하는지 확인하고 파일 권한은 600이어야 합니다.
• 처음으로 미디어를 ElevenLabs에 전송하기 전에 Agent는 구체적인 파일 이름, 용도(Scribe v2 전사), 크레딧 소비 또는 비용 발생 가능성을 설명하고 명시적 동의를 기다려야 합니다.
• 클라우드에 업로드하고 싶지 않으면 '로컬 Whisper 폴백'을 명시적으로 선택할 수 있지만 타임코드 신뢰도가 낮고 추가 재생 확인이 필요하며 Scribe v2와 동등한 정확도라고 말할 수 없습니다.

무엇이 생성되나?

모든 새 산출물은 원본 비디오 옆의 edit/ 폴더에 배치되며 원본 파일은 덮어쓰기, 이동, 이름 변경, 삭제되지 않습니다. 폴더 구조:

edit/
├── project.md              # 프로젝트 기록
├── transcripts/            # 전사 JSON
├── corrected-transcript.md # 수정된 전사
├── edl.json                # 편집 결정 목록
├── master.srt              # 메인 자막
├── clips/                  # 잘라낸 클립
├── animations/             # 선택적 애니메이션
├── qa/                     # QA 기록
├── preview.mp4             # 720p 미리보기
└── final.mp4               # 공식 완성본

final.mp4는 '720p 미리보기 승인 → 1080×1920 공식 파일 렌더링 완료 → 공식 파일 자체가 컷 포인트, 대표 프레임, 완전 디코딩 검사 통과' 후에만 전달 가능한 완성품으로 간주됩니다.

일반적인 우려 사항 처리

• 도구나 자격 증명을 찾을 수 없음 → Setup 스킬에 맡김. 먼저 확인하고 변경 사항을 나열하고 승인을 기다림. 기존 Repo에 커밋되지 않은 수정 사항이 있으면 강제 pull이나 덮어쓰기를 절대 하지 않음.
• ElevenLabs 크레딧이 없거나 업로드하고 싶지 않음 → 로컬 Whisper 폴백을 요청할 수 있지만 낮은 신뢰도 타임코드를 수용; Agent는 조용히 전환하지 않음.
• 지시, 전사, 미리보기를 보면 완료인가? → 아님. 지시 ≠ 실행됨, 화면 ≠ 완전 QA, 미리보기 ≠ 공식 전달. 올바른 순서: 전체 미리보기 확인 → 승인 → 공식 파일 렌더링 → 검증 → 전달.
• 애니메이션, B-roll, 음악, CTA를 추가하고 싶음 → 편집 전략 단계에서 제안하거나 승인. 이것들은 선택적 창의적 결정이며 기본적으로 자동 추가되지 않음.

라이선스 및 고지

• 본 Repo는 MIT License로 배포되며 기여를 환영합니다(CONTRIBUTING.md 및 CODE_OF_CONDUCT.md 있음).
• Repo에는 제3자 업스트림 코드가 포함되지 않습니다; 관련 도구, API 및 서비스는 각각의 약관과 라이선스에 따릅니다.
• 이것은 커뮤니티 유지 관리 비공식 프로젝트이며 OpenAI, ChatGPT, video-use, HyperFrames, ElevenLabs, FFmpeg, Pillow 또는 Adobe의 개발자 및 소속 회사와 종속, 라이선스, 보증, 협력 관계가 없습니다.