Communitygithub.com

Akira-TL/akira-video-skills

소설, 챕터, 스토리 개요, 브랜드 브리프 또는 기타 상위 콘텐츠를 현재 비디오의 자체 스크립트 레이어로 변환합니다. SCRIPT.md, 비디오 캐릭터 연기 정의, 장면 정의, 대사 또는 샷 목록을 작성하거나 수정해야 할 때 사용합니다.

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

이 스킬은 주어진 상위 콘텐츠(소설, 챕터, 스토리 개요, 브랜드 브리프 등)를 현재 제작 중인 비디오에 특화된 스크립트 레이어로 변환하도록 설계된 AI 어시스턴트 가이드입니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 활용할 수 있으며, 상위 콘텐츠의 사실을 복사하지 않고 참조 포인터만 유지함으로써 데이터 중복과 불일치를 방지합니다. 이 스킬은 SCRIPT.md(스토리 및 대사), CHARACTERS.md(캐릭터 연기 및 목소리), SCENES.md(장소 및 세계관), SHOTS.md(샷 목록) 등 최소한의 스크립트 파일 세트를 생성하고, 프로젝트에 꼭 필요한 파일만 만들도록 안내합니다. 또한 인과 관계 중심의 스토리 전개, 자연스러운 대사 작성, 시간 예산 관리 등 고품질 비디오 제작을 위한 구체적인 지침을 제공하여, AI 에이전트가 사용자의 창작 의도를 정확히 반영한 비디오 스크립트를 효율적으로 제작할 수 있도록 돕습니다.

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

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

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

문서

Video Script

이 Skill은 video/script/에 있는 비디오화 제작 정의만을 소유합니다. 상위 소설, 세계관, 챕터, 완전한 캐릭터 파일, 고객 자료 또는 기타 출처는 계속 원래 권위 있는 출처에 남아 있습니다. 여기에는 현재 비디오가 연기, 장면 및 촬영 제작을 위해 수행한 변환 및 선택만 저장됩니다.

1. 상위 출처 및 VIDEO.md 읽기

먼저 VIDEO.md와 사용자가 지정한 상위 출처를 읽습니다. 출처가 소설, 챕터 또는 기타 장문의 내러티브인 경우 먼저 references/ADAPTATION.md를 읽습니다. 현재 비디오에 실제로 필요한 사실, 캐릭터 관계, 플롯, 장면, 제품 또는 제한 사항만 추출합니다. 포인터(pointer)는 유지하되, 완전한 상위 콘텐츠를 비디오 스크립트 레이어에 복사하지 마십시오.

출처 간에 충돌이 있거나 중요한 사실이 누락된 경우, 먼저 그 격차를 명확히 하십시오. 비디오 스크립트를 완성하기 위해 상위 사실을 임의로 보충하지 마십시오.

2. 최소 비디오 스크립트 레이어 구축

네 가지 일반적인 스크립트 파일의 역할은 references/SCRIPT-FILES.md에 따라 분리되어 유지됩니다. 시각 디자인, 촬영 및 생성 파라미터를 스크립트 레이어에 다시 복사하지 마십시오. 실제 파일을 생성할 때는 references/SCRIPT-TEMPLATES.md의 최소 템플릿을 사용하여 현재 프로젝트에 필요한 파일만 만듭니다.

현재 프로젝트에 필요한 파일만 만듭니다:

  • SCRIPT.md: 현재 비디오의 스토리, 구조, 장면, 액션 및 대사
  • CHARACTERS.md: 현재 비디오에서 캐릭터의 연기, 외형, 대사 및 음성 요구 사항
  • SCENES.md: 현재 비디오에서 사용되는 장면, 공간, 세계 표현 및 연속성 중요 사항
  • SHOTS.md: 전체 영상의 샷 개요

간단한 제품 샷, 캐릭터가 없는 비디오 또는 이미 완전한 스크립트가 있는 프로젝트는 위 파일 중 일부가 없을 수 있습니다. 템플릿을 완성하기 위해 빈 파일을 만들지 마십시오.

3. 스토리 및 캐릭터

현재 비디오에 완전한 스토리, 캐릭터 아크, 대사 또는 코미디 개그가 포함된 경우 먼저 references/NARRATIVE.md를 읽습니다. 캐릭터의 감정 변화, 중요한 반응 또는 관계 갈등이 실제로 샷 연기에 반영되어야 하는 경우 references/PERFORMANCE.md를 읽고 감정 단어를 관찰 가능한 신체, 시선, 동작 및 행동 비트로 변환합니다. 아래에는 모든 스토리 프로젝트에 필요한 최소 규칙만 유지됩니다.

