Communitygithub.com

lhaovo/short-video-skills

已定稿的分镜表를 直接 실행 가능한 두 개의 목록(에셋 목록과 생성 목록)으로 번역합니다.

short-video-skills란 무엇인가요?

이 스킬은 `lhaovo/short-video-skills`로, 단편 영상 제작 과정에서 정리된 스토리보드(分鏡表)를 AI 영상 생성 모델(예: Seedance)이 바로 실행할 수 있는 두 가지 작업 목록으로 변환하는 역할을 합니다. 첫 번째는 **에셋 목록**으로, 각 장면에 필요한 이미지와 그 이미지 생성을 위한 프롬프트를 정의합니다. 두 번째는 **생성 목록**으로, 각 비디오 클립의 길이, 생성 모드, 참조 에셋, 비디오 프롬프트를 명세합니다. 이 스킬은 창작(아이디어, 대본, 내용 평가)과 실제 생성(이미지/비디오 출력) 사이의 번역 계층 역할을 하며, 콘텐츠를 재구성하거나 직접 생성하지 않고 실행 가능한 지시사항을 제공합니다. Claude Code, Cursor 등 AI 어시스턴트가 스토리보드를 분석하여 일관된 에셋, 정확한 비디오 프롬프트, 신뢰성 검사가 포함된 자세한 생성 목록을 생성하도록 안내하는 8단계 프로세스(표 읽기 → 시각화 → 에셋 추출 → 세그먼트 분할 → 첫 프레임 결정 → 프롬프트 작성 → 목록 출력 → 자체 검사)를 따릅니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lhaovo/short-video-skills/tree/HEAD/short-video-prompt

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

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

문서

비디오 프롬프트 데스크

사람이 보는 스토리보드와 실행 가능한 생성 목록 사이에는 한 겹의 번역이 필요합니다. 이 스킬이 그 번역을 수행합니다.

두 개의 파일을 생성합니다: 에셋 목록(준비해야 할 이미지)과 생성 목록(각 세그먼트 생성 방법).

이 스킬은 주제를 재선정하지 않고, 대본 구조를 변경하지 않으며, 콘텐츠의 품질을 판단하지 않습니다——이는 상위 단계의 작업입니다. 또한 직접 이미지나 비디오를 생성하지 않고, 바로 실행 가능한 지시사항만 제공합니다.


1. 다섯 가지 불변 규칙

가장 먼저 명시합니다. 각 규칙은 특정 유형의 실패와 연결됩니다.

  1. 에셋 우선. 번호 없이 프롬프트를 작성하지 마십시오. 동일한 제품이 세그먼트 3에서 다른 제품으로 바뀌는 근본 원인은 거의 항상 에셋이 정의되지 않았기 때문입니다.
  2. 하나의 비디오 프롬프트는 하나의 연속적인 순간만 설명합니다. 장면이 변경되면 세그먼트를 나누십시오. 모델이 스스로 전환하게 하지 마십시오.
  3. 주체에는 anchor phrase를 문자 그대로 재사용하십시오. 동의어를 사용하는 것은 대상을 바꾸는 것과 같습니다.
  4. 제품 소스를 먼저 결정한 다음 프롬프트를 작성하십시오. 실사 촬영 또는 공식 에셋이 있으면 우선 사용; 없으면 AI 생성 가능하지만, 기하학, 인쇄, 로고는 고정해야 합니다. 파라미터 또는 효능을 주장하는 장면은 실사 촬영 또는 공식 에셋만 사용해야 합니다.
  5. 비디오 프롬프트는 긍정적으로 작성하고, 이미지 프롬프트에만 부정적 구문을 사용하십시오. 이 두 가지 문법은 서로 혼용할 수 없습니다. 자세한 내용은 references/prompt-syntax.md 8절을 참조하십시오.

2. 입력

필수

항목출처누락 시 처리
스토리보드기획안 4절, 6열 짧은 표 및 장면별 상세장면 번호, 시간 또는 주요 전환 필드 누락 시 거부, 추측하지 않음
제품 실명 및 사양기획안 1절없으면 질문, 확인 불가 시 '확인 필요'로 표시
대상 모델사용자 지정, 기본값 Seedance기본값 사용, 질문 불필요

