mcpField
M
muapi-ad-creative

muapi-ad-creative

github.com/samuraigptMarketing & growth864 installsUpdated 4w ago
Repository

About muapi-ad-creative

A skill for producing ad concepts, copy variations, and resized assets from a product or service brief. It supports a review step between the initial hero creative and platform-specific crops.

Key features

  1. 01Generate a hero ad image
  2. 02Draft three copy variations
  3. 03Create four platform crops
  4. 04Set audience, goal, and tone
  5. 05Use an optional product image

Use cases

  1. 01Prepare a campaign concept for review
  2. 02Adapt approved creative to social formats
  3. 03Develop copy for awareness or conversion ads

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/samuraigpt/muapi-skills --skill muapi-ad-creative

After installing, type/muapi-ad-creativein Claude Code to confirm it loaded.

Details

From the project README

Ad Creative Set

Generate a high-converting ad creative set — hero image, ad copy variations, and platform-optimized crops for Meta, Google Display, and LinkedIn.

Inputs

NameTypeRequiredDefaultDescription
product_or_servicetextyes—What is being advertised (e.g. "SaaS project management tool for remote teams").
target_audiencetextyes—Who the ad is for (e.g. "startup founders aged 25–40, tech-savvy").
campaign_goaltextnoawarenessCampaign objective — "awareness", "consideration", or "conversion".
tonetextnoprofessional, clean, modernCreative tone and visual style (e.g. "bold and disruptive", "luxury minimal", "friendly and approachable").
product_imageimage_urlno—Optional product or brand image URL already in the session.

Steps

This skill has TWO phases. Phase A creates the hero concept for approval; Phase B fans out to platform formats.

Phase A — Hero image + Ad copy

Submit ONE the plan with:

  1. Hero image — muapi image generate (model=nano-banana-pro) or muapi image edit (model=nano-banana-pro-edit) if {{product_image}} is provided:
    • Aspect ratio: 1:1 (universal starting point).
    • Prompt must capture: product/service benefit, target audience lifestyle cue, campaign tone.
    • Style: {{tone}}, advertising photography, clean background, product focus, ultra detailed, commercial quality.
    • Tier: quality.

After the plan executes, present the hero asset and 3 ad copy variations:

  • Variation A — Problem-aware hook: "Tired of X? [Product] fixes that."
  • Variation B — Benefit-led: "[Feature] → [Outcome] for [Audience]."
  • Variation C — Social proof / urgency: "X teams already use [Product]." Each variation includes: Headline (6 words max), Body (20–30 words), CTA button text.

Ask which copy variation to use for Phase B. Wait for user confirmation.

Phase B — Platform crops

Once the user picks a copy direction, submit a SECOND the plan with parallel crops:

  1. muapi image edit → 1:1 (Facebook/Instagram feed, 1080×1080)
  2. muapi image edit → 9:16 (Story/Reels, 1080×1920)
  3. muapi image edit → 1.91:1 (Facebook feed wide, 1200×628)
  4. muapi image edit → 1:1 (LinkedIn feed, same as FB)

For each crop:

  • Prompt: "Reframe for [platform] ad format. Keep product/subject centered and uncropped. Maintain original palette and tone. Leave headroom/footroom for text overlays."
  • All crops run in parallel.

Return one asset per format with the recommended copy overlay placement for each.

Notes

  • If campaign_goal is "conversion", emphasize urgency and direct CTA in copy.
  • If campaign_goal is "awareness", prioritize visual impact over text density.
  • Reference product_image via $nX.url syntax in Phase B nodes to ensure consistency.
  • Do NOT auto-confirm Phase B without user picking a copy variation.

Trigger Keywords

ad creative, advertisement, facebook ad, meta ad, google ad, linkedin ad, paid ad, ad banner, display ad


Notes for the Executing Agent

  • This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call muapi CLI commands. Use muapi auth configure first if MUAPI_API_KEY is unset.
  • For model IDs without a CLI alias yet, fall back to the raw endpoint via curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' and poll with muapi predict wait <request_id>.
  • Substitute {{input_name}} placeholders with the user's actual inputs before issuing each call.

Comments

Markdown supported