스토리가 있는 경우 인과 관계 체인과 캐릭터 행동의 타당성을 먼저 보장하고, 그 다음에 시각적 경이로움을 추구하십시오:

  • 이벤트는 기존 조건, 캐릭터 선택 또는 이전 이벤트에 의해 추진됩니다.
  • 캐릭터는 현재 알려진 정보에만 기반하여 행동하고 말합니다.
  • 중요한 전환점은 캐릭터 선택 또는 이미 확립된 규칙에서 비롯됩니다.
  • 결말에 필요한 액션, 정보 또는 시각적 요소는 이전에 실제로 설정되어야 합니다.
  • 제품이나 소품은 이전에 등장하지 않은 문제를 갑자기 해결할 수 없습니다.

캐릭터 정의는 단순한 성격 레이블을 작성하는 것이 아닙니다. 현재 비디오에 실제로 필요한 경우 목표, 걱정, 일반적인 행동 방식, 긴장 시 반응, 대사 리듬, 음성 특징, 허용되는 감정 범위 및 이번 영화에서의 변화를 기록합니다. 캐릭터가 샷 전반에 걸쳐 음성 정체성을 유지해야 하는 경우 자세한 음색 및 음성 참조를 video-audio에 넘기고, 스크립트 레이어에 두 번째 음성 규칙을 복사하지 마십시오.

4. 대사

샷에 말하는 캐릭터, 긴 대사, 여러 캐릭터의 대화 또는 동기화된 입모양이 포함된 경우 references/DIALOGUE-TIMING.md를 읽고, 먼저 대사가 목표 시간 내에 자연스럽게 전달될 수 있는지 확인한 후 샷 생성을 진행합니다.

대사는 캐릭터의 현재 행동에 기여하며, 작가를 대신하여 세계관을 설명하는 역할을 하지 않습니다. 내레이션/해설도 스크립트 콘텐츠에 속하지만, 서술적 관점, 시간 압축 또는 화면으로 자연스럽게 표현하기 어려운 정보가 실제로 필요한 경우에만 사용합니다. 오디오 제작은 필요에 따라 video-audio에 넘기고, 내레이션을 불명확한 스토리를 수정하는 만능 설명 레이어로 사용하지 마십시오. 이전 문장, 이전 동작 또는 새 정보가 자연스럽게 다음 문장으로 이어지도록 우선시하십시오. 동작으로 표현할 수 있는 정보를 대사로 반복해서 설명하지 마십시오.

대사 작성을 완료한 후 연속적인 시간 순서로 전체 대화를 빠르게 검토하여 갑작스러운 주제 전환, 반복 설명, 감정 전환 없음, 모든 캐릭터가 동일한 문장 구조를 사용하는 등의 문제를 확인하십시오. 자연스러운 대사가 인터넷 속어를 강제로 포함시키는 것을 의미하지는 않습니다.

VIDEO.md에 명확한 총 시간 / 엄격한 상한선이 있는 경우 references/DURATION-BUDGET.md를 읽고, 먼저 스토리 단락과 SHOTS.md를 기반으로 대략적인 시간 예산을 책정하여 생성 완료 후 전체 영상 길이가 통제 불능이 되는 것을 방지합니다.

5. 장면 및 샷 개요

SCENES.md는 현재 비디오에 필요한 공간, 시각 및 세계 규칙만 기록합니다. 복잡한 기계, 낯선 장치 또는 중요한 공간 관계에 대한 자세한 설명은 해당 재사용 자료 옆의 설명 파일에 넣고, 모든 저빈도 규칙을 SCENES.md에 쌓아두지 마십시오.

SHOTS.md는 처음부터 끝까지 전체 영상의 샷 구성을 빠르게 읽는 데 사용됩니다. 각 항목에는 최소한 샷 ID, 목표 시간, 화면/동작 및 샷 목적이 포함되어야 합니다. 자세한 제작 요구 사항은 video-shot의 SHOT.md에 전달합니다.

긴 프로젝트의 경우 기존 샷 목록을 읽기 어려울 때만 챕터나 더 높은 수준의 조직을 추가하며, 영화 수준의 계층 구조를 미리 가정하지 마십시오.

완료 기준

비디오 스크립트 레이어는 다음 단계에서 이 비디오가 무엇에 관한 것인지, 캐릭터가 어떻게 연기해야 하는지, 장면이 어떻게 제시되어야 하는지, 어떤 샷이 필요한지 명확히 알 수 있도록 해야 합니다. 동시에 상위 출처를 두 번째 사실 데이터베이스로 복사하지 않아야 합니다.

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

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

관련 스킬