짧은 표 6열: 장면 번호 / 길이(초) / 장면 설명 / 나레이션 / 화면 텍스트 / 장면 기능. 상세는 장면 번호별로 시청자 인지, 사전 의존성, 주요 가시적 사실, 길이 의도를 보충합니다.

선택 사항

  • 화면 비율(기본값 9:16), 비디오 해상도(기본값 480p, 생성 단계와 일치)
  • 단일 세그먼트 길이 상하한(기본값 5–10초)
  • 오디오 사용 여부(반드시 켜야 함. 내레이션은 모델이 직접 읽습니다. 끄면 소리가 없습니다. 빈 장면인 것이 확인된 경우에만 끕니다)

두 가지 진입점

진입점처리
표준 진입점기획안 4절을 읽고, 필드가 완전하면 바로 3단계로 이동
느슨한 진입점외부 markdown 표만 있을 경우, 먼저 파싱하고, 사용자에게 확인을 위해 표시, 누락된 필드 표시

느슨한 파싱의 경우 '이는 다운그레이드된 파싱입니다. 확인하십시오.'라고 명시적으로 알려야 합니다. 조용히 실패하는 것이 오류보다 더 문제를 일으킵니다.


3. 여덟 단계

1 표 읽기 → 2 시각화 → 3 에셋 추출 → 4 세그먼트 분할 → 5 첫 프레임 → 6 프롬프트 작성 → 7 목록 출력 → 8 자가 검사

1단계 · 표 읽기

짧은 표와 장면별 상세를 장면 번호로 연결하고, 제품 정보를 기억합니다. 이 단계는 검사만 수행하고 창작은 하지 않습니다. 기획 스킬이 설치되어 있으면 scripts/check_plan.py --plan <기획안 경로>를 실행; 독립 실행 시에는 입력 필드 목록을 기준으로 장면별로 확인합니다. 구식 5열 표에 전환 필드가 없으면 완성 후 진행합니다.

검사 세 가지:

  • 장면 번호 연속, 시간 양수
  • 각 장면 길이 2–6초(범위를 벗어난 것은 표시)
  • 스토리보드에 '이 장면이 설명하는 것'이 있고, 나레이션만 있는 것은 제외

2단계 · 시각화

이 단계는 전체 스킬에서 유일한 창작 단계이며, 가장 쉽게 건너뛰는 단계이기도 합니다.

스토리보드는 내용 설명('왜 겉은 뜨겁고 속은 차가운지 설명')을 제공하고, 프롬프트에는 화면이 필요합니다. 각 세그먼트는 다음 필드를 반드시 채워야 합니다:

항목질문예시
주체화면에 무엇이 있는가흰색 도시락, 열린 뚜껑
상태주체의 현재 상태뚜껑 열림, 도시락이 테이블 위에 있음
동작누가 무엇을 하는지, 하나의 동작숟가락이 중앙에서 찔러 들어감
환경어디인지, 주변에 무엇이 있는지책상, 배경에 전자레인지
조명빛의 방향, 색온도상부 따뜻한 흰색 빛, 왼쪽 창문 보조광
샷 크기화면의 범위클로즈업
카메라 위치/각도주체에 대한 카메라의 위치탁상 높이, 전방 30도 측면
카메라 움직임어떻게 움직이는지(하나만 선택)고정 샷, 천천히 줌인

필드는 하나도 빠짐없이 필수입니다. 각 세그먼트 목록은 주체, 상태, 동작, 환경, 조명, 샷 크기, 카메라 위치/각도 및 카메라 움직임을 명시적으로 작성해야 합니다. 명확히 해당되지 않는 경우 이유를 설명하십시오. 누락된 항목이 있으면 먼저 스스로 채우고, 채울 수 없으면 사용자에게 한 문장으로 질문하십시오——빈 채로 프롬프트에 넣지 마십시오. 빈 곳은 모델이 반드시 자체적으로 채웁니다.

스토리보드의 '주요 가시적 사실'과 '사전 의존성'은 생성 목록에서 그 위치를 명시해야 합니다: 첫 프레임의 가시적 상태인지, 비디오 세그먼트 내에서 발생하는 동작인지. 과정형 동작은 하나의 첫 프레임이 전, 중, 후를 동시에 표현하도록 요구할 수 없습니다.

