For Agents · MCP

Your task.
The right skill.

The tunnel uses the same cards as the catalogue. Browse only as deep as needed — or load a broad bundle immediately.

No local installationNo M11 loginRead-only

Broad task

Load 5–10 and go

SEO, Sales, Agents or another broad area → one bundle call → work.

MCP endpoint: https://skills.m11.ch/mcp

Read-only access to published skills. Default 8, maximum 10 skills / 120,000 characters.

Task Packs

Marketing Foundation

Compact two-skill starter: clarify positioning and choose a lead magnet. Use Marketing Launch for the broader eight-skill go-to-market workflow.

Marketing Launch

Build an evidence-led marketing plan from ICP and competition through positioning, campaigns, growth and measurement.

Agent Audit Essentials

Diagnose architecture and context, plan agent-team responsibilities, then organize project context and session handoffs. Memory and cost-runtime reviews remain outside this pack.

Conversion and Activation Review

Review the journey from landing page and lead capture through registration, first value and transparent upgrades.

Campaign Content and Brand Review

Plan a campaign, draft its channel content and review the work against actual brand guidance.

Content and Launch Planning

Prioritize an editorial roadmap and plan how to launch and distribute it across suitable channels.

Customer, Market and Community Research

Understand customer needs, compare competitors and plan a community around real member value.

Lead Magnet to Lifecycle Nurture

Choose a relevant lead magnet, then draft a permission-based nurture journey with entry, suppression and exit rules.

API Contract and Observability

Define the API contract, then plan how to observe its latency, failures and retries. Guidance and checklist; no production changes.

Data Analysis Foundation

Profile a dataset, choose and interpret statistical methods, then validate calculations and conclusions before sharing.

Choose an area

01 · Category

What the MCP returns at this step

83 · Marketing · Ads Operations

Meta Ad and Creative Planning

Prepare Meta ads with single-image/video or catalog creatives under an existing ad set. Use Ad Brief Production for creator instructions.

metaanzeigenmotivplanungmeta-create-ad-with-creative

Meta Ad + Creative Creation · Original SKILL.md

---
name: meta-create-ad-with-creative
description: "Use when creating a Meta ad with its creative in one shot. Auto-detect landing page/CTA/UTM, creative analysis for copy, object_story_spec vs asset_feed_spec, text length guardrails, video thumbnail auto-gen. Loaded after the create master skill."
---
# Meta Ads - Create Ad with Creative

## CRITICAL: Do NOT combine with other creation steps
Each creation step (campaign → ad set → ad+creative) has its own separate flow. The ad+creative step happens AFTER campaign and ad set have been created and executed.

## Branch decision (read FIRST)

If the user mentions any of: "catalog ad", "DPA", "dynamic product ad", "shopping ad", "product feed ad", "product catalog" → jump to **Catalog Ad Flow** at the bottom. That flow has its own steps and uses `template_data` instead of uploaded creative assets.

Everything else (single image, single video, multi-asset) → standard flow below.

## user_input Rules

ONLY ask for 1 thing: creative asset upload. NOTHING ELSE.

Do NOT ask for primary_text, headline, landing_page_url, ad_name, creative_name, CTA, or any other field. Auto-detect and auto-generate ALL other fields. The user reviews and edits everything in the approval UI.

**Whenever you must ask the user to pick an ID (page, product set, catalog, etc.), use `user_input` with `type: "select"` — `value` = id, `label` = human-readable name. Never list IDs in chat text and ask the user to type one back.**

### user_input — 1 field only (creative asset)

| # | Field name | type | required | accept |
|---|-----------|------|----------|--------|
| 1 | `creative_assets` | file_upload | true | image/jpeg, image/png, image/gif, video/mp4, video/quicktime |

That's it. No other fields. If you add any other field to user_input, you are doing it wrong.

### ONE exception: Facebook Page selection

If the account has **multiple Facebook Pages** AND existing ads don't clearly indicate which one to use, ask the user via a second `user_input` with a `select` field:

| # | Field name | type | required | options |
|---|-----------|------|----------|---------|
| 1 | `facebook_page` | select | true | `[{ label: "Page Name 1", value: "page_id_1" }, …]` |

For single-page accounts, skip this entirely.

---

## CRITICAL: NEVER give up — always complete the full flow

When the user asks to "launch creatives" or "create ads", you MUST complete the FULL creation flow: Campaign → Ad Set → Ad+Creative.

**If `account_structure` is empty (new account with no existing campaigns/adsets/ads):**
- Do NOT stop and ask "give me an adset_id" or "tell me what to do"
- Do NOT say "I can't find existing structure"
- CREATE everything from scratch automatically (campaign → ad set → ad+creative)
- For budget: ask (no data to infer from)
- For landing page: infer from brand/context, or ask if you can't infer
- For text: auto-generate from creative analysis
- For everything else: use standard defaults

**If the user provides creatives/images in their message:**
- Treat the attached images as the creative assets — do NOT ask for upload again via `user_input`
- Skip Step 1 (user already provided assets) and go straight to Step 2

---

## Unsupported Creative Types (Hard Block — Do NOT Attempt)

If the user requests any of these, **stop immediately**, explain the limitation, and ask for a standard image or video instead.

| Unsupported Type | Why it's blocked | What to ask for instead |
|---|---|---|
| **Carousel ads** | Multi-card carousel (`child_attachments`) requires a separate creation path not yet implemented | Single image or video |
| **Ads from existing Facebook/Instagram posts** | Boosting/converting a post requires the `object_story_id` flow, not supported here | Standalone image or video upload |
| **Ads duplicated from existing ads** | Duplicating an existing ad (copy creative config, clone structure) is not supported | Fresh image or video upload |

### Enforcement Rules

1. **NEVER attempt** to construct a carousel (`child_attachments`), post-based (`object_story_id`), or duplicate ad flow even if you think you can infer the required parameters.
2. **If the user uploads multiple images intending a carousel** → do NOT default to carousel. Inform them carousels are not supported and ask which single image to use.
3. **If the user says "boost this post" or "use my existing post"** → respond: *"Boosting existing posts isn't supported in the current flow. Please upload a standalone image or video and I'll create a new ad with it."*
4. **If the user says "copy that ad" or "use the same creative as [ad name]"** → respond: *"Duplicating existing ads isn't supported here. Please upload a fresh creative asset to proceed."*

---

## Complete Workflow (follow in exact order)

### Phase 1: Gather Information

**Step 1: Ask user for creative asset**
Call `user_input` with ONLY `creative_assets` (file_upload). Wait for the upload.

**Step 2: Run these 2 calls IN PARALLEL immediately after getting the asset:**

| Call | Purpose |
|------|---------|
| `facebook_analyze_ad_creative_by_id_or_url` with `assetUrl` + `fastMode: true` | Get `text_hook`, `key_message`, `visual_hook`, `call_to_action`, `product_featured` |
| `facebook_get_details_of_ad_account` with `act_id` | Get `account_structure.ads` for landing page URLs, CTAs, UTM patterns, **and page_id from existing ads** |

**Step 2b: Resolve Facebook Page and Instagram BEFORE proposing (CRITICAL)**

⚠️ **BOTH `page_id` AND `instagram_user_id` are REQUIRED in every `creative_config`.** The server rejects any config missing either — there is NO server-side auto-detection or backfill. Resolve both before calling propose.

Follow this EXACT resolution chain. Do NOT skip steps.

1. **Existing ads** (`account_structure.ads[].creative`): extract `page_id` and `instagram_user_id`. One unique `page_id` → use it. Multiple → ask via `user_input` select showing page names.
2. **If no existing ads or no page_id found** → call `facebook_page_list`. Exactly 1 page → use it. Multiple → ask via select.
3. **If `facebook_page_list` returns 0 results** → call `facebook_list_ads` to get a recent ad ID, then `facebook_get_ad_creative_details` → extract both.
4. **ABSOLUTE RULE**: You are FORBIDDEN from calling `user_input` to ask for `page_id` or `facebook_page` until ALL THREE steps above have been attempted and returned zero results. Skipping any step is a critical error.
5. **Always pass both in the propose call**: set `creative_config.page_id` AND `creative_config.instagram_user_id`. Missing either → error 601.

