thumbnail-gen 가이드

한 줄 결과물: 블로그 1350×650 또는 인포레터 800×430 썸네일 PNG. 브랜드 표시는 기본으로 켜져 있다.

스킬 본문: ../../thumbnail-gen/SKILL.md

샘플 이미지는 아직 만들지 않았다(보류). 이 가이드는 SKILL.md의 절차를 가리키는 짧은 안내다.

언제 쓰나

• 블로그 히어로 썸네일(1350×650)이 필요할 때
• 인포레터 표지(800×430, 호수와 날짜)가 필요할 때
• 이미 있는 썸네일의 제목만 바꿀 때
• 쓰지 않을 때: 글자 없는 히어로(hero-image-gen), 로고 심볼(logo-symbol-gen)

따라하기

1. 전제를 확인한다. OPENAI_API_KEY는 ~/.hermes/.env에 둔다. 값은 문서나 채팅에 적지 않는다. 스킬 폴더에서 python3 -m pip install -r requirements.txt를 하고, assets/fonts를 글꼴 경로에 복사한 뒤 fc-cache -f -v를 실행한다. 그다음 python3 scripts/validate_model.py가 config/model-config.json을 만드는지 본다.
2. 블로그 썸네일을 요청한다. 스킬 폴더에서 실행한다.

   python3 scripts/generate.py \
     --type blog \
     --keyword "gitlab,duo,ai-agent" \
     --title "GitLab Duo Agent Platform으로 개발 업무 80%를 AI에 맡기기"

3. 인포레터는 호수와 날짜를 붙인다. --issue-num과 --issue-date YYYY/MM/DD가 없으면 입력이 거절된다.
4. 결과를 로컬 파일로 받는다. 성공하면 ~/workspace/thumbnails/{type}/ 아래에 PNG가 생긴다. 공개 URL은 이 스킬의 범위가 아니다.
5. 제목만 바꿀 때는 배경을 다시 그리지 않는다. 글자가 이미 박혀 있으면 그 영역을 지운 뒤 같은 글꼴로 제목을 올린다. 절차는 SKILL.md의 Text-Only Overlay를 따른다.

흔한 실패

• from PIL import Image에서 _imaging을 못 읽는다. PYTHONPATH가 Hermes venv를 가리키는 경우다. env -u PYTHONPATH /usr/bin/python3 scripts/generate.py ...로 실행한다.
• OPENAI_API_KEY_MISSING. 키 이름을 확인하고, 값은 출력하지 않는다.
• API_RATE_LIMIT(429). 조용히 재시도하지 않는다. 60초를 기다리거나 사람에게 올린다.
• FONT_MISSING. 글꼴을 복사한 뒤 fc-cache -f를 다시 한다.
• 인포레터에 --issue-num이 없다. INVALID_INPUT이다.
• 크기를 실행 중에 바꾸려 한다. 1350×650과 800×430은 고정이다.
• Slack에 워크스페이스 파일 URL을 붙이면 미리보기가 안 된다. 그 서버는 로그인이 필요하다.

다음 스킬

• 글자 없는 히어로는 hero-image-gen
• 브랜드 문서는 brand