3단계 · 에셋 추출

references/assets.md에 따라 네 가지 작업 수행: 번호 지정, 분할, 소스 결정, 총괄표 출력.

  • 번호 접두사: PR 제품 / SC 장면 / CH 인물 / SP 소품
  • 목록에 포함 기준: 두 개 이상의 세그먼트에서 참조되거나, 신원 일관성이 요구되는 경우
  • 소스 세 가지 등급: 실사 촬영 / 공식 에셋(있으면 사용), AI 생성(실사 없을 때 사용, 기하학 및 인쇄 고정), 추가 필요

4단계 · 세그먼트 분할

세 가지 제약 조건의 교집합 적용:

  1. 세그먼트 길이 ≥ 대사 글자 수 ÷ 4자/초(모델이 중국어를 약 4–5자/초로 읽음, 낮은 값 기준)
  2. 단일 세그먼트 5–10초(모델 상한은 prompt-syntax.md 참조)
  3. 하나의 동작당 하나의 세그먼트

조건 1에서 6.5 대신 4를 사용하는 이유가 있습니다: 모델이 대사 읽기를 빠르게 하지 않아서, 그냥 뒷부분을 생략합니다. 낙관적인 읽기 속도로 분할된 세그먼트를 생성하면 문장이 누락됩니다. 세그먼트를 더 많이 나누는 것보다 훨씬 처리하기 어렵습니다.

단일 세그먼트 대사 상한 36자. 초과 시 분할하고, 글자 수를 억지로 채우려 하지 마십시오.

초장 장면은 확장 + 전환 프레임 사용: 이전 세그먼트의 마지막 프레임이 어떤 화면 상태인지 명확히 작성하고, '이전 세그먼트에 이어서'라고 쓰지 마십시오.

5단계 · 첫 프레임

모든 세그먼트에 첫 프레임이 필요한 것은 아닙니다. 민감도에 따라 판단:

반드시 첫 프레임 필요텍스트-비디오 직접 가능
제품 클로즈업, 손에 쥐는 동작, 로고 또는 텍스트 노출빈 장면, 분위기, 전환, 순수 라이트 이펙트

첫 프레임 이미지는 이미지 프롬프트로 작성합니다 (assets.md 4절 7개 모듈 참조). 원칙은 '실제 제품을 기반으로 + AI가 장면 생성'입니다.

6단계 · 프롬프트 작성

references/prompt-syntax.md의 여섯 블록에 따라 작성:

[스타일 및 화면 비율] → [에셋 참조] → [주체 고정] → [타임라인] → [내레이션·사운드] → [품질 제약]

반드시 포함해야 할 네 가지: 단일 카메라 움직임, Motion: 목록, 대사 원문(대본 그대로, 단어 변경 금지), No subtitles.

다섯 번째 블록은 이제 내레이션 자체를 담당합니다——더 이상 별도의 음성 해설 녹음 단계가 없으며, 대사는 이 블록을 통해 모델에 전달됩니다. 스토리보드의 나레이션 열을 글자 그대로 가져오고, 어조 표시를 추가하지 않고, 괄호로 보충하지 않으며, 단어 하나도 변경하지 마십시오. 변경하면 자막과 소리가 맞지 않습니다.

7단계 · 목록 출력

두 개의 템플릿을 채우고, 상위에서 지정한 디렉토리에 저장합니다(기본값 02-에셋-목록.md, 03-생성-목록.md).

8단계 · 자가 검사

여섯 가지를 검사하고, 스크립트를 실행할 수 있으면 실행:

python scripts/check_gen_list.py --dir <제작 디렉토리>

종료 코드: 0 통과 / 2 치명적 항목 있음 / 3 파일 읽기 불가.


4. 두 가지 산출물

에셋 목록 (02-에셋-목록.md)

6열 표, 각 항목 뒤에 이미지 프롬프트 첨부:

번호유형용도소스참조 세그먼트상태
  • 유형: 제품 본체 / 제품 상세 / 장면 / 인물 / 소품
  • 소스: 실사 촬영 또는 공식 에셋 / AI 생성 / 추가 필요
  • 상태: 있음 / 이미지 생성 필요 / 촬영 필요