For `instagram_user_id`: try existing ads → page's linked IG (via `facebook_page_list` or page details) → ask the user only as a last resort.

### Phase 2: Auto-Generate Everything (no user interaction)

**Step 3: Extract landing page URL**
From `account_structure.ads`, look at active ads — pick the most common destination URL.
- **Empty account** → infer from account/brand name (e.g., `https://www.{brand}.com`). If you can't infer, ASK once via `user_input` with a single `landing_page_url` text field. Do NOT give up.

**Step 4: Extract CTA pattern**
- Most common `call_to_action.type` across active ads (usually `SHOP_NOW` for Sales)
- Creative analysis suggests educational content → use `LEARN_MORE`

**Step 5: Extract UTM pattern**
- From `account_structure.ads` or `facebook_get_ad_creative_details` — `url_tags` pattern from top-spending active ads
- No existing ads → leave empty

**Step 6: Auto-generate text from creative analysis**
Build primary texts and headlines per the **Quality Framework** at the end of this skill.

⚠️ **MANDATORY: Always generate exactly 3 headlines and 4 primary texts per ad.** Every ad uses `creative_asset_groups_spec` so Meta tests all 12 combinations (4 × 3) and optimizes delivery. Single-text ads waste optimization opportunity.

- **4 Primary texts** (max 125 chars each): each must use a **different hook archetype** (Relatability, Confession, Contrast, Curiosity, Bold Claim, Imperative). Hook → Proof → CTA. Reader-first voice. Source from `key_message`, `text_hook`.
- **3 Headlines** (max 40 chars each): each must use a **different angle** (benefit-in-time, built-for-audience, action-without-pain). Sharp specific promise. No emoji.
- **Ad name**: first headline + format. **Creative name**: first headline + CTA.
- **User-provided text verbatim in conversation** → use as one variation; generate the rest.

**Step 7: Creative format — ALWAYS use Flexible Ads (`creative_asset_groups_spec`)**

This is the default for ALL ads — single image, single video, or multiple assets. Never use flat fields for ad creation. Does NOT require `is_dynamic_creative` on the ad set; standard ad sets work.

| Scenario | Correct Approach | Format |
|---|---|---|
| **Single image** | 1 Flexible Ad: 1 image + 4 primary texts + 3 headlines | `creative_asset_groups_spec` |
| **Single video** | 1 Flexible Ad: 1 video + 4 primary texts + 3 headlines | `creative_asset_groups_spec` |
| **Multiple images/videos for same ad** | 1 Flexible Ad: N images/videos + 4 primary texts + 3 headlines | `creative_asset_groups_spec` |
| **Different images each needing own ad** | Separate ads — each still uses `creative_asset_groups_spec` with 3 headlines + 4 primary texts | `creative_asset_groups_spec` |
| Placement-specific assets (same ad, different crop sizes) | **1 ad** using `asset_feed_spec` with `asset_customization_rules` | `asset_feed_spec` (exception) |

**DO NOT use flat fields** (`primary_text`, `headline` in `creative_config`) for ad creation. The only exception is placement-specific asset customization rules.

**Step 8: Handle placement assets** (only if user customized placements)
If the file upload result includes a `placements` object:
- Pass as `placement_assets` param
- Use `asset_feed_spec` with `asset_customization_rules` in `creative_config`
- Use EXACT URLs from placements — do NOT fabricate
- If NO `placements` object → use `creative_asset_groups_spec` with original URL

### Phase 3: Propose Directly

**Step 9: Call `facebook_propose_create_ad_with_creative` immediately**
Do NOT show a summary in chat. Do NOT ask for confirmation. The user reviews and edits everything in the approval UI.

**CRITICAL: Batch ALL ads in a SINGLE call.** Pass all of them as multiple items in the `ad_with_creative_configs` array — do NOT call the tool N times. One call with N items, not N separate calls. Each item gets its own approval card.

