Communitygithub.com

Akira-TL/akira-video-skills

AI 이미지 또는 비디오 생성을 위해 즉시 사용 가능한 프롬프트와 일회성 생성 팩을 준비하고, 사용자가 생성 결과를 프로젝트에 가져온 후 아카이빙합니다. 공식 비디오 스크립트, 재사용素材 및 SHOT.md에서 콘텐츠를 컴파일하고, 참조素材를 선택하며, 반환 파일 이름을 약속하거나 임시 팩을 정리할 때 사용합니다.

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

이 스킬은 장기 프로젝트 콘텐츠(video/script/, video/materials/, video/shots/)를 AI 비디오 생성 엔진에 공급하기 위한 실행 가능한 입력으로 변환합니다. 사용자는 일회성 생성 팩을 통해 외부 도구에서 편리하게 작업할 수 있으며, 결과를 가져오면 자동으로 프로젝트의 올바른 디렉토리에 아카이빙됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 작동하며, GENERATION-STRATEGY.md, BATCHING.md, EDIT-EXTEND.md와 같은 참조 문서를 읽어 일괄 처리, 반복 편집 및 전략적 의사 결정을 지원합니다. 또한, 프롬프트 작성은 VIDEO-PROMPT.md 및 MODEL-ADAPTER-CONTRACT.md를 따르며, 사용자 정의 Python 스크립트(generation_pack.py)를 통해 파일 수명 주기를 관리하여 프롬프트, 참조 및 결과 파일의 일관성과 추적 가능성을 보장합니다. 이를 통해 복잡한 AI 비디오 생성 워크플로우를 체계적으로 관리하고, 반복적인 실수를 줄이며, 확장 가능한 파이프라인을 구축할 수 있습니다.

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

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

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

문서

Video Generation

본 Skill은 공식 프로젝트 콘텐츠를 실행 가능한 AI 생성 입력으로 변환합니다. 장기적인 소스는 여전히 video/script/, video/materials/ 및 video/shots/입니다. 일회성 생성 팩은 사용자가 외부에서 생성하기 쉽도록 하기 위한 파생물일 뿐입니다.

한 번의 생성으로 얼마나 많은 콘텐츠를 다루고 어떤 생성 방식을 사용할지 최종 결정하기 전에 references/planning/GENERATION-STRATEGY.md를 읽으십시오. 많은 양의素材/장면을 일괄 생성해야 하는 경우 references/planning/BATCHING.md를 읽으십시오. 먼저 고위험 대표 샘플로 기준을 검증하고, 안정화된 후에만 현재 병렬 가능한 배치를 확장하며, 고정된 배치 크기를 지정하지 않습니다. 기존 비디오가 대체로 정확하고 연속적인 연장 또는 생성적 부분 수정이 필요한 경우 references/transform/EDIT-EXTEND.md를 읽으십시오. 먼저 결정론적 후반 작업이나 새 장면 생성이 더 적합한지 판단하십시오.

1. 생성 대상 식별

생성 대상은 다음과 같습니다:

  • 여러 장면에서 재사용되는 인물, 장면, 소품, 제품 등의 이미지素材;
  • 특정 장면의 비디오;
  • 특정 장면 전용 첫 프레임, 마지막 프레임, 스토리보드 스케치/키프레임, 보충 이미지 또는 사운드;
  • 캐릭터의 장기 음성 참조 또는 전체 영화 레벨의 배경 음악/내레이션 초안.

먼저 공식 소속 콘텐츠를 로드하십시오. 재사용素材는 video-materials의 정의를 사용하고, 장면 비디오는 video-shot의 SHOT.md를 사용하십시오. 일회성 팩이나 오래된 채팅 기록에서 장기적인 사실을 재구성하지 마십시오.

2. 장기 프롬프트 작성

장면에 대한 일반 비디오 프롬프트를 작성하기 전에 references/prompting/VIDEO-PROMPT.md를 읽으십시오. 현재 프로젝트에 해당 모델 어댑터가 설치된 경우, 어댑터가 일반 장면 의도를 해당 모델의 최종 실행 프롬프트로 컴파일합니다. 모든 모델 어댑터는 references/prompting/MODEL-ADAPTER-CONTRACT.md를 통일적으로 준수하며, 구체적인 진입점/모델/모드, 현재 공식 기능 검증, 입력 매핑, 실행 설정 및 미지의 항목을 명확히 합니다. 동일한 장면에 대해 여러 모델을 병렬로 테스트해야 하는 경우 references/prompting/MODEL-COMPARISON.md를 읽고, 동일한 SHOT.md와 연속 생성 결과 번호를 유지하며, 모델별로 장면 디렉토리를 복사하지 마십시오.

