creative-poster

Что делает простыми словами

Это «студия статичной рекламы». Дёргает Gemini 3 Pro Image (он же nano-banana-pro), знает как промптить постеры по 5-компонентной формуле, автоматически подмешивает brand-context из проекта и проверяет результат на типографические ошибки. По шагам:

1. Загружает brand.yaml проекта → palette, шрифты, voice, forbidden — собирает BRAND CONTEXT блок
2. Загружает preset recipe (один из 16 эстетических пресетов) → typography, palette, layout hints, avoid
3. Применяет locale (ru/kk/en/uk) — добавляет text rendering hint для алфавита
4. Если переданы --reference картинки с ролями → multi-shot композиция с explicit role mapping
5. Собирает финальный промпт по 5-компонентной формуле (SUBJECT + ACTION + LOCATION + COMPOSITION + STYLE)
6. Дёргает gemini-3-pro-image-preview, при 429/503 — fallback chain
7. Логирует в creative_posters таблицу
8. Открывает HTML preview-страницу с payload sidebar (GR-1)

5-Component Prompt Formula

Промпт для Gemini Pro Image собирается по жёсткой схеме (source: banana-claude, Google Cloud guide):

HARD CONSTRAINTS (зашиты в SYSTEM_RULES)

Эти правила автоматически инжектятся в каждый промпт и проверяются в QA. Нарушение = auto-fail.

16 aesthetic preset recipes

Каждый preset — YAML с description, typography, color_palette[], layout_hints[], avoid[]. Загружается через --preset-recipe <slug> и инжектится как PRESET RECIPE блок в промпт.

Original 8 (Wave 4L)

Added May 2026 (+8 из rohitg00/awesome-claude-design)

Кастомные пресеты добавляются как presets/<slug>.yaml в скилл-папку.

Brand auto-injection

Когда задан --project-dir, цепочка инжекции выглядит так:

brand.yaml — опциональная но настоятельно рекомендуемая штука. Без неё каждый gen.py требует brand colors/fonts/voice в --custom-prompt каждый раз. С ней — auto-injection.

Команды

Brand library

brand.py init <project-dir> [--from-project-yaml]
brand.py show <project-dir>
brand.py add-reference <project-dir> <image-path>
brand.py validate <project-dir>
brand.py to-prompt <project-dir>          # рендерит brand-context блок

Генерация одного постера

gen.py \
  --project-dir ~/video-projects/apparatus \
  --output out.png \
  --offer "..." --bullets "...\n...\n..." --profits "..." \
  --reference path1.jpg --reference-role "hero product" \
  --reference path2.jpg --reference-role "side angle" \
  --reference path3.jpg --reference-role "logo asset" \
  --style modern_performance \
  --preset-recipe tech_minimal \
  --custom-prompt "Brand: APPARATUS KZ. Background: deep navy gradient..." \
  --locale ru \
  [--aspect-ratio 4:5] [--upscale-4k] [--expand-9x16]

Refine (итерация)

refine.py --input poster.png --output v2.png \
  --change "headline +30%, move device left, swap red badge for gold" \
  --keep "layout, brand colors, all text content"

Multi-aspect (omnichannel)

multi_aspect.py --input base_4x5.png --output-dir out/ \
  --formats feed,story,square,pinterest,wide \
  --skip-same-aspect

# Получим: <prefix>_feed_4x5.png, <prefix>_story_9x16.png,
#          <prefix>_square_1x1.png, и т.д.

Variants (A/B explosion)

variants.py --project-dir ~/video-projects/apparatus --output-dir out/ \
  --base-offer "Конкурент уже купил УВТ" \
  --bullets "...\n...\n..." --profits "..." --reference X \
  --count 6 \
  --explore-angles math,emotion,fear,curiosity,authority,benefit

# Каждый angle переписывает OFFER через свою линзу
# (math/emotion/fear/curiosity/authority/social/urgency/benefit)
# через Gemini text model, потом дергает gen.py на каждый

QA (Vision-based)

qa_review.py --input poster.png \
  --expect-text "Headline; Bullet1; Bullet2; Bullet3; Profit" \
  [--brand-context "..."]

# → JSON: {score: 0-10, pass: bool, issues: [
#     {type, severity, description, suggested_fix}
#   ]}
# suggested_fix → сразу в refine.py --change