**Every ad MUST use `creative_asset_groups_spec` with exactly 4 primary texts and 3 headlines.** Each primary text uses a different hook archetype; each headline a different angle. Do NOT use flat fields. For multiple ads, vary the text variations per ad — do NOT reuse the same copy.

---

## Auto-Configure Reference (all silent — do NOT ask user)

| Field | Value | Source |
|-------|-------|--------|
| `name` (ad) | Auto-generate | first headline + format |
| `creative_config.name` | Auto-generate | first headline + CTA |
| `creative_asset_groups_spec.groups[0].texts` (primary_text) | **4 variations** (≤125 chars, different hook archetypes) | Creative analysis `key_message` / `text_hook` |
| `creative_asset_groups_spec.groups[0].texts` (headline) | **3 variations** (≤40 chars, different angles) | Creative analysis `text_hook` / `visual_hook` |
| `landing_page_url` | Auto-detect | Most common URL from active ads, or infer from brand |
| `page_id` | **REQUIRED** | Resolution chain: (1) existing ads → (2) `facebook_page_list` → (3) `facebook_list_ads` + `facebook_get_ad_creative_details` → (4) ask user. Server rejects if missing. |
| `instagram_user_id` | **REQUIRED** | Existing ads → page's linked IG → ask user. Server rejects if missing. |
| `cta_type` | Detected or `SHOP_NOW` | Existing ad patterns |
| `url_tags` | Detected UTM pattern | Existing ad patterns |
| `adset_id` | From prior step | `new_adset_id` from ad set execution |
| `status` | `PAUSED` | Safety default |

---

## Guardrails

### Text Length
| Field | Limit | Action |
|-------|-------|--------|
| Primary text | > 125 chars | **BLOCK** — shorten before proposing |
| Headline | > 40 chars | **BLOCK** — shorten before proposing |

### Image/Video Specs
| Format | Recommended Size | Max Size | Formats |
|--------|-----------------|----------|---------|
| Single Image | 1080x1080 (1:1) or 1200x628 (1.91:1) | 8 MB | JPG, PNG, GIF |
| Single Video | 1080x1080 (1:1) or 1080x1350 (4:5) | 200 MB | MP4, MOV |

---

## Creative Structure Reference

### Flat format (DEPRECATED — do NOT use for ad creation)

Flat fields (`primary_text`, `headline` directly in `creative_config`) are kept only for backward compatibility with EXISTING ads. For new ad creation, always use `creative_asset_groups_spec`. When using `creative_asset_groups_spec`, `creative_config` only needs `name`, `page_id`, and `instagram_user_id` — do NOT include flat fields or `asset_feed_spec` in `creative_config`.

### creative_asset_groups_spec — Flexible Ads (MANDATORY for all ad creation)

Meta tests all 12 combinations (4 primary texts × 3 headlines) and optimizes delivery. Does NOT require `is_dynamic_creative` on the ad set.

**Example: 1 image ad** (Relatability + Confession + Curiosity + Imperative hooks)
```json
{
  "creative_config": {
    "name": "Flexible Ad Creative",
    "page_id": "PAGE_ID",
    "instagram_user_id": "IG_ID"
  },
  "creative_asset_groups_spec": {
    "groups": [{
      "images": [{ "url": "CDN_URL_OF_IMAGE" }],
      "texts": [
        { "text": "Tired of a brittle beard? Aloe & Shea stops breakage.", "text_type": "primary_text" },
        { "text": "I used to hide my beard. Then I found Aloe & Shea.", "text_type": "primary_text" },
        { "text": "Why do most beard oils fail? Because they skip Shea.", "text_type": "primary_text" },
        { "text": "Say goodbye to brittle! Aloe & Shea restores softness.", "text_type": "primary_text" },
        { "text": "Stronger Beard in 7 Days", "text_type": "headline" },
        { "text": "Built for Beards That Break", "text_type": "headline" },
        { "text": "Say Goodbye to Brittle", "text_type": "headline" }
      ],
      "call_to_action": { "type": "SHOP_NOW", "value": { "link": "https://example.com" } }
    }]
  }
}
```