생성 목록 (03-생성-목록.md)

개요 표 + 세그먼트별 전체 프롬프트(프롬프트가 길면 표에 넣어 보기 어려움):

세그먼트 번호장면 번호길이모드참조 에셋첫 프레임후반 작업후보 수사전 의존성/주요 사실
  • 모드: 첫-마지막 프레임 / 참조 이미지 / 텍스트-비디오
  • 첫 프레임: S01_f01 또는 '없음'
  • 후보 수: 권장 2–4

모드의 세 가지 작성 방식은 하위 단계에서 선택할 수 있도록 제공하는 것이며, 모든 모델이 지원하지는 않습니다. 현재 KIE Seedance는 텍스트-비디오, 첫 프레임, 첫-마지막 프레임 세 가지 모드만 지원하며, 참조 이미지 모드는 첫 프레임으로 다운그레이드해야 합니다——다운그레이드 규칙은 short-video-generate에 있으며, 이 스킬은 그대로 작성하면 되고 모델에 맞춰 표현을 변경할 필요가 없습니다.

표 아래에는 ### S01 · 장면 1–2 | 8s | 첫-마지막 프레임 형식으로 각 세그먼트의 8개 화면 필드와 전체 프롬프트를 제공하고, 첫 프레임 소스, 사전 의존성 및 후반 작업을 첨부합니다.

템플릿은 assets/에 있습니다.


5. 자가 검사 아홉 가지

#검사 항목불통과 시 처리
1각 세그먼트에 장면 번호가 있고, 추가 세그먼트가 없음4단계로 돌아가 재분할
2각 세그먼트 길이 합과 스토리보드 총 길이 차이 ≤1초세그먼트 길이 조정, 스토리보드 변경 금지
3목록에서 참조하는 에셋 번호가 모두 에셋 목록에 정의됨정의 추가 또는 참조 삭제
4주 모드가 하나임: 첫-마지막 프레임과 참조 이미지 혼용 금지전체 영상 통일
5제품 장면 소스가 명시됨; 주장이 있는 장면은 실사 촬영 또는 공식 에셋 사용3단계로 돌아가 소스 변경
6각 비디오 프롬프트에 다음 포함: 단일 카메라 움직임, Motion:, No subtitles각각 보충
7대사가 있는 세그먼트의 내레이션 블록이 스토리보드 나레이션과 글자 단위로 일치세그먼트별로 비교, 한 글자라도 틀리면 수정
8화면 필드 완전F7은 세그먼트 내 '화면 필드' 표가 존재하고 필드가 완전하며 값이 있는지만 확인, 산문 키워드에서 추론하지 않음; 주체, 상태, 동작, 환경, 조명, 샷 크기, 카메라 위치/각도, 카메라 움직임, 의존성/가시적 사실 모두 작성해야 하며, 해당하지 않는 항목은 이유 설명
9의존성 전이됨스토리보드의 사전 의존성 및 주요 가시적 사실이 첫 프레임 또는 세그먼트 내 동작에 매핑됨

검사기 F8은 개요 표에서 각 세그먼트가 '사전 의존성/주요 사실'을 작성했는지만 확인하고, 내용이 실제로 첫 프레임이나 세그먼트 내 동작으로 표현되었는지는 증명하지 않습니다. G2는 여전히 수동으로 세그먼트별로 매핑을 확인해야 합니다.

4번 항목의 정확한 표현: 첫-마지막 프레임과 참조 이미지는 상호 배타적이며, 텍스트-비디오는 주체가 없는 장면에만 사용됩니다. 제품 장면에서 두 가지 주 모드를 혼용하면 결과물이 연결되지 않습니다.

7번 항목은 이번에 추가된 항목이며, 가장 쉽게 누락되는 항목이기도 합니다. 방법은 간단하지만 효과적입니다: 스토리보드의 나레이션 열과 목록의 내레이션 블록을 나란히 놓고, 글자 하나하나 비교하십시오. 구두점 하나를 바꾸거나 동의어 하나를 교체하면 자막도 함께 변경해야 하며, 자막은 S4 단계에서 처리됩니다——그때 발견하면 이미 늦습니다.

