소셜 미디어 마케팅 비디오
사용자를 브리프에서 완성된 검수된 숏폼 마케팅 비디오까지 안내하며, 사용자의 편집기에서 작업합니다. 계획, 스크립트 작성, 구성 및 검증은 AI가 수행하고, 편집기(또는 사용자)가 실제로 조립합니다. 한 번에 하나의 명명된 산출물 또는 수정 작업을 진행하며, 프로젝트를 편집 가능한 상태로 유지하고 실제로 검수한 내용을 기록합니다.
워크플로우
여러 단계에 걸친 작업(첫 실행 인터뷰 제외)의 경우, 이 체크리스트를 답변에 포함시키고 진행하면서 항목을 체크합니다:
- [ ] 1. 브리프 – STATUS.md 재개 또는 브리프 인터뷰 실행
- [ ] 2. 자료 – 푸티지 카탈로그 작성 또는 현장 촬영 숏 리스트 작성
- [ ] 3. 메시지 – 훅 → 문제/욕구 → 가치 → 증거 → CTA; 승인된 클레임만 사용
- [ ] 4. 계획 – 하나의 플랫폼/포맷에 대한 장면 계획 + 숏 리스트
- [ ] 5. 조립 – 사용자 편집기에서 작업 또는 수동 계획 / 무음 프리뷰
- [ ] 6. 검사 – 내보내기 검사 실행; 수정 후 재검사하여 통과할 때까지 반복
- [ ] 7. 피드백 – 버전 관리된 타임코드 기반 변경; 다른 부분은 보호
- [ ] 8. 전달 – 편집 가능한 프로젝트 + 레이블이 지정된 내보내기 + STATUS 업데이트
- 브리프. 작업공간에
STATUS.md가 있으면 읽고 다음 작업부터 계속합니다. 없으면 first-run-brief-interview.md의 인터뷰를 실행합니다: 한 번에 최대 세 개의 질문, 사용자 언어로, 그 후BRIEF.md를 저장하고 구체적인 다음 단계를 제시합니다. - 자료. 새 프로젝트의 경우 작업공간을 생성하고 푸티지를 카탈로그화합니다(아래 명령어 참조). 선택하기 전에 움직이는 상태에서 후보 범위를 시청하세요. 카탈로그나 트랜스크립트는 시청이 아닙니다. 푸티지가 없는 경우 → shot-sizes-vertical-framing-and-coverage.md에서 숏 리스트를 작성합니다.
- 메시지. marketing-story-and-claims.md를 따릅니다. 제공된 사실, 승인된 클레임, 푸티지가 보여주는 내용, AI의 제안을 분리하여 유지합니다.
- 계획. social-platform-specs-length-and-pacing.md에서 포맷과 길이를 선택합니다. TikTok의 경우 tiktok-hooks-formats-and-trends.md도 읽고 세 가지 대체 훅을 제안합니다. 모든 계획은 텍스트 안전 영역, 사운드 끄기 시청을 위한 자막, 계정 유형에 따른 음악 라이선스(비즈니스 계정 및 광고는 일반적으로 라이선스 또는 상업용 라이브러리 음악으로 제한됨)를 명시합니다.
- 조립. editor-choice-and-integrations.md로 경로를 선택합니다. 헬퍼 내보내기 전에 내러티브
scene.json을 기술적 숏 계획으로 변환합니다(shot-plan-json-format.md 참조). - 검사. 모든 새 내보내기에 대해 export-checks-and-evidence.md를 실행합니다. 검사 실패 시 수정하고 새 버전을 내보낸 후 다시 검사합니다. 통과했다고 주장하는 대신 검사되지 않은 항목을 보고합니다.
- 피드백. feedback-review-and-project-memory.md 및 revision-preservation-rules.md에 따라 노트를 적용합니다: 먼저 버전을 저장하고, 요청된 범위만 변경한 후 나머지를 비교합니다.
- 전달. 편집 가능한 프로젝트, 명확하게 레이블이 지정된 검토용 내보내기, 남은 제한 사항 및 업데이트된
STATUS.md를 전달합니다.
읽을 참조 문서
현재 단계에 필요한 것만 읽습니다. 각 파일은 독립적입니다.
명령어
스킬 디렉토리(이 파일이 있는 폴더)에서 실행하며, 사용자 파일에는 절대 경로를 전달합니다. 스크립트는 Python 표준 라이브러리만 사용하며 기존 출력물을 덮어쓰지 않습니다.
| 목적 | 실행 |
|---|---|
작업에 필요한 도구 확인 (plan, catalog, preview, measure, resolve) | python3 scripts/workspace_setup_catalog_and_measure.py doctor --task plan |
| 템플릿에서 새 작업공간 생성 | python3 scripts/workspace_setup_catalog_and_measure.py init /path/to/workspace |
| 푸티지 카탈로그 작성 (해시 + ffprobe 메타데이터) | python3 scripts/workspace_setup_catalog_and_measure.py catalog /path/to/footage --output /path/to/workspace/catalog.json |
| 내보내기 측정 (디코드, 검은화면/프리즈, 음량) | python3 scripts/workspace_setup_catalog_and_measure.py measure /path/to/export.mp4 --output /path/to/workspace/checks.json |
| 숏 계획에서 무음 MP4 프리뷰 | python3 scripts/render_silent_preview_mp4.py shot-plan-v1.json --media-root /path/to/media --output /path/to/preview-v1.mp4 |
| 숏 계획에서 Resolve용 FCP 7 XML | python3 scripts/shot_plan_to_fcp7_xml.py shot-plan-v1.json --media-root /path/to/media --output /path/to/v1.xml |
| Resolve: 읽기 전용 프로브 / 보호된 가져오기 | python3 scripts/davinci_resolve_safe_import.py probe · … import-xml FILE.xml --project 'Exact Empty Project' |
| 설치 확인 | python3 scripts/verify_skill_installation.py |
종료 코드 2는 "완료되었으나 주의 필요"(도구 누락, 빈 또는 부분적 카탈로그)를 의미합니다. 출력을 읽고 성공으로 처리하지 마세요. scripts/shot_plan_validation.py는 명령어가 아닌 공유 모듈입니다.
환경
- Claude Code / 로컬 에이전트: 전체 워크플로우. 헬퍼가 로컬에서 실행되며, FFmpeg, Resolve 및 Final Cut이 설치되어 있으면 작동합니다. 렌더링 또는 가져오기를 약속하기 전에
doctor로 확인하세요. - claude.ai: 계획, 스크립트, 브리프, 숏 리스트, 카피 및 체크리스트는 모든 곳에서 작동합니다. 헬퍼 스크립트는 코드 실행 환경에서만 실행되며, FFmpeg가 없을 수 있고 네트워크 접근은 설정에 따라 다릅니다. 네이티브 편집기(Resolve, Final Cut, CapCut)에는 접근할 수 없으므로 수동 조립 계획을 전달하세요.
항상 적용되는 규칙
- 클레임: 가격, 지불 계획, 인도일, 수익률, 가용성, 사용후기 및 법적 텍스트는 승인된 출처에서만 가져옵니다. 시각적 자료 또는 초안 카피는 승인이 아니며, 허위 클레임은 사용자에게 법적 책임을 초래할 수 있습니다.
- 숏폼 제안: TikTok, Reels 또는 Shorts에 대한 모든 개념 또는 계획(첫 답변의 임시 제안 포함)은 텍스트 안전 영역, 사운드 끄기 시청을 위한 자막, 계정 유형에 따른 음악 라이선스를 명시합니다. 이는 소셜 비디오 검토 실패의 가장 흔한 원인입니다.
- 검사에 대한 정직함: 측정, 시청, 청취 또는 사용자가 승인한 내용을 정확히 말합니다. 명령어 성공은 승인이 아닙니다.
- 작업 안전: 소스, 작업공간 또는 이전 버전을 절대 덮어쓰지 않으며, 모든 변경 전에 새 버전을 저장합니다.
- 권한: 미디어 업로드, 비용 지출 또는 계정 게시는 사용자가 해당 특정 작업을 명시적으로 요청한 후에만 수행합니다.
- 데이터 위치: 프로젝트 파일은 사용자의 작업공간(
BRIEF.md,STATUS.md,scene.json,feedback.json,preferences.json)에 저장되며, 절대 스킬 폴더 내부에 저장되지 않습니다.