**Example: 1 video ad** (Relatability + Confession + Curiosity + Bold Claim hooks)
```json
{
  "creative_config": {
    "name": "Video Flexible Ad",
    "page_id": "PAGE_ID",
    "instagram_user_id": "IG_ID"
  },
  "creative_asset_groups_spec": {
    "groups": [{
      "videos": [{ "video_url": "CDN_URL_OF_VIDEO" }],
      "texts": [
        { "text": "Tired of a brittle beard? Aloe & Shea stops breakage.", "text_type": "primary_text" },
        { "text": "I used to hide my beard. Then I found Aloe & Shea.", "text_type": "primary_text" },
        { "text": "The hidden reason your beard keeps breaking.", "text_type": "primary_text" },
        { "text": "WARNING: Most beard oils skip the one ingredient that matters.", "text_type": "primary_text" },
        { "text": "Stronger Beard in 7 Days", "text_type": "headline" },
        { "text": "Built for Beards That Break", "text_type": "headline" },
        { "text": "Stop Breakage at the Root", "text_type": "headline" }
      ],
      "call_to_action": { "type": "SHOP_NOW", "value": { "link": "https://example.com" } }
    }]
  }
}
```

**Example: Multiple images** (Meta auto-selects per impression; Contrast hook variant)
```json
{
  "creative_config": {
    "name": "Multi-Image Flexible Ad",
    "page_id": "PAGE_ID",
    "instagram_user_id": "IG_ID"
  },
  "creative_asset_groups_spec": {
    "groups": [{
      "images": [
        { "url": "CDN_URL_IMAGE_1" },
        { "url": "CDN_URL_IMAGE_2" }
      ],
      "texts": [
        { "text": "Tired of a brittle beard? Aloe & Shea stops breakage.", "text_type": "primary_text" },
        { "text": "I used to hide my beard. Then I found Aloe & Shea.", "text_type": "primary_text" },
        { "text": "Old oil vs new formula — the difference is night and day.", "text_type": "primary_text" },
        { "text": "Say goodbye to brittle! Aloe & Shea restores softness.", "text_type": "primary_text" },
        { "text": "Stronger Beard in 7 Days", "text_type": "headline" },
        { "text": "Built for Beards That Break", "text_type": "headline" },
        { "text": "Say Goodbye to Brittle", "text_type": "headline" }
      ],
      "call_to_action": { "type": "SHOP_NOW", "value": { "link": "https://example.com" } }
    }]
  }
}
```

**Rules:**
- Each group requires: at least 1 image or video, `texts` array, `call_to_action` with `type` and `value.link`
- Each text entry requires `text` and `text_type` ("primary_text", "headline", or "description")
- Per-group limits: primary_text ≤ 5, headline ≤ 5, description ≤ 5, images ≤ 10, videos ≤ 10
- Character limits: primary_text ≤ 125, headline ≤ 40
- **No `is_dynamic_creative` needed** — works with any standard ad set
- Cannot be combined with `asset_feed_spec`

### asset_feed_spec — Legacy DCO or placement-specific assets

For multiple text variations, prefer `creative_asset_groups_spec` above. Only use `asset_feed_spec` for placement-specific asset customization rules or if you specifically need DCO.

`asset_feed_spec` requires the parent ad set to have `is_dynamic_creative: true`. If the ad set doesn't have this flag, Meta rejects with error code 100.

**Rules:**
- Requires: `ad_formats`, at least 1 image/video, `bodies`, `titles`, `link_urls`
- Limits: bodies ≤ 5, titles ≤ 5, descriptions ≤ 5, images ≤ 10, videos ≤ 10, link_urls ≤ 5
- `asset_customization_rules`: min 2 rules, labels must match actual images/videos

### CDN Auto-Upload
- Images: `{ url: "CDN_URL" }` → auto-uploaded to `{ hash: "IMAGE_HASH" }` during execution
- Videos: `{ video_url: "CDN_URL" }` → auto-uploaded to `{ video_id: "ID" }` during execution

---

