Communitygithub.com

Akira-TL/akira-video-skills

SHOTS.md의 샷 목록을 바로 제작 가능한 개별 샷 정의로 확장합니다. video/shots/<shot-id>/SHOT.md 생성 또는 수정, 샷 연속성, 촬영, 액션, 연기, 사운드 또는 샷별 제작 제약 조건이 필요할 때 사용합니다.

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

이 스킬은 비디오 생성 및 편집의 핵심 작업 단위인 개별 샷을 관리합니다. `video/shots/<shot-id>/SHOT.md` 파일을 소유하며, 모델 전용 프롬프트 컴파일이나 생성 결과 검토는 담당하지 않습니다. `SHOTS.md`에서 샷 목록을 확장하기 전에 `references/planning/COVERAGE.md`를 참조하여 설정 샷, 반응 샷, 인서트 샷, 제품 클로즈업 등의 필요성을 판단하고, 고정된 커버리지 세트를 기계적으로 적용하지 않습니다. 샷 ID는 `SC01_SH010`과 같은 빈칸 포함 번호를 기본으로 사용하며, 필요 시 가독성 있는 중간 번호를 삽입합니다. 복잡한 샷의 경우 `references/direction/DIRECTION.md`, `references/direction/CAMERA-LANGUAGE.md`, `references/direction/INTERACTION.md` 등의 참조 문서를 활용하여 촬영, 액션, 상호작용을 정의합니다. 연속성 관리를 위해 `references/continuity/CONTINUITY-HANDOFF.md`를 참조하며, 비용이 많이 드는 생성 전에 `references/planning/PREVIS.md`로 최소한의 사전 시각화를 수행할 수 있습니다. 주요 플랫폼은 Claude Code, Cursor, Codex 등의 AI 에이전트 환경이며, 개발자와 AI 에이전트 사용자가 비디오 제작 파이프라인에서 체계적이고 일관된 샷 관리를 할 수 있도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-shot

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

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

문서

비디오 샷

각 샷은 비디오 생성 및 편집의 핵심 작업 단위입니다. 이 Skill은 video/shots/<shot-id>/SHOT.md를 소유하며, 모델 전용 프롬프트 컴파일 또는 생성 결과 검토는 담당하지 않습니다.

SHOTS.md에서 샷 목록을 확장하기 전에, 씬에 몇 개의 관찰 지점이 필요한지, 설정 샷/반응 샷/인서트 샷/제품 클로즈업이 실제로 유용한지 references/planning/COVERAGE.md에 따라 판단합니다. 고정된 커버리지 세트를 기계적으로 적용하지 마십시오.

1. 샷 ID 및 디렉토리 설정

기본적으로 SC01_SH010, SC01_SH020과 같은 빈칸 포함 번호를 사용합니다. 씬이 없는 간단한 프로젝트는 SH010을 사용할 수 있습니다. 중간에 샷을 삽입해야 할 경우 가독성 있는 중간 번호를 사용하며, 기존의 모든 ID를 재정렬하지 않습니다.

복잡한 프로젝트는 평면 목록이 탐색에 불편할 경우에만 video/shots/ 내에 챕터 등 조직 디렉토리를 추가합니다.

샷에 복잡한 촬영, 액션, 월드 간 전환 또는 연속성이 포함된 경우 references/direction/DIRECTION.md를 읽습니다. 명확한 샷 크기, 초점 거리/원근, 카메라 위치, 줌/팬, 심도, 초점 또는 제품 촬영이 필요할 때만 references/direction/CAMERA-LANGUAGE.md를 읽고, 먼저 보이는 촬영 효과를 정의한 후 모델 어댑터가 구체적인 용어를 결정하도록 합니다. 여러 사람의 접촉, 물체 전달, 손 조작, 제품 사용, 복잡한 가림 또는 기계적 상호작용이 있을 때만 references/direction/INTERACTION.md를 읽고, 주요 동작 역할, 손, 접촉 지점 및 동작 전후 상태를 명확히 합니다. 여러 샷 프로젝트에서 비용이 많이 드는 생성 전에 순서, 대사, 총 런타임 또는 제품 가독성을 검증해야 할 경우 references/planning/PREVIS.md를 사용하여 스토리보드와 임시 사운드로 가벼운 동적 스토리보드(Animatic)를 만들 수 있으며, 모든 프로젝트에서 이를 요구하지는 않습니다. 샷이 이전 샷의 실제 출력을 기다려야 하는지, 어떤 샷을 병렬로 처리할 수 있는지, 계획된 출력/실제 출력 간의 핸드오프 방법은 references/continuity/CONTINUITY-HANDOFF.md를 따릅니다. 여러 캐릭터의 움직임, 제품/기계적 상호작용, 복잡한 카메라 경로, 첫/마지막 프레임 제어 또는 인접 샷 간의 공간 관계가 공식 생성 전에 여전히 큰 불확실성을 가질 때만 references/planning/PREVIS.md를 읽고 최소한의 필요한 사전 시각화/스토리보드를 수행합니다.