함께 확인할 두 가지: 각 세그먼트 대사가 36자를 초과하는지(초과하면 모델이 생략함), (웃음) '「흥분」'과 같은 어조 표시가 섞여 있는지(모델이 그대로 읽음).


6. 경계

  • 콘텐츠를 재구성하지 않음: 장면 번호, 순서, 길이는 상위에서 오며, 이 스킬은 구조를 변경하지 않음
  • 콘텐츠 품질을 판단하지 않음: 주제 선정, 훅, 구조의 타당성은 상위 단계에 속함
  • 직접 생성하지 않음: 목록과 프롬프트만 출력하고, 이미지는 short-video-assets, 비디오는 short-video-generate에 전달
  • 한 번에 성공을 보장하지 않음: 생성은 확률적이며, 이 스킬은 '시도할 가치가 있는 결과물'의 확률을 높일 뿐 보장하지 않음
  • 파라미터를 이전하지 않음: 모델 파라미터는 변경될 수 있으며, 스킬은 원칙과 일반적인 표현을 제공하고 구체적인 값은 공식 문서를 기준으로 함

7. 참고 자료

파일언제 읽는가
references/prompt-syntax.md비디오 프롬프트 작성 시; 카메라 움직임, 타임라인, 에셋 참조 조정 시
references/assets.md에셋 추출, 에셋 이미지 및 첫 프레임 이미지 프롬프트 작성 시
references/consistency.md여러 세그먼트 간 불일치, 제품 변형, 얼굴 불일치 시
references/troubleshooting.md특정 세그먼트가 반복적으로 생성되지 않을 때

템플릿: assets/asset-list-template.md, assets/gen-list-template.md 검증: scripts/check_gen_list.py

Individual skills in this repo

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

lhaovo/short-video-skills

为视频生成准备可用的图——把资产清单变成能直接喂给图生视频的素材:排生产顺序、定资产级别、出候选图、做一致性验收、按编号落盘、回写清单状态。支持三种来源:实拍、AI 生成、官方素材,不强制实拍。当用户说「准备素材」「出资产图」「首帧图」「角色三视图」「产品图跑一下」「资产对不上」「这条要哪些图」时使用。只管把图做出来并验收,不写分镜,不直接生成视频。

lhaovo/short-video-skills

一条短视频从策划到发布的流程总控:建制作目录、依次走「剧本分镜 → 提示词 → 生成 → 交付 → 发布」五段、每段设门禁、记录流程状态、支持跨会话续做。当用户要开一条新片子、问「下一步做什么」、想接着做某条没做完的片子、要把分镜变成提示词、要整理素材与成片、要准备发布包时使用。本技能只规定流程、目录与产物标准,不重复各环节的写作规范。

lhaovo/short-video-skills

把已过 G2 的生成清单落成真实视频片段——按段建 KIE Seedance 任务、轮询、下载、媒体体检、抽帧质检、听声核台词,并把每段的状态与请求指纹写进生成台账。三种模式互斥(文生 / 首帧图生 / 首尾帧图生)。旁白由模型直接念,台词照稿写进提示词,不走独立 TTS 配音。当用户提到视频生成、出片段、跑 Seedance、首帧图生、首尾帧、原生音频、台词念错、任务查询、片段下载、生成失败重试时使用。只管「把已定的画面和台词变成成段素材」,不重新设计视觉、不改台词文本、不做字幕、不做剪辑。

lhaovo/short-video-skills

把「我想拍点什么」变成一条想清楚的片子——先定主题(出 5 个候选、标明类型、给出推荐与淘汰理由),再定结构与分段剧本,最后切成镜头级内容分镜。支持两种入口:一句话主题(需要发散选题)与已有拆解剧本(跳过选题,先问复刻需求与复刻强度再判定改写)。当用户提到选题、定主题、短视频策划、写剧本、写大纲、分镜、镜头脚本、不知道拍什么、内容怎么排、科普干货、剧情软广、钩子怎么写、复刻别人的剧本时使用。只管内容层(讲什么、怎么讲),不碰执行层;内置的内容红线只防明显自伤,不替代合规审查。

관련 스킬