---
name: generate-ad-images
description: Generate two distinct, AI-powered image variations for advertising campaigns using Google Gemini's image generation capabilities. Use when creating visual assets for ads based on campaign parameters and research insights. Triggers on requests to generate ad images, create visual assets, produce image variations for A/B testing, or develop platform-specific ad visuals.
---

# Generate Ad Images

Generate two distinct image variations for advertising campaigns using Google Gemini API. Each variation should be visually distinct, platform-optimized, and aligned with campaign goals.

## Workflow

### Step 1: Analyze Campaign Context

Extract from provided parameters:
- **product_or_service**: What is being advertised
- **target_audience**: Who the ad targets
- **platform**: Where ad appears (TikTok, Facebook, Instagram, LinkedIn)
- **creative_direction**: Tone and style requirements
- **kpi**: Success metrics

If research insights provided, incorporate audience behaviors, platform trends, and creative recommendations.

### Step 2: Determine Dimensions

Select dimensions based on platform. See [references/platform-guidelines.md](references/platform-guidelines.md) for full details.

| Platform | Dimensions | Aspect Ratio |
|----------|------------|--------------|
| TikTok | 1080×1920 | 9:16 |
| Instagram Feed | 1080×1080 | 1:1 |
| Instagram Story | 1080×1920 | 9:16 |
| Facebook Feed | 1200×628 | 1.91:1 |
| LinkedIn | 1200×627 | 1.91:1 |

Default to 1080×1080 if no platform specified.

### Step 3: Create Variation A Prompt

Build a detailed image generation prompt including:
- Product/service representation
- Target audience representation (if appropriate)
- Platform-appropriate composition
- Style matching creative direction
- Dimensions specification
- "No text overlays" instruction
- "Leave space for text" instruction

### Step 4: Execute Script for Variation A

Run the Python script:

```bash
python scripts/generate_image.py --prompt "[your prompt]" --variation "A" --aspect-ratio "[ratio]"
```

Aspect ratio options: `1:1`, `3:4`, `4:3`, `9:16`, `16:9`

The script returns JSON with `image_data` (base64), `mime_type`, and `variation_id`.

### Step 5: Create Variation B Prompt

Create a DISTINCT prompt with different:
- Composition or angle
- Visual style or mood
- Focus or emphasis

Variation B must NOT be a minor variation of A. Provide genuine alternative for A/B testing.

### Step 6: Execute Script for Variation B

```bash
python scripts/generate_image.py --prompt "[your prompt]" --variation "B" --aspect-ratio "[ratio]"
```

### Step 7: Determine Recommendation

Analyze both variations and recommend one based on:
- Campaign KPI alignment
- Platform best practices
- Audience appeal from insights

### Step 8: Return JSON Output

**CRITICAL**: Return a raw JSON object as plain text (NOT wrapped in markdown code blocks like \`\`\`json). The output must be valid JSON that can be parsed directly by the calling service.

Return this exact structure:

{
  "generated_at": "ISO timestamp (e.g., 2024-01-15T10:30:00Z)",
  "campaign_name": "name or null",
  "platform": "platform name (lowercase, e.g., tiktok, instagram_feed)",
  "target_audience": "audience description",
  "variations": [
    {
      "variation_id": "A",
      "image_url": "URL from script output (required)",
      "thumbnail_url": "thumbnail URL from script or null",
      "file_id": "file ID from script or null",
      "mime_type": "image/png or image/jpeg",
      "prompt_used": "full prompt used for generation",
      "visual_approach": "brief description of visual approach (1-2 sentences)",
      "dimensions": { "width": 1080, "height": 1920 }
    },
    {
      "variation_id": "B",
      "image_url": "URL from script output (required)",
      "thumbnail_url": "thumbnail URL from script or null",
      "file_id": "file ID from script or null",
      "mime_type": "image/png or image/jpeg",
      "prompt_used": "full prompt used for generation",
      "visual_approach": "brief description of visual approach (1-2 sentences)",
      "dimensions": { "width": 1080, "height": 1920 }
    }
  ],
  "recommended_variation": "A or B",
  "recommendation_rationale": "2-3 sentences explaining why this variation is recommended based on campaign goals, platform best practices, and audience appeal"
}

## References

- **Platform Guidelines**: See [references/platform-guidelines.md](references/platform-guidelines.md) for platform-specific dimensions, optimization tips, and creative direction alignment
- **Examples**: See [references/examples.md](references/examples.md) for complete input/output examples

## Important Notes

- Return raw JSON only, not wrapped in code blocks
- Generate exactly two variations with distinct visual approaches
- Ensure images are platform-optimized with correct dimensions
- Leave space for text overlays (headlines, CTAs)
- Avoid text, logos, or copyrighted elements in generated images
- Match tone and style to creative direction
- Provide clear rationale for recommendation
- Ensure variation B is genuinely different from A


---
Source attribution: feed-mob
Original project: https://github.com/feed-mob/feedmob-adpilot-mcp/blob/91db817053cf7e9e214873eee8a5304c7cedbb57/src/plugins/generate-ad-images/skills/generate-ad-images/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 FeedMob

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.



# Dave AI resource metadata

Creator / publisher: feed-mob
Original project: https://github.com/feed-mob/feedmob-adpilot-mcp/blob/91db817053cf7e9e214873eee8a5304c7cedbb57/src/plugins/generate-ad-images/skills/generate-ad-images/SKILL.md
Attribution basis: Recovered original package and original project license at a pinned revision

Fields of work: Marketing
Roles: Advertising Specialist, Content Marketer, Growth Marketer
Specialties: API
Tools: Google Gemini
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 49f2e84e2368b0c0224a4752621674634920f73f56c8659058a8829065a3bd44
Metadata reviewed: 2026-10-27
This metadata supersedes earlier Dave AI catalog attribution. Original instruction and supporting files are preserved.