image-prompt v1.0.0A

Immutable. This exact content is served forever at /api/v1/blob/ab8902a1876b73bb.

---
name: image-prompt
description: >-
  Use as the foundation and router for any image a post needs — turn a social need into a clear image
  brief, describe it with model-agnostic prompt craft, and route to the right tool. Run when the user
  says "I need a visual/image for this post," "what image should I use," "make a graphic," "help me
  prompt an image," or is unsure which image tool/model to use. Reads brand-profile for the visual
  brand. Teaches: the image brief (the job — hero / explainer / quote graphic / product / thumbnail /
  background — the one thing it must convey, the platform aspect ratio); the universal anatomy of a
  strong prompt (subject, composition, lighting, colour, style, mood, framing, constraints) in natural
  language, not keyword spam; and a tool router (text-heavy/typographic -> ideogram-3 or nano-banana;
  photoreal portraits/product -> Imagen/Midjourney; surreal/painterly art -> Midjourney; consistent
  character/set -> reference-image models; editing -> canvas/inpainting; vector/SVG -> Recraft; video
  -> veo-3). Includes a "should this even be AI-generated?" gate (a real photo, screenshot, UGC, or
  chart often beats generic AI), accessibility (contrast/legibility, negative space for overlays), and
  honest cross-cutting scope (disclose AI per platform/region, never real identifiable people or
  copyrighted IP, verify text/data). Hands off to the tool-specific mini-skills (nano-banana,
  ideogram-3, veo-3) for model-specific craft; the connection/API lives in tools/integrations/*;
  WoopSocial publishes the result via Media upload and doesn't generate images.
metadata:
  version: 1.0.0
license: MIT
---

# Image Prompt (brief · craft · router)

The **foundation of the visual cluster.** When a post needs an image, this skill decides **what** image
(the brief), describes it with **model-agnostic** craft, and routes to the **right tool** — then hands
off. It sits *above* the tool-specific mini-skills (`nano-banana`, `ideogram-3`, `veo-3`), which own
their model's specific tricks.

Think of it as the visual equivalent of `brand-profile`/`content-pillars`: the shared decision layer
the tool skills assume you've already worked through.

## Step 0 — Gate: should this even be AI-generated?

AI generation is one option, not the default. A **real photo** (your actual product/space/team), a
**screenshot**, **UGC**, or a **chart** often wins on authenticity and clarity — and AI must never
fabricate your real people/place. Reach for generation when you need something that doesn't exist, must
match a brand look, needs legible in-image text, or a consistent series — and no real asset fits. If a
real asset is better, **say so.** (See `references/the-image-brief.md`.)

## Step 1 — Write the brief

Read `brand-profile.md`, then answer four things: **job/purpose** (hero / explainer / quote graphic /
product / lifestyle / thumbnail / background / ad), **the one thing it must convey**, **format/aspect
ratio** for the destination, and the **brand look**. Output a one-line brief. See
`references/the-image-brief.md`.

## Step 2 — Describe it (model-agnostic)

Turn the brief into a **specific, natural-language** prompt — **subject · composition · lighting ·
colour · style · mood · detail · constraints** — and **drop quality-token spam** ("4k, masterpiece").
Specificity beats length; design for any **text overlay** (negative space, contrast). See
`references/prompt-anatomy.md`.

## Step 3 — Route to the tool

Pick by the image's **dominant requirement**:

- **Text / typographic** → `ideogram-3` or `nano-banana` (both strong — honest pick by tooling).
- **Photoreal portrait/product** → Imagen / Midjourney. **Surreal/painterly** → Midjourney.
- **Infographics / consistency / editing** → `nano-banana`. **Consistent set** → reference-image models.
- **Vector/SVG** → Recraft. **Open weights** → Flux. **Video** → `veo-3`.

When two fit, **say both work and pick by the deciding factor** — don't fake a winner. See
`references/choosing-the-tool.md`.

## Step 4 — Hand off, then ship

**Hand off to the tool's mini-skill** for model-specific craft (and `tools/integrations/<tool>.md` for
the API). After generation: **verify** in-image text/data, **disclose** AI per platform/region, then
**upload to WoopSocial Media → attach** via `scheduling-and-queue`. WoopSocial publishes; it **doesn't
generate**.

## Cross-cutting (always)

- **Disclose AI** per platform/region (Meta "Made with AI", EU AI Act). **Watermark behaviour varies by
  tool** (SynthID on Google tools; none enforced on Ideogram) — don't rely on it for disclosure.
- **No real people / no IP** — no real identifiable individuals, copyrighted characters, or trademarked
  logos; original directions only.
- **Verify** in-image text and data before publishing.
- **Accessibility** — contrast + legibility on mobile; leave room for overlays.

## Quality bar — self-check

- Did I **gate** (real asset vs AI) before generating?
- Did I write a **brief** (job + the one thing + format + brand) and a **specific, natural-language**
  prompt (no token spam)?
- Did I **route by the dominant requirement** with an honest which-tool read, and **hand off**?
- Did I design for **overlays/accessibility**, and cover **disclosure, IP, and verification**?
- Did I keep WoopSocial honest (publishes via Media; doesn't generate)?

## Edge cases & pushback

- **"Just write a cool image prompt"** → build the brief first; purpose before prompt.
- **"4k masterpiece ultra-detailed"** → rewrite into a specific scene; drop quality tokens.
- **"Generate my real cafe/staff"** → use a real photo; don't fabricate real people/place.
- **"Base it on [studio]'s characters" / a real person** → refuse IP/real people; original direction.
- **"Which model — A or B?"** → honest, tooling-based answer; both can be right.
- **"Generate it in WoopSocial"** → WoopSocial doesn't generate; route to a tool, then upload + attach.

## Related

- `nano-banana`, `ideogram-3`, `veo-3` — the tool-specific mini-skills this routes/hands off to.
- `tools/integrations/*` — the connection/API for each tool; `brand-profile` — the visual brand.
- `carousel-writer`, `reels-script`, `caption-writer`/`hook-writer` — consumers (image-prompt-pack / overlay copy).
- `scheduling-and-queue` — upload the asset to Media and attach to a post.

## References

- `references/the-image-brief.md` — the "should this be AI?" gate and the four-question brief.
- `references/prompt-anatomy.md` — the universal, model-agnostic anatomy of a strong prompt.
- `references/choosing-the-tool.md` — the router/decision tree and honest which-tool calls.
- `references/examples.md` — end-to-end flows, weak→strong, the don't-generate gate, and honest scope.