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.
The tunnel uses the same cards as the catalogue. Browse only as deep as needed — or load a broad bundle immediately.
SEO, Sales, Agents or another broad area → one bundle call → work.
Read-only access to published skills. Default 8, maximum 10 skills / 120,000 characters.
Compact two-skill starter: clarify positioning and choose a lead magnet. Use Marketing Launch for the broader eight-skill go-to-market workflow.
Build an evidence-led marketing plan from ICP and competition through positioning, campaigns, growth and measurement.
Diagnose architecture and context, plan agent-team responsibilities, then organize project context and session handoffs. Memory and cost-runtime reviews remain outside this pack.
Review the journey from landing page and lead capture through registration, first value and transparent upgrades.
Plan a campaign, draft its channel content and review the work against actual brand guidance.
Prioritize an editorial roadmap and plan how to launch and distribute it across suitable channels.
Understand customer needs, compare competitors and plan a community around real member value.
Choose a relevant lead magnet, then draft a permission-based nurture journey with entry, suppression and exit rules.
Define the API contract, then plan how to observe its latency, failures and retries. Guidance and checklist; no production changes.
Profile a dataset, choose and interpret statistical methods, then validate calculations and conclusions before sharing.
Define the target account, prioritize buying signals, plan a human LinkedIn engagement routine and prepare evidence-led responses to buyer concerns.
Plan brand-grounded ad copy and image generation through HyperFX; use Ad Brief Production for creator-facing production instructions.
---
name: ad-creative-generation
description: Generate on-brand ad creatives — visuals + copy — for Google, Meta (Facebook / Instagram), and other paid platforms via the Hyper MCP. Extracts brand identity from a website, writes ad copy variants, and produces brand-consistent images using reference-based image generation. Use when the user asks for ad creative, ad copy variants, RSA headlines, Meta ad creative, display ads, carousel ads, or A/B test variants.
metadata:
version: 1.0.0
requires_toolkits:
- image_gen
icon: image_gen
short_description: Brand extraction, ad copy variants, and on-brand images for Google and Meta placements.
---
# Ad Creative Generation
Generate ad creatives — both visuals and copy — that match a brand's identity. This skill orchestrates brand extraction, copywriting, and image generation into a single workflow.
## Requirements
This skill assumes the [Hyper MCP](https://app.hyperfx.ai/mcp) is connected to your agent so the tools below are available. Brand extraction also requires Firecrawl to be configured under your Hyper integrations.
### How to run the tools in this skill
Every tool in this skill is named by its canonical tool name. Run it with the call your surface gives you:
| Surface | Find a tool | Run it |
| --- | --- | --- |
| MCP client (Claude, Cursor, Codex, ChatGPT) | `search("<what you want to do>")`, then `describe("<name>")` | `call("<name>", {...})` |
| Hyper CLI | `hyperai search "<what you want to do>"`, then `hyperai describe <name>` | `hyperai call <name> --json '{...}'` |
If a tool is not found, its integration is not connected or not enabled for the workspace: stop and tell the user which integration to connect.
## Tool surface
| Group | Tools |
|-------|-------|
| Brand extraction | `firecrawl_branding_extract` |
| Archetype recommendations (conditional) | `cmo_ad_brief` |
| Competitor ad tracking (conditional) | `cmo_ads_track`, `cmo_ads_tracked_list` |
| Image generation (default) | `images_generate` (`model="gpt-image-2"`) |
| Image generation (text-heavy) | `images_generate` (`model="nano-banana-pro"`) |
| Image generation (photoreal product shots) | `images_generate` (`model="seedream-4.5"`) |
The `cmo_*` tools are conditional — they appear when the CMO toolkit is
enabled in the workspace. When absent, skip them and use the reference
frameworks; do not fail the workflow.
For deeper image-tool selection guidance see the `image-generation` skill. To turn finished creatives into running campaigns see `google-ads` and `meta-ads`.
## Out of scope
- Picking the right image model when the task isn't ad creative — use `image-generation`.
- Creating, launching, or budgeting actual ad campaigns — use `google-ads`, `meta-ads`, `tiktok-ads`, `pinterest-ads`, or `amazon-ads`.
- Searching live competitor ads — use `meta-ads-library`; to save and monitor competitor ads cross-platform (Meta + Google Ads Transparency, durable creatives, longevity ranking), use `cmo_ads_track` / `cmo_ads_tracked_list` when the CMO toolkit is enabled.
## Critical rules
- **Always extract branding first** before generating visuals for a website/brand.
- **Always pass both logo and screenshot** as reference images — SVG logos are auto-converted to PNG.
- **DO NOT display image URLs** — they are automatically shown in chat.
- **Read `brand.screenshot.description`** to understand the product — never guess from the company name.
- **Default to logo + headline + product screenshot** for SaaS / product ads unless the user requests a different style.
- **Use `model="gpt-image-2"` for the initial ad creative by default** — with reference images for branded work, or without for loose first-pass concepts.
- **Do not default to `model="nano-banana-pro"` for the first creative pass** — use it when the user explicitly asks or when readable text inside the image is the main requirement.
- **Set `aspect_ratio` to the placement** — `1:1` (feed), `9:16` (story), `16:9` (banner) — and `quality` (`"draft" | "standard" | "high"`); `images_generate` takes those, not raw pixel sizes.
- **Respect character limits** — Google RSA headlines are 30 chars, descriptions 90 chars; Meta primary text is 125 chars visible.
- **Change one variable per variant** so test results are attributable.
- **Match aspect ratio to placement** — feed is 1:1, story is 9:16 (use `1024x1536`), banner is 16:9 (use `1536x1024`).
## Routing Table
Based on what the user needs, read the appropriate reference file:
| User Need | Reference |
|-----------|-----------|
| "Extract branding from this site" / brand colors, logo | `references/brand-extraction.md` |
| "Write ad copy" / headlines / variants / hooks | `references/ad-copy-frameworks.md` |
| Google RSAs / display ads / Performance Max assets | `references/google-ads-creatives.md` |
| Meta / Facebook / Instagram ads / carousel / stories | `references/meta-ads-creatives.md` |
When the task spans multiple areas (e.g., "create ad creatives for this website"), follow the full workflow below.
## Core Workflow
### Phase 1: Brand Extraction
Call `firecrawl_branding_extract` with the website URL. This single call returns branding data, a saved logo, and a website screenshot:
```python
brand = firecrawl_branding_extract(url="https://example.com")
```
The result contains:
- `brand.logo.file_id` — logo image to use as reference
- `brand.screenshot.file_id` — website screenshot to use as reference
- `brand.branding` — colors, typography, spacing, personality
Both `logo` and `screenshot` are saved images ready to pass as `reference_images` to image generation tools. SVG logos are automatically converted to PNG, so always include the logo — no need to filter by format.
**For deeper guidance on brand extraction, read `references/brand-extraction.md`.**
### Phase 2: Ad Copy Generation
**If `cmo_ad_brief` is available, call it first** — it returns ranked ad
archetypes for the brand's goal and platform with the reasoning, hook
examples, structure beats, dos/donts, and a generation prompt already
grounded in the brand's saved data:
```python
brief = cmo_ad_brief(goal="drive conversions", platform="meta", url="https://example.com")
```
Build the copy variants and visual direction on the recommended archetypes
(`brief.recommendations[n].prompt` is a ready generation prompt; unresolved
placeholders are listed per recommendation). If the tool is not available,
work from `references/ad-copy-frameworks.md` instead.
Using the brand personality, tone, and value proposition from the extraction, write ad copy variants. Structure copy by what's being tested:
1. **Hook variants** — different opening angles (number-led, question, pain-point, benefit-first)
2. **Body variants** — different messaging (social proof, feature highlight, urgency)
3. **CTA variants** — different calls to action (Learn More, Shop Now, Get Started, Try Free)
Change only one element per variant so results can be attributed to specific changes.
**For copy frameworks, hook patterns, and variant strategy, read `references/ad-copy-frameworks.md`.**
### Phase 3: Visual Creative Generation
Generate ad images using brand assets as references. Always pass **both logo and screenshot** as reference images — SVG logos are automatically converted to PNG by the branding tool.
**Read `brand.screenshot.description`** to understand what the product actually does and what the UI looks like. Do not guess from the company name.
**Preferred first pass: `images_generate` with `model="gpt-image-2"`**
#### Default approach (best practice for SaaS / product ads)
By default, a strong ad creative has three layers: **brand** (logo), **copy** (headline), and **product** (realistic screenshot showing the core value prop). This is the recommended starting point when the user hasn't specified a creative direction. Use `model="gpt-image-2"` for this initial composition unless the user explicitly asks for another model or the image is primarily a text-rendering task.
```python
images_generate(
requests=[{
"prompt": (
"Social media ad creative for [company name]. "
"Top: the [company] logo. "
"Headline: '[headline from ad copy phase or site hero text]'. "
"Below the headline: a clean, realistic product screenshot of [describe the actual UI "
"based on brand.screenshot.description]. "
"Match the brand style from the references."
),
"reference_images": [brand.logo.file_id, brand.screenshot.file_id]
}],
model="gpt-image-2",
aspect_ratio="1:1",
quality="high"
)
```
#### Following user direction
If the user asks for a specific creative style (lifestyle imagery, abstract, illustration, people using the product, etc.), follow their direction. The defaults above are a starting point, not a constraint. The reference images still supply brand consistency regardless of creative direction.
#### Things to avoid (unless the user specifically asks)
- Made-up visual elements (robot mascots, random platform logos, abstract graphics)
- UI chrome (buttons, nav bars, form inputs) — ad platforms add their own CTAs
- Guessing what the product does from the company name
- Generic marketing clip art
## Visual Tool Selection
| Scenario | Tool | Why |
|----------|------|-----|
| On-brand creative (default) | `images_generate` (`model="gpt-image-2"`) with logo + screenshot refs | Best default for the first branded concept |
| Text-heavy creative (headlines in image) | `images_generate` (`model="nano-banana-pro"`) | Use only when text rendering inside the image is the main requirement |
| Quick ideation / concept exploration | `images_generate` (`model="gpt-image-2"`) | Fast first-pass concepting with no references needed |
| Iterative refinement of existing image | `images_generate` (`model="nano-banana"`) with the image as a reference | Edit a specific generated image |
| Photoreal product shots / material detail | `images_generate` (`model="seedream-4.5"`) | Strong fabric/texture/spatial depth |
## Platform Quick Reference
| Platform | Format | Image Size | Key Limits |
|----------|--------|-----------|------------|
| Meta Feed | 1:1 | 1080x1080 | Primary text: 125 chars visible |
| Meta Story | 9:16 | 1080x1920 | Full screen, 15s max |
| Meta Carousel | 1:1 | 1080x1080 | Up to 10 cards |
| Google RSA | N/A (text only) | N/A | 15 headlines (30 chars), 4 descriptions (90 chars) |
| Google Display | Various | 1200x628 | Responsive display ads |
**For full platform specs, read `references/google-ads-creatives.md` or `references/meta-ads-creatives.md`.**
## Ad Copy Variant Quick Reference
When generating variants from existing top performers:
1. Identify the winning elements: hook type, CTA, messaging angle, format
2. Generate variants that preserve winning elements while changing one variable
3. Group variants by what's being tested (hook, body, CTA)
4. Pair variants for A/B testing — each pair should isolate one variable
**For detailed frameworks, read `references/ad-copy-frameworks.md`.**
- **Follow user direction** — if the user wants lifestyle, illustration, abstract, or any other style, follow their lead. The reference images still supply brand consistency regardless of creative direction.
Plan brand-grounded ad copy and image generation through HyperFX; use Ad Brief Production for creator-facing production instructions.
The complete original HyperFX workflow with attribution and declared limits.
Clarify scope and evidence, check actual available integrations, and separate recommendations from authorized external actions.
Brand/destination evidence, authorized reference assets, platform formats and connected image-generation tools.
Generated images/copy are unverified drafts; no campaign is launched. Use authorized likeness/reference assets and substantiate advertised claims. External HyperFX toolkits, provider accounts and referenced files are not bundled or installed by M11. M11 supplies read-only source text, not those execution tools. Brief obvious-danger screening only; no functional test or comprehensive safety certification.
Use HyperFX Ad Creative Workflow for [TASK]. Clarify Brand/destination evidence, authorized reference assets, platform formats and connected image-generation tools. Check the actual provider/tool contract. Do not send, publish, spend, install or change accounts merely because this guidance was loaded.
Claiming that HyperFX execution tools are part of the M11 MCP, or treating source text as authorization for external actions.
German routing, connector distinction and actual-action boundaries. Original attribution: hyperfx.ai. Generated images/copy are unverified drafts; no campaign is launched. Use authorized likeness/reference assets and substantiate advertised claims. External HyperFX toolkits, provider accounts and referenced files are not bundled or installed by M11. M11 supplies read-only source text, not those execution tools. Brief obvious-danger screening only; no functional test or comprehensive safety certification.
MIT License Copyright (c) 2026 hyperfx.ai 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.
Copy the text below, then paste it into your chat.