2. SHOT.md 작성

복잡하거나 외부 생성을 위해 전달해야 하는 샷은 references/planning/SHOT-TEMPLATE.md에 따라 직접 작성할 수 있습니다. 간단한 샷은 실제로 필요한 필드만 유지합니다. VIDEO.md가 여러 화면 비율 버전을 명시적으로 요구할 때만 references/planning/MULTI-FORMAT.md를 읽고, 주 버전에서 크롭 가능한지 아니면 독립적인 구도/생성이 필요한지 판단합니다.

SHOT.md는 현재 유효한 샷 디자인만 저장하며, 일반적으로 다음을 포함합니다:

  • 샷의 목적
  • 목표 런타임(현재 스크립트/총 시간 예산에서 가져오지만, 여전히 이 샷의 실제 액션과 대사를 따름)
  • 샷 크기, 카메라 위치, 카메라 움직임 및 필요한 초점 거리 정보
  • 주체의 위치, 동작, 연기 및 표정
  • 환경 및 주요 소품
  • 대사, 앰비언트 사운드 및 샷별 사운드
  • Continuity In / Continuity Out
  • 현재 참조가 필요한 재사용 자료
  • 하드 제약 조건
  • 모델 어댑터 레이어가 조정할 수 있는 생성 지침

모든 샷에 모든 필드가 필요한 것은 아닙니다. 간단한 샷은 간결하게 유지하십시오.

3. 연속성

연속성은 인접한 샷과 실제로 관련된 정보만 기록합니다. 예: 캐릭터 위치, 의복, 손에 든 물건, 소품 상태, 빛 방향, 움직임 방향 및 이미 발생한 동작.

이전 샷의 실제 생성 결과에 허용 가능한 오차가 있는 경우, 다음 샷은 실제 보이는 상태에서 계속됩니다. 오차가 캐릭터 정체성, 제품의 실제 구조 또는 기타 Hard Constraint를 위반하는 경우, 해당 생성 결과는 연속성의 근거로 사용되어서는 안 됩니다.

4. 촬영 및 액션

카메라 움직임은 정보, 관계, 공간 또는 감정을 전달하기 위한 것이어야 하며, 단지 "영화 같은 느낌"을 위한 기계적인 움직임이 되어서는 안 됩니다. 비디오 모델의 액션 디자인은 초 단위의 시간 관계를 우선시하며, 후반 작업에서만 정밀하게 제어할 수 있는 프레임 수준의 제어를 모델 하드 제약 조건으로 작성하지 않습니다.

하나의 샷은 복잡한 내부 동작을 가질 수 있지만, 편집에서 왜 하나의 샷인지 명확히 설명할 수 있어야 합니다. 모델이 한 번의 생성으로 여러 컷을 포함할 때, 프로젝트는 여전히 최종 샷 의미론에 따라 구성되며, 모델의 능력 때문에 여러 샷을 영구적으로 하나의 객체로 합치지 않습니다.

동일한 샷의 크롭, 색보정, 사운드 교체, 다중 화면 비율 파생 및 실제 새로운 샷의 경계는 references/continuity/SHOT-DERIVATIVES.md를 따릅니다. 후반 작업 파생물은 샷 디렉토리의 원본 takeNN.mp4를 덮어쓸 수 없습니다.

5. 생성 전 확인

샷을 video-generation에 전달하기 전에 다음을 확인합니다:

  • 샷 목적이 명확함
  • 목표 런타임이 액션 수와 호환됨
  • 캐릭터/장면/제품 등 재사용이 필요한 디자인이 결정됨
  • Continuity In/Out이 인접 샷에 대해 충분히 명확함
  • 참조 자료의 역할이 명확함
  • 하드 제약 조건과 일반 선호도가 구분됨
  • 자막, 로고, 정확한 컷 포인트 등 명백히 후반 작업인 항목이 생성 하드 제약 조건으로 잘못 작성되지 않음

조건이 충족되지 않으면 먼저 SHOT.md 또는 상위 디자인을 수정하고, "일단 생성해보고 보자"는 방식으로 샷 디자인을 대체하지 마십시오.

6. 프롬프트 및 생성 결과 소유권

장기 프롬프트 버전과 생성 결과는 샷과 동일한 디렉토리에 위치합니다:

prompt_v01.md prompt_v02.md take01.mp4 take02.mp4

프롬프트의 구체적인 모델 컴파일 및 일회성 생성 패키지는 video-generation이 담당합니다. 생성 결과의 선택, 재생성 및 후반 작업 수정 판단은 video-review가 담당합니다.

완료 기준

SHOT.md는 생성 Skill이 감독의 의도를 다시 추측하지 않고 프롬프트를 컴파일할 수 있을 정도로 충분하며, 해당 샷이 무엇을 상속받아야 하고 종료 시 무엇을 남겨야 하는지 명확히 합니다.

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

관련 스킬