재사용 가능한素材의 프롬프트는 해당 video/materials/ 디렉토리에 저장됩니다. 장면 프롬프트는 해당 장면 디렉토리에 저장되며, prompt_v01.md, prompt_v02.md 등과 같은 소수의 명확한 버전을 사용합니다.

프롬프트는 현재 생성 모델이 실제로 필요한 정보만 컴파일합니다. 내부 장면/素材 정의는 최종 모델 프롬프트보다 더 완전할 수 있습니다. 모델 기능, 필드, 지속 시간 및 참조 입력 제한은 현재 실제로 로드된 모델 어댑터 Skill 또는 공식 문서에 의해 결정되며, 본 Skill에서 하드코딩되지 않습니다. 모델/사용 진입점, 지속 시간, 종횡비, 사운드 온/오프 등 실행 설정과 장기 프로젝트 레코드 간의 경계는 references/prompting/EXECUTION-PARAMETERS.md를 따릅니다.

신뢰할 수 있는 모델별 규칙이 없는 경우, 일반적이고 명확하며 검증 가능한 화면 및 동작 설명을 유지하고 사용자에게 현재 일반 프롬프트를 사용 중임을 알리며, 특정 모델 기능을 위조하지 마십시오.

3. 참조素材 선택

최소 충분 참조 세트를 사용하십시오. 각 참조는 "이것이 무엇을 안정화하는지" 즉, 인물 ID, 의상, 장면, 제품 구조, 동작, 촬영 또는 기타 특정 역할을 설명할 수 있어야 합니다.

ID 충돌, 스타일 오염 또는 제품 구조 표류를 방지하기 위해 관련 없는 참조를 동일한 생성에 포함시키지 마십시오.

4. 일회성 생성 팩 정리

공식 패키징 전에 references/planning/GENERATION-PACK.md를 읽고, 이미지/사운드/비디오 팩의 종속성에 따라 배치, 반환 이름 지정, 최소 참조 세트, 가져오기 및 삭제 경계를 실행하십시오. 사용자에게 직접 전달해야 하는 경우 references/planning/PACK-TEMPLATES.md를 사용하여 자체 포함된 태스크 파일을 생성하십시오. 프로젝트 내 팩 초기화, 공식 파일 복사, 반환 디렉토리, 상태 확인, zip 및 안전한 정리는 본 Skill에 포함된 scripts/generation_pack.py를 우선 재사용하고, 각 프로젝트에 대해 임시 패키징 스크립트를 새로 작성하지 마십시오. 이 CLI는 파일 수명 주기만 처리하며, 프롬프트, 참조 책임 또는 검토 결론을 결정하지 않습니다.

프로젝트 .tmp/ 아래에 설명적인 디렉토리를 만드십시오. 팩은 기본적으로 간단하게 유지됩니다:

.tmp/<generation-pack>/
├── README.md
├── <prompt files>
└── materials/

이번 생성에 필요한 프롬프트와 참조素材만 복사하십시오. README에는 최소한 다음을 명확히 작성하십시오:

  • 이번 생성 목표;
  • 권장 생성 순서(종속성이 있는 경우);
  • 각 항목에 사용된 참조;
  • 반환 파일 이름;
  • 사용자가 특별히 확인해야 하는 하드 제약 조건.

이미지素材가 반환될 때는 해당 장기 파일 이름을 사용하십시오. 장면 비디오 반환 이름을 지정하기 전에 먼저 generation_pack.py next-take를 사용하여 해당 장면의 다음 사용되지 않은 단조 증가 takeNN을 조회하고, 수동으로 번호를 추측하거나 모델 전환으로 인해 take01부터 다시 시작하지 마십시오.

5. 결과 가져오기

사용자가 생성 결과를 가져온 후 먼저 파일 대응 관계를 확인한 다음, 공식 결과를 해당 소속 디렉토리에 배치하십시오:

  • 재사용素材 → video/materials/<category>/;
  • 장면 결과 → video/shots/<shot-id>/;
  • 장면 전용 사운드/이미지 → 동일한 장면 디렉토리.

video-review가 특정 반환 파일을 명시적으로 수락한 경우에만 generation_pack.py archive --confirm-reviewed를 사용하여 공식 소속 위치로 복사하십시오. 이 작업은 returns/의 원본 파일을 보존하고 SHA-256을 반환하며, 기존 공식 파일을 덮어쓰지 않습니다. 모든 공식 아카이빙을 완료하고 임시 팩에 고유한 정보가 더 이상 포함되지 않음을 확인한 후 cleanup을 사용하여 일회성 생성 팩을 삭제하십시오.

6. 반복 규율

생성이 실패하면 문제의 원인을 다음에서 판단하십시오:

  • 장기素材/ID 정의;
  • 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

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

Akira-TL/akira-video-skills

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

Akira-TL/akira-video-skills

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

Akira-TL/akira-video-skills

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

관련 스킬