## Quality Framework (Step 6)

Address the reader, not the product. Primary text structure: **Hook → Proof → CTA** (125 chars). Line 1 must make the reader say "that's me"; never open with product name or "Introducing...". One emoji per line, max 3, none on proof line, none in headlines. Premium brands (existing winning ads have zero emojis) → drop emojis entirely.

**Hook archetypes** (use a different one per ad in batched variants):

| Archetype | When `text_hook` / `product_featured` signals... | Pattern |
|---|---|---|
| Relatability | pain words: "tired", "struggling", "frustrated" | "Tired of [pain]?" |
| Confession | personal-switch story | "I used to [pain]. Then I [switch]." |
| Contrast | "vs", "instead of", "better than" | "[Old] vs [new]" |
| Curiosity | "hidden", "secret", "why" | "The hidden reason [X]..." |
| Bold Claim | "most X fail", category-redefining product | "WARNING: [uncomfortable truth]" |
| Imperative | default fallback | "Say goodbye to [pain]!" |

**Headline (≤40 chars):** sharp promise, sentence case, no emoji. Templates: "[Benefit] in [time]" / "Built for [audience]" / "[Action] without [pain]".

**Example (118 chars):** "Tired of a brittle beard? Aloe & Shea stops breakage at the root. Ready for a fuller look?"

**Before calling propose, verify:** exactly 4 primary texts + 3 headlines · ≤125/≤40 chars · each primary text uses a different hook archetype · each headline uses a different angle · Line 1 is a hook (not product description) · one concrete proof (ingredient/feature/number) · reader-first voice · user-provided text kept as one variation.

---

## Catalog Ad Flow (DPA / catalog / product feed ads)

Routed here from the branch decision at the top. Catalog ads pull product images and metadata from a Meta product catalog at serve time — they do NOT use uploaded creative assets and do NOT use `creative_asset_groups_spec`.

### Step C1 — Pre-flight: scope + catalog availability

Call `facebook_list_product_catalogs(act_id)`.

- ✅ Success with catalogs → continue to Step C2.
- ❌ `(#100) Requires business_management permission to access the field` (or `Requires catalog_management permission`) → the tool response includes a reconnect URL. **Show that URL to the user verbatim, explain that catalog ads need updated Meta permissions, and STOP.** Do NOT retry. Do NOT attempt any fallback. The user must reconnect before catalog ads will work.
- ❌ `NO_BUSINESS` → the ad account isn't associated with a Meta Business Manager. Tell the user: *"Catalog ads require a Meta Business Manager. Please set one up at business.facebook.com and associate this ad account with it."* STOP.
- ❌ `total: 0` (business exists but no catalogs) → tell the user: *"This business has no product catalogs. Please create one in Meta Commerce Manager first."* STOP.

### Step C2 — Pick catalog + product set

- Multiple catalogs → ask via `user_input` select with `label` = catalog name (include `product_count` if useful), `value` = catalog id.
- Exactly 1 catalog → use it.
- Call `facebook_list_product_sets(catalog_id)`. One set → use it. Multiple → ask via select.
- Capture BOTH `id` (→ `product_set_id`) AND `name` (→ `product_set_name`) from the chosen product set.

### Step C3 — Resolve page + Instagram

Same resolution chain as standard Step 2b. Both `page_id` and `instagram_user_id` are required for catalog ads as well.

### Step C4 — Build the catalog creative

Catalog ads use `object_story_spec.template_data` — NOT `creative_asset_groups_spec`. Meta fills templates at serve time from each product's catalog row. Do NOT ask for creative asset upload — catalog ads pull images from the catalog automatically.

```json
{
  "creative_config": {
    "name": "Catalog Ad - {ProductSetName}",
    "page_id": "PAGE_ID",
    "instagram_user_id": "IG_ID",
    "product_set_id": "PRODUCT_SET_ID",
    "product_set_name": "PRODUCT_SET_NAME",
    "object_story_spec": {
      "page_id": "PAGE_ID",
      "instagram_user_id": "IG_ID",
      "template_data": {
        "message": "Shop our {{product.name}} — now {{product.price}}",
        "link": "{{product.url}}",
        "name": "{{product.name}}",
        "description": "{{product.description}}",
        "call_to_action": { "type": "SHOP_NOW" }
      }
    }
  }
}
```

