npx claudepluginhub anomie7/toon-generatorInstagram toon generation pipeline plugin. Supports content preparation (toon-prep), image generation (toon-gen), and reels conversion (toon-reels) with dedicated sub-agents (story-writer, reference-explorer, interviewer, doc-generator).

인스타툰 제작의 전체 파이프라인을 자동화하는 Claude Code 플러그인
참고: 아래 GIF는 미리보기용으로 화질이 낮습니다. 실제 결과물은 MP4(고화질) 로 출력됩니다.
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에서 마켓플레이스 추가 후 설치
/plugin marketplace add anomie7/toon-generator
/plugin install toon-generator
설치 후 Claude Code가 자동으로 4개 스킬과 5개 에이전트를 인식합니다.
스크립트 실행 시 zod, @google/genai 패키지가 필요하며, 없으면 Claude Code가 자동으로 설치를 안내합니다.
GEMINI_API_KEY: Google AI Studio에서 발급받을 수 있습니다
export GEMINI_API_KEY="your-key-here"
Node.js >= 18
ffmpeg (toon-reels 사용 시):
brew install ffmpeg # macOS
# 인터뷰부터 시작 (전체 파이프라인)
/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 # 콘티
# EP1 전체 생성
/toon-slide --episode 1
# 특정 슬라이드만
/toon-slide --episode 3 --slide 2
# 프로덕션 모델로 생성
/toon-slide --episode 1 --model gemini-3-pro-image-preview
# 기본 (4:5, 3초/슬라이드)
/toon-reels output/EP1
# BGM 포함
/toon-reels output/EP1 --bgm content/audio/EP1/bgm.mp3
# 릴스용 세로 비율 + 페이드 전환
/toon-reels output/EP1 --ratio 9:16 --fade 0.5
# 전체 파이프라인 (인터뷰 -> 이미지 생성 -> 릴스)
/toon-run
# 콘텐츠 준비 건너뛰고 EP1만 생성
/toon-run --skip-prep --episode 1
# 프로덕션 모델로 생성 (릴스 제외)
/toon-run --model gemini-3-pro-image-preview --skip-reels
toon-slide는 슬라이드의 텍스트 유무에 따라 모델을 자동 선택합니다:
| 조건 | 모델 | 이유 |
|---|---|---|
| 한글 텍스트 있음 | gemini-3-pro-image-preview (Pro) | 한글 렌더링 정확도 우수 |
| 텍스트 없음 | gemini-3.1-flash-image-preview (Flash) | 빠르고 저렴 |
--model로 고정 지정하면 자동 선택을 무시합니다.
toon-generator/
.claude-plugin/
plugin.json # 플러그인 메니페스트
agents/ # 서브에이전트 (자동 발견)
story-writer.md # 이미지 프롬프트 생성
reference-explorer.md # 참고 이미지 탐색/추천
interviewer.md # AI 인터뷰
doc-generator.md # 문서 자동 생성
doc-inspector.md # 문서 품질 검수
skills/ # 스킬 (자동 발견)
toon-run/
SKILL.md # 전체 파이프라인 오케스트레이터
toon-prep/
SKILL.md
scripts/
generate-refs.ts # 참고 이미지 생성 (Gemini API)
templates/ # 문서 템플릿 (9종)
toon-slide/
SKILL.md
scripts/
pipeline-slide.ts # 슬라이드 파이프라인 (검수 -> 생성)
generate.ts # 이미지 생성 (Gemini API)
inspect.ts # 이미지 품질 검증 (Gemini API)
lib/
config.ts # 설정 + 모델 레지스트리
types.ts # 타입 정의 (Zod 스키마)
image-utils.ts # 이미지 유틸리티