Communitygithub.com

image-prompt

>-

What is image-prompt?

image-prompt is a Claude Code agent skill that >-.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/social-media-skills/skills/tree/main/skills/image-prompt

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

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, flux, 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 / typographicideogram or nano-banana (both strong — honest pick by tooling).
  • Photoreal portrait/productnano-banana or flux (Midjourney external). Surreal/painterly → Midjourney.
  • Editing ("change one thing, keep the rest") → nano-banana (conversational) or flux (Kontext).
  • Consistent character/product setnano-banana (multi-image references) or flux (multi-reference).
  • Search-grounded infographicsnano-banana. Brand-exact hex / open weights / license controlflux.
  • Vector/SVG → Recraft. Videoveo-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, flux, 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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Related Skills