**Template variables available**: `{{product.name}}`, `{{product.price}}`, `{{product.url}}`, `{{product.description}}`, `{{product.brand}}`, `{{product.image[0].url}}`. Use them in `message`, `name`, `description`. The `link` field MUST be `{{product.url}}` so each card deep-links to its own PDP.

**Rules for catalog ads:**
- DO NOT include `image_url`, `video_url`, `headline`, `primary_text`, `landing_page_url`, or `creative_asset_groups_spec` — they conflict with `template_data` or are ignored.
- DO NOT generate 4×3 text variations — catalog ads use a single template_data block per ad.
- `product_set_name` is display-only; it's used by the approval UI alongside `product_set_id` so the user sees the human-readable name. It is not sent to Meta's Graph API.
- Default CTA is `SHOP_NOW`; switch to `LEARN_MORE` only if the creative analysis context suggests educational content.

### Step C5 — Propose

Same `facebook_propose_create_ad_with_creative` call. All catalog-specific fields (`product_set_id`, `product_set_name`, `template_data`) render as non-editable rows in the approval UI.

---

## Output After Full Creation Flow

Short crisp summary after the creation.

## Error Handling

Transient Meta API errors (code 2 "Please retry your request later", network errors) are automatically retried up to 2 times with backoff. No action needed from the LLM.

| Error | Action |
|-------|--------|
| `page_id is required in creative_config` (601) | LLM did not resolve page_id before calling. Follow the Step 2b resolution chain and retry. |
| `instagram_user_id is required in creative_config` (601) | LLM did not resolve instagram_user_id before calling. Follow the Step 2b resolution chain. |
| `Facebook Page {id} is not accessible` (601) | page_id is invalid or the connection lacks permission. Verify in Meta Business Suite or use `facebook_page_list` to find valid IDs. |
| `Instagram profile {id} is not accessible` (601) | instagram_user_id is invalid or unlinked. Verify the IG account is linked to the Facebook Page in Meta Business Suite. |
| `(#100) Requires business_management permission` / `Requires catalog_management permission` | Catalog-ads scope error. The tool response includes a reconnect URL — show it to the user verbatim and STOP. Do NOT retry until reconnect. |
| `NO_BUSINESS` (from `facebook_list_product_catalogs`) | Ad account not linked to a Meta Business Manager. Tell user to set one up at business.facebook.com. STOP. |
| `total: 0` catalogs (from `facebook_list_product_catalogs`) | No catalogs exist. Tell user to create one in Meta Commerce Manager. STOP. |
| `Dynamic creative ad sets allow for one active ad at most` | Parent ad set has `is_dynamic_creative: true` but you used `asset_feed_spec`. Use `creative_asset_groups_spec` instead — no DCO ad set needed. |
| `Only dynamic creative ads can be created as the ad set is a dynamic creative ad set` | The ad set has `is_dynamic_creative: true` but you sent flat fields. Use `asset_feed_spec` for DCO ad sets, or switch to `creative_asset_groups_spec` with a standard ad set. |
| `Cannot use both creative_asset_groups_spec and asset_feed_spec` | Pick one: `creative_asset_groups_spec` (preferred, no DCO needed) OR `asset_feed_spec` (legacy, needs DCO ad set). |
| `Please specify one of image_hash or image_url in the video_data` | Video thumbnail generation failed. Server auto-retries with Meta's thumbnails; if all fail, provide thumbnail image URL manually. |
| `An unexpected error has occurred. Please retry your request later` (code 2) | Auto-retried by the server. If persistent after retries, wait and try again. |

When to use

Prepare Meta ads with single-image/video or catalog creatives under an existing ad set. Use Ad Brief Production for creator instructions.

What you get

The complete original GoMarble guidance, with source attribution and declared limits.

How it works

Clarify scope, use available evidence, and apply the relevant source workflow within actual user authorization.

