zenstory-ai/drama-skills

개요

Drama Skills는 에이전트 호환 "스킬" 의 오픈 소스 컬렉션으로, 작가(또는 소규모 스튜디오)가 스토리 아이디어나 장편 소설을 AI를 사용하여 완성된 단편 드라마 비디오로 전환할 수 있게 합니다. 파이프라인은 소설 분석, 대본 작성, 자산 추출, 이미지 프롬프트 생성, 스토리보드 생성, 비디오 프롬프트 작성, 제작, 편집, 최종 검토의 11개 명확히 정의된 단계로 나뉘며, 각 단계는 별도의 명령어(예: $short‑drama‑write, $short‑drama‑image‑prompts)로 노출됩니다. 명령어는 Claude Code 또는 Codex와 같은 프로그래밍 에이전트 환경 내에서 실행되며, 창의적인 작업에는 에이전트를 구동하는 동일한 LLM을 사용합니다.

작동 방식

1. 설치 – 스킬은 ClawHub(또는 수동 심볼릭 링크)를 통해 배포됩니다. 단일 npx skills add zenstory-ai/drama-skills -g 명령으로 11개 스킬 모두를 전역적으로 사용할 수 있습니다. Python 3.9+ 및 ffmpeg가 유일한 런타임 종속성입니다.
2. 프로젝트 구조 – 각 에피소드는 Markdown 파일 세트(剧本.md, 视觉设定.md, 分镜.md, 图片提示词.md, 视频提示词.md, 선택적 剪辑单.md)로 표현됩니다. 이 파일들이 단일 진실 소스이며, 시스템은 별도의 데이터베이스를 사용하지 않습니다.
3. 스킬 흐름 –
   • short‑drama‑novel‑analyze는 원본 소설을 샘플링하고 각색할 가치가 있는지 결정합니다.
   • short‑drama‑develop는 긴 작품을 에피소드 수준 맵으로 분할합니다.
   • short‑drama‑write는 에피소드 대본을 생성합니다.
   • short‑drama‑assets는 캐릭터, 장소, 소품, 연속성 잠금을 추출합니다.
   • short‑drama‑image‑prompts는 이미지 생성 모델용 프롬프트 문자열을 작성합니다.
   • short‑drama‑storyboard는 카메라 이동과 "고정 키프레임"을 포함한 샷 목록을 생성합니다.
   • short‑drama‑video‑prompts는 각 샷을 비디오 생성 프롬프트(타이밍, 대화, 참조 이미지 포함)로 변환합니다.
   • short‑drama‑produce는 모든 미디어 작업의 미리보기를 표시합니다. 사용자의 명시적 확인 후 외부 어댑터(예: MiniMax H3, Seedance)를 호출하여 이미지, 비디오, TTS 또는 음악을 생성합니다.
   • short‑drama‑edit는 ffmpeg를 사용하여 생성된 자산을 최종 비디오로 조합하고 상세한 편집 결정 로그를 작성합니다.
   • short‑drama‑review는 최종 일관성 및 권리 검사를 실행합니다.
4. 검증 – 도우미 스크립트(creator_markdown_check.py)는 5개의 Markdown 파일을 교차 검사하여 누락된 참조나 시간 불일치를 감지하고, 중단하는 대신 사람이 읽을 수 있는 오류를 보고합니다.
5. 대시보드 – 가벼운 로컬 UI(/short‑drama dashboard)가 에피소드의 타임라인, 샷 색상, 진행 상황을 시각화합니다.

대상 사용자

• 시나리오 작가 및 만화 드라마 스튜디오로, 짧은 세로 형식 비디오(예: TikTok/YouTube Shorts)를 프로토타입하거나 완전히 제작하려는 경우.
• 이미 AI 에이전트를 사용하는 창의적인 팀 (Claude Code, Codex 또는 Agent‑Skill 사양을 지원하는 모든 환경).
• 재현 가능하고 파일 기반 워크플로우가 필요한 모든 사람. 모든 창의적 결정이 일반 Markdown으로 캡처됩니다.

즉시 사용 가능한 기능

• 단편 드라마 파이프라인 전체를 다루는 11개의 즉시 사용 가능한 스킬.
• 전체 Markdown 파일 세트와 결과 비디오를 보여주는 예제 프로젝트(예: 讓你管帳號의 EP001).
• 자동 일관성 검사 및 비용이 많이 드는 미디어 생성을 위한 명확한 "확인 후 지출" 게이트.
• 모든 에피소드 자산과 문서를 패키징하여 전달하기 위한 내보내기 도구.

간단한 시작 방법

# 스킬 세트 설치 (전역)
npx skills add zenstory-ai/drama-skills -g
# 새로운 세로 형식 단편 드라마 프로젝트 초기화
$short-drama init "都市打脸" --ratio 9:16
# 첫 번째 에피소드 대본 작성
$short-drama-write "第 1 集：外卖员在高档餐厅被经理羞辱…"
# 자산 추출, 이미지 프롬프트, 스토리보드, 비디오 프롬프트 생성
$short-drama-assets …
$short-drama-image-prompts …
$short-drama-storyboard …
$short-drama-video-prompts …
# 미리보기 및 생성 확인
$short-drama-produce
# 생성된 클립을 최종 비디오로 편집
$short-drama-edit
# 최종 검토 실행
$short-drama-review

모든 단계는 해당 Markdown 파일을 생성하거나 업데이트하며, 다음 단계를 확인하기 전에 수동으로 편집할 수 있습니다.

---

요점: Drama Skills는 스토리 아이디어를 완성된 단편 드라마 비디오로 전환하는 구체적이고 에이전트 기반 툴킷으로, 모든 창의적 산출물을 사람이 읽을 수 있는 Markdown으로 저장하고 AI 생성 미디어 비용을 제어할 수 있는 안전 검사를 제공합니다.