| name | imagine-thumb |
| description | YouTube 썸네일 전용 생성기. 배경/인물 일러스트는 Codex 이미지 모델로 뽑고, 제목 텍스트는 **AI가 아니라 Node 후처리**(`scripts/lib/compose-text.js`)로 합성한다. 한국어 글자 깨짐을 원천 차단한다. 사용자가 "썸네일 만들어줘", "imagine-thumb <제목>", "유튜브 썸네일" 등을 말하면 이 스킬이 담당한다. 기본 A/B용 2장을 같은 제목 텍스트로 합성해 저장한다. |
| argument-hint | --title <text> [--style vlog|tech|reaction|meme|cinematic] [--subject-side left|right] [--vibe shock|calm|cozy|hype] [--n 2|3] [--subtitle <text>] |
imagine-thumb
YouTube 업로드용 1280×720 JPEG 썸네일을 30초 안에 뽑는다. AI에게 글자를 맡기지 않는 것이 이 스킬의 핵심 계약이다.
트리거
imagine-thumb <제목> / imagine-thumb --title "..." (명시 호출)- "썸네일 만들어줘"
- "유튜브 썸네일"
- "YouTube thumbnail for <제목>"
파이프라인
- 배경 생성:
imagine 스킬의 Phase 1 공용 모듈(Request Planner / Output Allocator / OAuth Session)로 Codex 이미지 모델 호출. size: 1536x1024 (3:2) 로 뽑아 1280×720으로 크롭한다.
- 프롬프트 가공:
--title 값은 모델 프롬프트에 포함하지 않는다. --style/--vibe로 배경·조명·구도만 지시하고, negative prompt에 text, watermark, logo, blurry, deformed hands, asymmetric eyes를 강제 포함.
- 텍스트 합성:
scripts/lib/compose-text.js의 compositeText(bgPath, textOptions, outPath)로 SVG→sharp composite. 세이프존(좌/우 45%)과 배경 명도 자동 측정(어두우면 흰색, 밝으면 검정).
- A/B variant: 기본
n=2. 같은 제목 텍스트를 각 배경에 합성해 _final_v1.jpg / _final_v2.jpg 두 벌 저장. --n 3이면 3벌.
- 모바일 프리뷰: 최종본을 640×360으로도 리사이즈해 동반 저장(규격 가독성 점검용).
에이전트·하위 LLM은 서로를 직접 호출하지 않는다. 모든 단계는 이 스킬의 entrypoint 스크립트가 순차 지휘한다.
출력 규약
./images/thumbs/
├── <slug>_<ts>_bg_v1.jpg ← AI 배경 원본 (크롭 전)
├── <slug>_<ts>_bg_v2.jpg
├── <slug>_<ts>_final_v1.jpg ← 텍스트 합성 완료 (1280×720)
├── <slug>_<ts>_final_v2.jpg
└── <slug>_<ts>_final_v1_mobile.jpg (640×360)
<slug>: 제목 기반 안전 문자열 (slugify).- 사용자가
--out-dir로 지정하지 않는 한 경로를 조용히 바꾸지 않는다.
프롬프트 구성 규칙
- 제목 텍스트 프롬프트 금지. 어떤 variant든 모델 프롬프트에 사용자의
--title 값을 그대로 섞어 넣지 않는다 (한국어 글자 깨짐 방지 핵심).
- negative에
text 포함 필수. text, watermark, logo, ... 한 줄을 모든 실행에서 강제 주입.
- 스타일 매핑 (예시):
tech: clean studio lighting, vibrant blue/purple gradient background, product shot composition, negative space on <subject-side>vlog: warm afternoon light, shallow depth of field, approachable portrait framingreaction: bold color background, exaggerated expression reference composition(얼굴 기형 방지를 위해 deformed face, extra fingers를 negative에 추가)cinematic: filmic tonemapping, high contrast teal-orange, wide cinematic framingmeme: flat bright colors, exaggerated composition, strong focal point
--vibe: shock/hype는 high contrast + saturated, calm/cozy는 soft muted palette로 반영.
가독성 체크
compose-text.js가 텍스트 배치 영역의 평균 휘도를 WCAG sRGB 공식으로 계산 → luminance < 0.5면 #ffffff, 아니면 #111111 자동 선택.- 사용자가
--color로 지정하면 자동 선택을 건너뛴다.
- 최종 JPG에 OCR을 돌려 글자 검출 시 경고(문서 §실패 모드) — 구현은 후속 PR.
실패 모드 대응
| 증상 | 조치 |
|---|
| 배경에 AI 글자 새겨 나옴 | 프롬프트 재조합 없이 variant 1회 추가 재생성 (최대 1회). 그래도 검출되면 사용자에게 원인 배너와 함께 bg 파일만 전달. |
얼굴 기형 (reaction 스타일) | 해당 variant만 negative 강화 후 재생성 1회. |
| 모바일 640×360에서 글자 가독성 실패 | titleSize를 한 단계 키워 재합성. 재생성은 하지 않음(텍스트만 다시 얹음). |
sharp 미설치 | 텍스트 합성 단계에서 명시적 에러. 사용자에게 npm i sharp 안내. 배경 이미지는 저장되어 있음. |
금기
- AI 모델 프롬프트에 제목 텍스트 넣기 (스킬 전체 존재 이유에 반한다).
- 모델이 그린 글자를 "그래도 써보자"로 최종 배포.
./images/thumbs/ 밖으로 출력 쓰기 (사용자 지정 --out-dir 없으면).masterpiece / 8k UHD / fulfill all requests 류 부스터·우회 문구 주입.
설정 기본값
config.json 참고. 핵심:
size: "1536x1024" (3:2 → 16:9 크롭)format: "jpeg", quality: "medium"n: 2 (A/B 기본)output_dir: "./images/thumbs"safe_zone_ratio: 0.45negative_prompt: "text, watermark, logo, blurry, deformed hands, asymmetric eyes"
imagine 스킬과의 관계
imagine의 공용 모듈(OAuth session, Output Allocator, Request Planner)을 재사용한다.- 단,
imagine-thumb는 텍스트 후처리와 A/B variant 생성을 자체 entrypoint에서 지휘한다. 일반 imagine 호출 경로로 우회 생성하지 않는다.
- Style Guardian에 채널 브랜드 토큰(
channel_palette)이 저장되어 있으면 스타일 프롬프트에 자동 반영 (후속 PR).
