OpenParable
Skip to content
← Back to skills

ads generate

Design

ads generate is an Agent Skill for design published in the Miosa-osa/canopy repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

AI image generation for paid ad creatives. Reads campaign-brief.md and brand-profile.json to produce platform-sized ad images using Gemini (default) or a configured provider. Requires GOOGLE_API_KEY or ADS_IMAGE_PROVIDER + matching key. Triggers on: "generate ads", "create images", "make ad creatives", "generate visuals", "create ad images", "generate campaign images", "make the images", "generate from brief"

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Miosa-osa/canopy/blob/HEAD/library/skills/paid-media/ads-generate/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ads-generate, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

/ads generate — AI Ad Image Generator

Generates platform-sized ad creative images from your campaign brief and brand profile. Uses Gemini by default.

Usage

/ads generate
/ads generate --platform meta
/ads generate --prompt "text" --ratio 9:16
/ads generate --batch

Arguments

FlagTypeDefaultDescription
--platformstringallGenerate for specific platform only
--promptstring—Standalone generation without brief
--ratiostring—Aspect ratio for standalone mode
--batchflagfalseUse batch API (50% cost, 24h turnaround)

Environment Setup

# Gemini (default)
export GOOGLE_API_KEY="your-key"

# Alternative providers
export ADS_IMAGE_PROVIDER="openai"
export OPENAI_API_KEY="your-key"

export ADS_IMAGE_PROVIDER="stability"
export STABILITY_API_KEY="your-key"

export ADS_IMAGE_PROVIDER="replicate"
export REPLICATE_API_TOKEN="your-token"

Process

Step 1: Check API Key

Verify the required environment variable is set before proceeding. If not set, display setup instructions and stop.

Step 2: Locate Source Files

Check for:

  • campaign-brief.md — primary source for prompts and dimensions
  • brand-profile.json — brand color/style injection (optional but recommended)

If no campaign-brief.md: enter standalone mode (ask for prompt, platform, filename).

Step 3: Parse Image Generation Briefs

From ## Image Generation Briefs section of campaign-brief.md, extract each brief's prompt, dimensions, and safe zone notes.

Step 4: Generate Images

For each brief, call the image generation API with:

  • Constructed prompt (brief prompt + brand DNA injection)
  • Platform-correct dimensions
  • Output path: ./ad-assets/[platform]/[concept]/[filename].png

Step 5: Validate Formats

Check all generated images against platform spec requirements (dimensions, file size).

Step 6: Report Results

Generation complete:

  Generated assets:
    ./ad-assets/meta/concept-1/feed-1080x1350.png
    ./ad-assets/tiktok/concept-1/vertical-1080x1920.png

  Cost estimate: ~$[N] at $0.067/image (Gemini)

  Next steps:
    1. Review assets in ./ad-assets/
    2. Upload to your ad platform managers

Platform Dimensions (Standalone Mode)

meta-feed     -> 1080x1350 (4:5)
meta-reels    -> 1080x1920 (9:16)
tiktok        -> 1080x1920 (9:16)
google-pmax   -> 1200x628 (1.91:1)
linkedin      -> 1080x1080 (1:1)
youtube       -> 1280x720 (16:9)
youtube-short -> 1080x1920 (9:16)

Cost Transparency

Before generating, estimate and show the cost:

  • Count image briefs x $0.067 (Gemini default)
  • If >$1.00, ask for confirmation before proceeding

Dependencies

  • brand-profile.json — from /ads dna
  • campaign-brief.md — from /ads create
  • Image generation API key (see Environment Setup)