OCR (анализ конкурентов)

ocr.py --input competitor.jpg --structured

# → JSON: headline / subhead / bullets / cta / profit_or_offer /
#         fine_print / brand / tagline
# Фидится в video-copywriter --type reference

DB (track + learn)

db.py init                                            # создать таблицы
db.py log --output X.png --offer "..." --style ...    # записать генерацию
db.py list --project-dir ~/video-projects/apparatus
db.py link-performance --poster-id N --fb-ad-id A --ctr 1.2 --cpl 3.4
db.py winners --project-dir ~/video-projects/apparatus --metric cpl

Multi-shot referencing

До 14 reference-картинок на запрос (для сравнения: у Veo лимит 3). Каждая может иметь explicit роль:

--reference hero.jpg     --reference-role "hero product"
--reference side.jpg     --reference-role "side angle"
--reference logo.png     --reference-role "logo asset"
--reference texture.jpg  --reference-role "background texture"

Роли вшиваются в SUBJECT-блок как explicit «use IMAGE A for X, IMAGE B for Y» инструкции. Без ролей — Gemini сам решает что взять, что часто работает хуже.

Locales

Текст рендерится ровно так как передан — никакого авто-перевода. Locale только влияет на качество глифов.

Cross-model fallback chain

Default: gemini-3-pro-image-preview с автоматическим переходом при 429 / RESOURCE_EXHAUSTED / 500 / 503 / NOT_FOUND:

nano-banana-pro-preview — алиас для Pro-модели. Названия меняются между релизами, оба резолвятся.

Цены

Полный pipeline run (6 вариантов × 2 aspect'а + QA + delivery) ≈ $0.78. Дёшево относительно видео-пайплайна.

Скрипты

Auto-preview (GLOBAL RULE для всех creative-* скиллов)

После каждой успешной генерации gen.py автоматически логирует в creative_posters таблицу и открывает HTML preview-страницу с:

• Сгенерированный постер (кликабельно → fullscreen lightbox)
• Payload sidebar с full provenance:
  • Production: model used, aspect, style, preset, locale, cost, QA score, timestamp
  • Brand context: name, palette swatches, fonts
  • Text payload: offer / bullets / profit (как цветные карточки)
  • References: thumbnails + роли для каждого --reference
  • Custom prompt (user input) + Final prompt (что ушло в модель)

Отключить — --no-present. Вручную: present.py --output-image X.png --output preview.html --open

Архитектура папки

~/.claude/skills/creative-poster/
├── SKILL.md                      ← spec + commands cheat-sheet
├── presets/                      ← 16 aesthetic-family recipes
│   ├── tech_minimal.yaml
│   ├── premium_luxury.yaml
│   ├── ugc_authentic.yaml
│   ├── editorial_magazine.yaml
│   ├── b2b_corporate.yaml
│   ├── visual_hook_bold.yaml
│   ├── infographic_data.yaml
│   ├── product_hero_clean.yaml
│   ├── terminal_core.yaml        ← May 2026
│   ├── warm_editorial.yaml       ← May 2026
│   ├── cinematic_dark.yaml       ← May 2026
│   ├── playful_color.yaml        ← May 2026
│   ├── glass_futurism.yaml       ← May 2026
│   ├── neon_brutalist.yaml       ← May 2026
│   ├── cult_indie.yaml           ← May 2026
│   └── swiss_minimal.yaml        ← May 2026
└── scripts/
    ├── gen.py            ← главный
    ├── refine.py
    ├── multi_aspect.py
    ├── variants.py
    ├── qa_review.py
    ├── ocr.py
    ├── brand.py
    ├── db.py
    └── present.py        ← GR-1 preview

Зависимости и env

pip install google-genai pillow pyyaml
export GOOGLE_API_KEY=<key>

API-key auto-resolution: --api-key > --project-dir/api_keys.db > $GOOGLE_API_KEY.

Gotchas и tips

Pairs with

• creative-orchestrator — top-level batch pipeline (variants × aspects + QA loop)
• video-copywriter — генерит textover_hook тексты, фидятся в --offer/--bullets/--profits
• video-clipgen — управляет references/ папкой + reference_images таблицей (общие refs)
• creative-carousel — карусели надстроены над poster, переиспользуют brand, presets, multi-aspect, QA

🎬 Примеры работы

Место в пайплайне