toon-generator
인스타툰 제작의 전체 파이프라인을 자동화하는 Claude Code 플러그인
English
Demo (결과물 미리보기)
참고: 아래 GIF는 미리보기용으로 화질이 낮습니다. 실제 결과물은 MP4(고화질) 로 출력됩니다.
일상툰 (모노크롬 라인아트)
병원 의학지식 홍보툰
병원 홍보툰 (공감형 콘텐츠)
이런 걸 할 수 있어요
- 아이디어만 있으면 AI가 질문하며 기획을 잡아줍니다 (캐릭터, 스토리, 아트 스타일)
- 기획을 바탕으로 에피소드별 웹툰 이미지를 자동 생성합니다
- 생성된 이미지를 인스타그램 릴스 영상으로 변환합니다
toon-prep toon-slide toon-reels
(기획 준비) --> (이미지 생성) --> (릴스 영상)
AI 인터뷰 레퍼런스 탐색 슬라이드 조합
| | |
문서 자동 생성 품질 검수 BGM 합성
| | |
참고 이미지 생성 Gemini로 그리기 MP4 출력
또는 /toon-run 으로 전체 파이프라인을 한 번에 실행
포함된 스킬 & 에이전트
| 스킬 | 한 줄 설명 |
|---|
| toon-run | 전체 파이프라인 오케스트레이터 (prep -> slide -> reels) |
| toon-prep | AI 인터뷰로 기획 수집 -> 문서 자동 생성 -> 품질 검수 -> 참고 이미지 생성 |
| toon-slide | 참고 이미지 탐색 -> 품질 검수 -> Gemini API로 슬라이드 이미지 생성 |
| toon-reels | 슬라이드 이미지 -> 페이드 전환 + BGM -> 인스타 릴스 MP4 |
| 에이전트 | 소속 스킬 | 역할 |
|---|
| story-writer | toon-slide | 콘티/에피소드 설계 기반 이미지 프롬프트 JSON 생성 |
| reference-explorer | toon-slide | 슬라이드별 참고 이미지 탐색/추천 |
| interviewer | toon-prep | 소크라테스식 인터뷰로 기획 정보 수집 |
| doc-generator | toon-prep | 인터뷰 결과 기반 콘텐츠 문서 자동 생성 |
| doc-inspector | toon-prep | 생성된 문서 품질 검수 (90점 이상 통과) |
설치
Claude Code
# Claude Code에서 마켓플레이스 추가 후 설치
/plugin marketplace add anomie7/toon-generator
/plugin install toon-generator
설치 후 Claude Code가 자동으로 4개 스킬과 5개 에이전트를 인식합니다.
스크립트 실행 시 zod, @google/genai 패키지가 필요하며, 없으면 Claude Code가 자동으로 설치를 안내합니다.
Codex
이 저장소의 원본은 Claude Code 플러그인 구조입니다. Codex에서는 npm run convert:codex로 self-contained Codex wrapper 플러그인을 생성한 뒤, 프로젝트의 로컬 marketplace에 등록해서 사용합니다.
빈 프로젝트에 추가하는 예시는 다음과 같습니다:
# 1) 작업할 빈 프로젝트 생성
mkdir my-toon-project
cd my-toon-project
# 2) toon-generator 소스 클론
mkdir -p .vendor
git clone https://github.com/anomie7/toon-generator.git .vendor/toon-generator
# 3) 의존성 설치
cd .vendor/toon-generator
npm install
# 4) 현재 빈 프로젝트 루트에 Codex 플러그인과 marketplace 생성
npm run convert:codex -- --output-root ../.. --force
# 5) 생성된 Codex runtime 의존성 설치
cd ../../plugins/toon-generator/runtime
npm install
위 명령을 실행하면 빈 프로젝트 루트에 아래 파일들이 생성됩니다:
my-toon-project/
.agents/
plugins/
marketplace.json
plugins/
toon-generator/
.codex-plugin/
plugin.json
skills/
toon-prep/SKILL.md
toon-slide/SKILL.md
toon-reels/SKILL.md
toon-run/SKILL.md
runtime/
package.json
skills/
agents/
Codex는 .agents/plugins/marketplace.json을 읽고 ./plugins/toon-generator를 로컬 플러그인으로 인식합니다. 프로젝트를 Codex에서 다시 열거나 reload하면 Toon Generator 플러그인과 toon-prep, toon-slide, toon-reels, toon-run 스킬을 사용할 수 있습니다.
생성된 Codex 플러그인은 plugins/toon-generator/runtime 안에 실행 스크립트와 템플릿을 함께 포함합니다. 따라서 변환과 runtime 의존성 설치가 끝난 뒤에는 .vendor/toon-generator 원본 checkout을 삭제해도 됩니다. 다른 머신에서 프로젝트를 다시 클론했다면, 해당 환경에서 위 변환 명령과 runtime npm install을 한 번 더 실행하는 것을 권장합니다.
모든 프로젝트에서 공통으로 쓰고 싶다면 home-local marketplace에 설치할 수도 있습니다:
git clone https://github.com/anomie7/toon-generator.git ~/Dev/toon-generator
cd ~/Dev/toon-generator
npm install
npm run convert:codex -- --output-root "$HOME" --force
cd ~/plugins/toon-generator/runtime
npm install
이 경우 ~/plugins/toon-generator와 ~/.agents/plugins/marketplace.json이 생성됩니다.
사전 조건
-
GEMINI_API_KEY: Google AI Studio에서 발급받을 수 있습니다
export GEMINI_API_KEY="your-key-here"
-
OPENAI_API_KEY (선택): gpt-image-2로 이미지를 생성할 때 필요합니다
export OPENAI_API_KEY="your-key-here"
-
Node.js >= 18
-
ffmpeg (toon-reels 사용 시):
brew install ffmpeg # macOS
사용법
1단계: 콘텐츠 준비 (toon-prep)
# 인터뷰부터 시작 (전체 파이프라인)
/toon-prep --content-dir ./content
# 이미 기획이 있으면 문서 생성부터
/toon-prep --content-dir ./content --skip-interview
# 레퍼런스 이미지만 생성
/toon-prep --content-dir ./content --skip-interview --skip-docs
toon-prep이 완료되면 다음이 생성됩니다:
content/
interview-result.json # 인터뷰 결과
character-sheet.md # 캐릭터 시트
character-concept.md # 인물 컨셉
visual/
art-direction.md # 아트 디렉션
character-sheet-detailed.md # 상세 캐릭터 시트
references/ # 레퍼런스 이미지 (7종)
episode-design/EP1.md # 에피소드 설계
conti/EP1.md # 콘티
2단계: 이미지 생성 (toon-slide)
