# Send Ad-Ready Pro to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ad-ready-pro",
    "name": "Ad-Ready Pro",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/PauldeLavallaz/ad-ready-pro",
    "canonicalUrl": "https://clawhub.ai/PauldeLavallaz/ad-ready-pro",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ad-ready-pro",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ad-ready-pro",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/generate.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ad-ready-pro",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T01:48:04.166Z",
      "expiresAt": "2026-05-06T01:48:04.166Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ad-ready-pro",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ad-ready-pro",
        "contentDisposition": "attachment; filename=\"ad-ready-pro-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ad-ready-pro"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ad-ready-pro"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ad-ready-pro",
    "downloadUrl": "https://openagent3.xyz/downloads/ad-ready-pro",
    "agentUrl": "https://openagent3.xyz/skills/ad-ready-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ad-ready-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ad-ready-pro/agent.md"
  }
}
```
## Documentation

### Ad-Ready: AI Advertising Image Generator

Generate professional advertising images from product URLs using a 4-phase AI pipeline on ComfyDeploy.

### ⚠️ CRITICAL: Required Inputs Checklist

Before running ANY ad generation, the agent MUST ensure ALL of these are provided:

InputRequired?How to Get It--product-url✅ ALWAYSUser provides the product page URL--product-image✅ ALWAYSDownload from the product page, or user provides--logo✅ ALWAYSDownload from brand website or search online. MUST be an image file--reference✅ RECOMMENDEDAn existing ad whose style we want to clone. Search online or use previously generated images--brand-profile✅ NEVER EMPTYPick from catalog or run brand-analyzer first. NEVER leave as "No Brand" if a brand is known--prompt-profile✅ ALWAYSChoose based on campaign objective--aspect-ratioDefault: 4:5Change if needed for platform--modelOptionalModel/talent face from catalog or user-provided

### 🚨 NEVER Skip These Steps:

Product image — Download the main product photo from the product URL. The scraper is fragile; always provide a product image explicitly.
Brand logo — Download the logo from the brand's official website or search for "{brand name} logo" online. Must be a clean logo image (PNG preferred).
Brand profile — If the brand doesn't exist in the catalog, run brand-analyzer skill FIRST to generate one. Never submit with "No Brand" when a brand is known.
Reference image — Search for an existing ad or visual with a style that matches what we're generating. Can be from previously generated images, the brand's campaigns, or found online. This dramatically improves output quality.

### Auto-Preparation Workflow

When the user asks to generate an ad, follow this workflow:

1. User provides: product URL + brand name + objective

2. CHECK brand profile exists:
   → ls ~/clawd/ad-ready/configs/Brands/ | grep -i "{brand}"
   → If not found: run brand-analyzer skill first
   
3. DOWNLOAD product image:
   → Visit the product URL in browser or fetch the page
   → Find and download the main product image
   → Save to /tmp/ad-ready-product.jpg

4. DOWNLOAD brand logo:
   → Search "{brand name} logo PNG" or fetch from brand website
   → Download clean logo image
   → Save to /tmp/ad-ready-logo.png

5. FIND reference image:
   → Search for "{brand name} advertisement" or similar
   → Or use a previously generated ad that has the right style
   → Save to /tmp/ad-ready-reference.jpg

6. SELECT prompt profile based on objective:
   → Awareness: brand discovery, first impressions
   → Interest: engagement, curiosity
   → Consideration: comparison, features
   → Evaluation: deep dive, decision support
   → Conversion: purchase intent, CTAs (most common)
   → Retention: re-engagement
   → Loyalty: brand advocates
   → Advocacy: referral, community

7. RUN the generation with ALL inputs filled

### Full command (recommended):

COMFY_DEPLOY_API_KEY="$KEY" uv run ~/.clawdbot/skills/ad-ready/scripts/generate.py \\
  --product-url "https://shop.example.com/product" \\
  --product-image "/tmp/product-photo.jpg" \\
  --logo "/tmp/brand-logo.png" \\
  --reference "/tmp/reference-ad.jpg" \\
  --model "models-catalog/catalog/images/model_15.jpg" \\
  --brand-profile "Nike" \\
  --prompt-profile "Master_prompt_05_Conversion" \\
  --aspect-ratio "4:5" \\
  --output "ad-output.png"

### Auto-fetch mode (downloads product image and logo automatically):

COMFY_DEPLOY_API_KEY="$KEY" uv run ~/.clawdbot/skills/ad-ready/scripts/generate.py \\
  --product-url "https://shop.example.com/product" \\
  --brand-profile "Nike" \\
  --prompt-profile "Master_prompt_05_Conversion" \\
  --auto-fetch \\
  --output "ad-output.png"

The --auto-fetch flag will:

Download the main product image from the product URL
Search and download the brand logo
Both get uploaded to ComfyDeploy automatically

### API Details

Endpoint: https://api.comfydeploy.com/api/run/deployment/queue
Deployment ID: e37318e6-ef21-4aab-bc90-8fb29624cd15

### ComfyDeploy Input Variables

These are the exact variable names the ComfyDeploy deployment expects:

VariableTypeDescriptionproduct_urlstringProduct page URL to scrapeproductoimage URLProduct image (uploaded to ComfyDeploy)modelimage URLModel/talent face referencereferenciaimage URLStyle reference ad imagemarcaimage URLBrand logo imagebrand_profileenumBrand name from catalogprompt_profileenumFunnel stage promptaspect_ratioenumOutput format

### Phase 1: Product Scraping

Gemini Flash visits the product URL
Extracts: title, description, features, price, images
⚠️ Image scraping is the most fragile part — always provide product images manually

### Phase 2: Campaign Brief Generation (CRITICAL)

Uses Brand Identity JSON + Product Data → 10-point brief
Everything downstream depends on brief quality
Brief covers: strategic objective, central message, visual tone, product role, photographer, art direction, environment, textures, signature

### Phase 3: Blueprint Generation

Master Prompt (per funnel stage) + Brief + Product JSON + Keyword Bank + Format
Gemini Flash generates complete Blueprint JSON
Covers: scene, production, graphic design, lighting, composition, materials, CTA

### Phase 4: Image Generation

Nano Banana Pro (Imagen 3.0) generates the final image
Uses Blueprint JSON + all reference images (product, talent, logo, style ref)

### Supporting Reference Nodes

pose_ref → enforce a specific pose (replicated exactly)
photo_style_ref → replicate photographic style (⚠️ can be too literal, being optimized)
location_ref → replicate location and color palette

### Existing catalog (70+ brands):

ls ~/clawd/ad-ready/configs/Brands/*.json | sed 's/.*\\///' | sed 's/\\.json//'

### Creating new brand profiles:

Use the brand-analyzer skill:

GEMINI_API_KEY="$KEY" uv run ~/.clawdbot/skills/brand-analyzer/scripts/analyze.py \\
  --brand "Brand Name" --auto-save

This generates a full Brand Identity JSON and saves it to the catalog automatically.

### Prompt Profiles (Funnel Stages)

ProfileStageBest ForMaster_prompt_01_AwarenessAwarenessBrand discovery, first impressionsMaster_prompt_02_InterestInterestEngagement, curiosityMaster_prompt_03_ConsiderationConsiderationComparison, featuresMaster_prompt_04_EvaluationEvaluationDeep dive, decision supportMaster_prompt_05_ConversionConversionPurchase intent, CTAsMaster_prompt_06_RetentionRetentionRe-engagement, loyaltyMaster_prompt_07_LoyaltyLoyaltyBrand advocatesMaster_prompt_08_AdvocacyAdvocacyReferral, community

How to choose:

Most ads → Conversion (purchase intent)
New product launches → Awareness
Retargeting → Consideration or Evaluation
Existing customers → Retention or Loyalty

### Aspect Ratios

RatioUse Case4:5Default. Instagram feed, Facebook9:16Stories, Reels, TikTok1:1Square posts16:9YouTube, landscape banners5:4Alternative landscape

### Model Catalog

Models for talent/face reference: ~/clawd/models-catalog/catalog/

Priority: User-provided model > Catalog selection > No model (product-only ad)

### Known Limitations

Product image scraping is fragile — always provide product images manually when possible
photo_style_ref can be too literal — the style reference may be replicated too closely
Some websites block scraping — Armani works well, others may return incorrect data
Auto 4-Format is alpha — bugs and edge cases exist
Gemini hallucinations — occasional issues in complex reasoning steps

### Ad-Ready vs Morpheus

FeatureAd-ReadyMorpheusInputProduct URL (auto-scrapes)Manual product imageBrand intelligence70+ brand profilesNoneFunnel targeting8 funnel stagesNoneCreative directionAuto-generated from briefPack-based (camera, lens, etc.)Best forProduct advertising campaignsFashion/lifestyle editorial photographyControl levelHigh-level (objective-driven)Granular (every visual parameter)

### Source Repository

GitHub: https://github.com/PauldeLavallaz/ads_SV
Local clone: ~/clawd/ad-ready/
Patreon docs: https://www.patreon.com/posts/from-product-to-149933468

### API Key

Uses ComfyDeploy API key. Set via COMFY_DEPLOY_API_KEY environment variable.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: PauldeLavallaz
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T01:48:04.166Z
- Expires at: 2026-05-06T01:48:04.166Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ad-ready-pro)
- [Send to Agent page](https://openagent3.xyz/skills/ad-ready-pro/agent)
- [JSON manifest](https://openagent3.xyz/skills/ad-ready-pro/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ad-ready-pro/agent.md)
- [Download page](https://openagent3.xyz/downloads/ad-ready-pro)