Requirements

Ad-set context, approved asset rights, destination, offer, CTA and applicable advertising constraints.

Delivery and review notes

Auto-detected URLs, tracking parameters, claims and assets must be verified against the intended offer. Upload only authorized assets. This source assumes missing creation tools; it does not install or call them. GoMarble connectors, referenced sibling skills and runtime dependencies are not bundled or installed by M11. Brief obvious-danger screening only; no functional test or comprehensive safety certification. Loading this text authorizes no external calls, account mutations or ad spend.

Starting prompt

Use Meta Ad and Creative Planning for [TASK]. Clarify Ad-set context, approved asset rights, destination, offer, CTA and applicable advertising constraints. Separate observed evidence from heuristics and recommendations. Check actual connector availability and approval semantics before any external action.

Not for

Claiming installed GoMarble tools, proven campaign outcomes or authorization to launch ads merely from loading this source.

What M11 added

German routing and explicit scope. Original attribution: GoMarble. Auto-detected URLs, tracking parameters, claims and assets must be verified against the intended offer. Upload only authorized assets. This source assumes missing creation tools; it does not install or call them. GoMarble connectors, referenced sibling skills and runtime dependencies are not bundled or installed by M11. Brief obvious-danger screening only; no functional test or comprehensive safety certification. Loading this text authorizes no external calls, account mutations or ad spend.

Original authorship remains with gomarble-ai/marketing-agent · Original source ↗

Original license & copyright

MIT License

Copyright (c) 2026 GoMarble

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Source SHA-256: a67a7a84530703de645815f669b61258f8db50a0bd57557d90ac7de1408a1e7b
Snapshot checked: 2026-09-28T16:19:52.867Z

Find a skill.Get to work.

All skills

Multi-Agent Orchestration

AI Context Window Audit

AI Agent Architecture Audit

AI Skill Discovery

Lead Magnet Strategy

Ideal Customer Profile

Go-to-Market Strategy

Marketing Campaign Ideas

Product Growth Loops

Competitor Analysis

North Star Metric

Product Positioning

Product Vision

Go-to-Market Motion Selection

Customer Feedback and JTBD Analysis

PESTLE Market Environment Analysis

Customer Journey Mapping

Ansoff Growth Options

Data Analysis Validation

Dataset Profiling

Statistical Analysis Guidance

Programmatic SEO Planning

Landing Page and Form Conversion Review

Paywall and Upgrade Planning

Signup and Registration Review

User Onboarding and Activation

Popup and Modal Planning

Email Sequence Copy and Flow

Marketing Campaign Planning

Marketing Content Drafting

Brand Voice and Content Review

Marketing Performance Reporting

Sales Company Research

Company and Contact Enrichment

Website Information Architecture

Content Strategy and Editorial Roadmap

Product Launch Planning

Customer Research and Voice of Customer

Community Growth and Member Experience

Competitor Research Profiles

Roadmap and Release Communication

Lifecycle Email Sequences

API Contracts and Interface Design

Observability and Instrumentation Planning

Agent Context and Session Handoff

Product Discovery Sprint

Deal Quality Scoring

Enrichment Waterfall Design

Customer Retention Playbook

Sales Coaching Practice

Revenue Cohort Analysis

Intent Signal Scoring

Customer Identity Matching

Segment Activation Planning

Sales Call Review

Retention Dashboard Design

Sales Coaching Competencies

Offer Delivery Design

Offer Value Communication

Service Productization

Conversion Hypothesis Prioritization

Braze Engagement Guidance

Brand Voice Guide Design

Content Pipeline Orchestration

Website Brand Profile

Buyer Objection Clarification

Klaviyo Integration Guidance

Offer Bonus Planning

Klaviyo Marketing Review

Cross-Platform Advertising Review

Expertise Business Model

LinkedIn Advertising Guidance

TikTok Advertising Guidance

Evidence Research Brief

Cinematic Video Prompts

Visual Prompt Model Adaptation

Visual Prompt Diagnostics

Short Film Development

Find a skill.
Get to work.