Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Generate marketing ad images using Nano Banana Pro (Gemini 3 Pro Image). Accepts campaign-planner creative briefs, reads brand bible for visual style, constr...
Generate marketing ad images using Nano Banana Pro (Gemini 3 Pro Image). Accepts campaign-planner creative briefs, reads brand bible for visual style, constr...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Generate marketing ad images from campaign-planner creative briefs. Wrap nano-banana-pro with brand-aware prompt construction, aspect ratio handling, and a self-review loop that catches quality issues before marking images final.
Ad Designer (this skill) โ sole executor nano-banana-pro โ image generation engine (upstream dependency) campaign-planner โ upstream source of creative briefs brand-bible-builder โ upstream source of brand visual identity
Verify before starting: command -v uv test -n "$GEMINI_API_KEY" test -f ~/.codex/skills/nano-banana-pro/scripts/generate_image.py If uv is missing: tell the user to install it with curl -LsSf https://astral.sh/uv/install.sh | sh. If GEMINI_API_KEY is unset: tell the user to export it from Google AI Studio. If the script is missing: tell the user the nano-banana-pro skill must be installed first.
Identify which inputs are present in the conversation or filesystem: InputSourceWhere to find itCreative brief(s)campaign-planner skill/tmp/marketing/campaigns/<brand>-campaign-plan.json โ ad_creatives[] array, or inline in conversationBrand biblebrand-bible-builder skill/tmp/marketing/brands/<brand>/brand-bible.md or inlineAspect ratioUser or briefDefaults to 1:1 if not specifiedResolution modeUserDefaults to draft (1K) unless user says "final" or "4K" If the creative brief is missing, ask: "I need a creative brief to generate the ad. Run /campaign-planner first, or paste the brief details: headline, visual direction, CTA, and target audience." If the brand bible is missing, proceed with neutral visual defaults โ note this in the output and recommend running /brand-bible-builder for on-brand results.
Open the brand bible and extract these fields into a working reference: Primary colors โ hex codes or descriptors (e.g. #1A2E5A deep navy, #F5A623 amber) Secondary / accent colors โ supporting palette Font style โ serif vs sans-serif, weight, mood descriptor (e.g. "bold geometric sans", "light editorial serif") Imagery style โ photography vs illustration, lifestyle vs product-only, color grading mood (warm/cool/muted/vibrant) Layout pattern โ minimal and clean vs content-dense, whitespace-heavy vs layered Tone โ formal, casual, bold, playful, premium, approachable Keep this as a 6-field internal reference. Do not show it to the user. Use it when constructing prompts in Step 3.
Apply these rules every time. They are non-negotiable.
Rule 1 โ Less is more. Short, focused prompts outperform long descriptive ones. Target 15โ30 words for the visual description. Cut adjectives that repeat the same idea. Rule 2 โ No logos, brand names, or company names. Never include the brand name, product name, logo description, or any trademark in the prompt. The generation engine hallucinates these badly and they must be added in post-production. Rule 3 โ Only include text that is explicitly specified. If the brief specifies a headline to appear in the image, include it exactly as written โ no paraphrasing. If no text is specified, do not add any text to the prompt. Do not include CTAs, taglines, or copy unless the brief explicitly says to render text. Rule 4 โ Describe emotion and composition, not data. Instead of "a woman saving money on her bills," write "confident woman, bright home office, warm morning light, relaxed expression." The emotion communicates the message; the model handles the rest. Rule 5 โ Translate brand colors without naming the brand. Convert hex codes to descriptors: #1A2E5A โ "deep navy", #F5A623 โ "warm amber". Use these color words in the prompt naturally.
Assemble the prompt in this order: [SUBJECT] โ who or what is the focal element [SETTING] โ environment or background context [MOOD / EMOTION] โ feeling the image should evoke [COMPOSITION] โ framing, shot type, perspective [LIGHTING] โ quality and direction of light [COLOR PALETTE] โ 2โ3 colors derived from brand bible [STYLE] โ photography/illustration style from brand bible [AVOID] โ explicit exclusions (text, logos, clutter, etc.) Do not use all 8 fields every time. Use only those relevant to the brief. A 5-field prompt is often stronger than an 8-field one.
Brief input: headline: "Finally, sleep that works" visual_direction: "Woman waking up refreshed, natural light bedroom" cta: "Try free tonight" target_persona: "Aisha, 28, KL, stressed professional" Brand bible: warm coral #E8735A, off-white #FAF7F2, editorial sans-serif, warm and minimal photography style. Constructed prompt: Young woman waking up peacefully, sunlit minimalist bedroom, linen textures, warm coral and off-white tones, soft morning light through sheer curtains, close-up on relaxed expression, warm editorial photography style What was excluded: brand name, CTA text, product name, headline text (no text was specified for visual rendering).
Map the brief's platform or format to the correct ratio flag and pixel dimensions: Platform / FormatRatioPixel DimensionsUse CaseInstagram / Facebook Feed1:11080 ร 1080Square feed postInstagram Story / Reel9:161080 ร 1920Full-screen verticalFacebook Feed (portrait)4:51080 ร 1350Taller feed post, more screen areaYouTube / LinkedIn Cover16:91920 ร 1080Landscape / banner If the brief does not specify a platform, default to 1:1. For carousel ads: generate all cards at the same ratio. Use 1:1 unless the brief specifies otherwise. Pass the ratio to the script via --resolution. The nano-banana-pro script handles internal sizing. Generate at 1K for drafts, 4K for finals.
Create the output directory: mkdir -p /tmp/marketing/assets/images
Use this command pattern. Always use absolute path for the script. uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py \ --prompt "<constructed prompt>" \ --filename "/tmp/marketing/assets/images/<timestamp>-<brief-id>-draft.png" \ --resolution 1K Filename format: yyyy-mm-dd-hh-mm-ss-<brief-id>-draft.png brief-id: lowercase kebab-case derived from the brief headline (e.g. finally-sleep-works) Use current date/time for timestamp
Always follow this sequence: Draft at 1K โ generate first at 1K for fast feedback. Present to user. Iterate โ if issues found in self-review (Step 6), adjust prompt and regenerate at 1K. Max 3 attempts. Final at 4K โ only after user approves the draft or after self-review passes. Change filename suffix from -draft to -final, set --resolution 4K.
Generate each card as a separate image. Naming convention: yyyy-mm-dd-hh-mm-ss-<brief-id>-card-01-draft.png yyyy-mm-dd-hh-mm-ss-<brief-id>-card-02-draft.png Ensure visual consistency across cards: Use the same color palette descriptor in every card's prompt Use the same style descriptor in every card's prompt Use the same lighting descriptor in every card's prompt Vary only the subject and composition per card
After generating each image, perform a structured self-review before presenting to the user. Do not skip this step. Run through this checklist for every generated image: CheckPass ConditionFail ActionText accuracyAny specified text appears correctly and is readableSimplify prompt; add explicit text instructionNo hallucinated logosNo brand marks, wordmarks, icons, or watermarks visibleAdd "no logos, no text, no watermarks" to avoid clauseNo hallucinated brand namesNo company names or product names rendered as textAdd "no brand names, no product names" to avoid clauseAspect ratioMatches requested formatRe-run with correct ratio flagColor alignmentDominant colors match brand palette intentStrengthen color descriptors in promptOverall qualityImage is coherent, professional, on-briefRebuild prompt from scratch using simpler structure
If any check fails: Identify the specific failure from the table above. Apply the corresponding fail action to the prompt. Regenerate at 1K. Re-run the self-review checklist on the new image. Stop after 3 total attempts. If still failing on attempt 3, present the best result to the user with a note explaining what the issue is and what was tried. Do not present a failing image silently. Always tell the user what was wrong and what fix was applied.
After self-review passes (or after 3 attempts), present the results: Ad image(s) generated for: [brief headline] Draft(s) saved to /tmp/marketing/assets/images/: [timestamp]-[brief-id]-draft.png โ [ratio] | 1K Self-review: [PASS / notes on any issues found and fixed] Review the image and reply with one of: A) Approve โ I'll upscale to 4K final B) Adjust โ describe what to change C) Skip โ move to next brief Wait for the user's response before generating the 4K final or moving to the next brief. If the user says "adjust" or describes changes: Apply the change to the prompt (keep changes minimal โ one diff at a time) Regenerate at 1K Re-run self-review Present again If the user approves: Regenerate at 4K with -final filename suffix Confirm: "Final saved: /tmp/marketing/assets/images/[filename]-final.png"
If the input contains multiple briefs (e.g. from a campaign-planner JSON with 3โ5 image ad entries), process them sequentially. Complete the full cycle (generate โ self-review โ HITL approval โ final) for each brief before moving to the next. After all briefs are processed, present a summary: All ad images complete. Generated: /tmp/marketing/assets/images/[file-1]-final.png [ratio] /tmp/marketing/assets/images/[file-2]-final.png [ratio] /tmp/marketing/assets/images/[file-3]-final.png [ratio] Next step: run /meta-ads-publisher to upload these to your ad account, or /campaign-planner to review the full campaign.
ErrorActionError: No API key provided.Tell user to run export GEMINI_API_KEY=<key> and retryError loading input image:Verify the --input-image path exists; fix path and retryquota / 403 / permission API errorWrong key or quota exceeded; ask user to check Google AI Studio quotaScript not found at ~/.codex/skills/...nano-banana-pro skill is not installed; tell user to install it from ClawHubuv: command not foundRun `curl -LsSf https://astral.sh/uv/install.shImage generation returns blank/emptyPrompt may be too restrictive; remove avoid clauses and simplify to subject + style only
/tmp/marketing/ โโโ assets/ โ โโโ images/ โ โโโ yyyy-mm-dd-hh-mm-ss-<brief-id>-draft.png โ draft outputs โ โโโ yyyy-mm-dd-hh-mm-ss-<brief-id>-final.png โ approved 4K finals โโโ brands/<brand>/ โ โโโ brand-bible.md โ brand visual reference โโโ campaigns/ โโโ <brand>-campaign-plan.json โ input brief source
Writing, remixing, publishing, visual generation, and marketing content production.
Largest current source with strong distribution and engagement signals.