pmax-design

name	pmax-design
description	Composite headline + subtitle onto branded PNG templates OR directly onto client-supplied photos via the shared task_server pipeline. Local Pillow compositor — no FAL, zero render cost. Two modes (template_compose + photo_compose) behind one wrapper.
version	3.0.0
author	Mousa Abu Mazin
license	MIT
platforms	["macos","linux"]
prerequisites	{"env_vars":["TASK_SERVER_URL","TASK_TOKEN_FILE"]}
metadata	{"hermes":{"tags":["design","template","compose","branded","gmb","social","pillow","photo","client-photo"]}}

PMAX Design — branded composer (template + photo)

STRICT PROTOCOL — READ BEFORE ANY TOOL CALL

1. ONLY call scripts/design_tool.py. Do NOT invent curl commands; the script handles auth, the brief shape, and the task lifecycle correctly.
2. NEVER cat ~/.hermes/secrets/.task_token — the wrapper reads the token from $TASK_TOKEN_FILE without echoing it.
3. NEVER claim a template was rendered unless the wrapper printed ✓ completed — file://.... Then verify with ls -la <path> before telling the user the file exists.
4. If the wrapper exits non-zero, tell the user the real error. Do not fall back to pmax-image — they are different skills with different voice+brand intent.

When to use this skill

• Brand-template posts with a consistent visual identity (logo, colors, typography)
• GMB posts where the headline IS the post
• Announcements / promos where a designer-made PNG template already exists
• When you want deterministic output (same headline → same pixels)

When NOT to use this skill

• Fresh AI-generated imagery → pmax-image (FAL)
• Video / reels → pmax-video (FAL)
• When no template PNG exists for the client → onboard one first, or use pmax-image

Backend

• Same task_server + worker as pmax-image / pmax-video. One queue, one lifecycle.
• Render path: render_mode="template_compose" + render_model="template/v1" → the worker dispatches to TemplateComposeBackend (local Pillow) instead of FAL.
• Asset output: ~/mem0-server/assets/templates/YYYY-MM/task_<id>_<hash>.png
• Cost: $0 per render (ledgered at 0.0 for volume tracking).

How to invoke

1) Template compose (no --image) — headline on a fixed branded template

python3 ~/Projects/performancemax/hermes-skills/pmax-design/scripts/design_tool.py generate \
  --client "mock" \
  --headline "Spring special — 20% off" \
  --subtitle "Book before April 30"

Uses ~/Projects/design-agent/templates/<client>.png as the background and draws text in the configured boxes. .