# Send Ad-Ready 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",
    "name": "Ad-Ready",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/PauldeLavallaz/ad-ready",
    "canonicalUrl": "https://clawhub.ai/PauldeLavallaz/ad-ready",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ad-ready",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ad-ready",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "configs/Brief_Generator/brief_prompt.json",
      "configs/Product_to_Ads/Master_prompt_01_Awareness.json",
      "configs/Product_to_Ads/Master_prompt_02_Interest.json",
      "configs/Product_to_Ads/Master_prompt_03_Consideration.json",
      "configs/Product_to_Ads/Master_prompt_04_Evaluation.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ad-ready",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T08:55:04.842Z",
      "expiresAt": "2026-05-06T08:55:04.842Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ad-ready",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ad-ready",
        "contentDisposition": "attachment; filename=\"ad-ready-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ad-ready"
      },
      "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"
    },
    "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",
    "downloadUrl": "https://openagent3.xyz/downloads/ad-ready",
    "agentUrl": "https://openagent3.xyz/skills/ad-ready/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ad-ready/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ad-ready/agent.md"
  }
}
```
## Documentation

### Ad-Ready: AI Advertising Image Generator

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

Source: github.com/PauldeLavallaz/ads_SV

### Pipeline Architecture

The pipeline runs as a ComfyUI custom node deployed on ComfyDeploy. A single ProductToAds_Manual node executes 4 phases internally:

┌─────────────────────────────────────────────────────────────┐
│                  ProductToAds_Manual Node                     │
│                                                             │
│  PHASE 1: Product Scraping (Gemini Flash)                   │
│  ─────────────────────────────────────────                   │
│  Scrapes product URL → extracts title, description,         │
│  features, price, materials, image URLs                      │
│  Also scrapes HTML for high-res product images (≥1000px)    │
│                                                             │
│  PHASE 2: Campaign Brief Generation (Gemini Flash)          │
│  ────────────────────────────────────────────────            │
│  Brand Identity + Product Data + References →                │
│  10-point Campaign Brief (creative direction)                │
│                                                             │
│  PHASE 3: Blueprint Generation (Gemini Flash)               │
│  ──────────────────────────────────────────────              │
│  Master Prompt (funnel stage) + Brief + Keywords →           │
│  Production-Ready JSON Blueprint                             │
│                                                             │
│  PHASE 4: Image Generation (Nano Banana Pro / Imagen 3)     │
│  ──────────────────────────────────────────────────          │
│  Blueprint + all reference images → final ad image           │
│                                                             │
└─────────────────────────────────────────────────────────────┘

### Phase 2: Campaign Brief (The Creative Brain)

The Brief Generator is the most critical intermediate step. It acts as a "Senior Art Director" that translates raw data into actionable creative direction using a 10-point framework:

Strategic Objective — Why this campaign exists (awareness/positioning/launch)
Central Message — One idea perceivable without text
Visual Tone of Voice — Register: calm/energetic/intimate/monumental
Product Role — Hero vs co-protagonist vs implicit presence
Visual Language & Brand Coherence — Non-negotiable brand codes
Photographer & Equipment — Photography as concept, not execution
Extended Art Direction — Styling, casting, poses, hair/makeup, layout
Environment & Context — Where and why (conceptual, never decorative)
Texture, Material & Product Render — How surfaces are perceived
Final Image Signature — Finish, grain, temporal positioning

Without the brief, the Master Prompt must guess creative strategy. With it, the Master Prompt only executes.

The brief prompt template is included at {baseDir}/configs/Brief_Generator/brief_prompt.json.

### Phase 3: Master Prompts (8 Funnel Stages)

Each funnel stage has a specialized Master Prompt that generates a production-ready JSON Blueprint. All share the same internal simulation:

ROUND -1: Brand Identity Forensics (stages 03+) — Unified Brand Style Manifest
ROUND 0: Fidelity Lock — Product geometry & talent identity are IMMUTABLE
ROUND 1: Stage Strategy — Strategic approach specific to funnel position
ROUND 2: Graphic Design — UI, typography, CTA engineering

The Blueprint JSON covers: scene production, talent lock, camera perspective, subject action/pose/wardrobe, lighting, product constraints, layout architecture, typography, CTA engineering, and brand asset placement.

Master prompt files are included at {baseDir}/configs/Product_to_Ads/.

### Reference Analyzer

Reference images (referencia) are optional and off by default. The pipeline generates creative direction internally from Brand Identity + Campaign Brief. Only use a reference when the user explicitly asks to clone a specific ad's style.

When used, the reference is analyzed for pose, photographic style, and location cues.

### ⚠️ CRITICAL: Required Inputs Checklist

Before running ANY ad generation, ensure 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--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--model🔶 OPTIONALModel/talent face. Ads with talent perform much better. Empty = product-only ad (no person). When used, pick from ~/clawd/models-catalog/catalog/images/ (114 models available)--logo🔶 OPTIONALTry to find it. Use if good quality & easy to get. Skip if low-res or hard to find. Empty = bypassed--reference🔶 OPTIONAL (off)Only when user explicitly asks to clone a reference ad. Empty = bypassed--creative-brief🔶 ON-DEMANDOnly when user gives explicit creative direction. Omit to let pipeline auto-generate from brand profile--language🔶 ON-DEMANDOnly when user requests a specific language. Omit to use default (es)

### 🚨 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 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.
Brand logo — TRY to find it (Clearbit, logo.dev, brand website). Use if good quality. If not found or low-res, skip it — the variable accepts empty string (bypassed server-side).
Reference — Do NOT search for references by default. Only provide when the user explicitly asks to clone a specific ad or says "find a good ad to clone".

### Auto-Preparation Workflow

When the user asks to generate an ad:

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 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. SELECT prompt profile based on objective:
   → 🎨 Morfeo_Creative: DEFAULT — cinematic, narrative-rich, slightly surreal. Best visuals.
   → Awareness: brand discovery, dynamic scenes, world-building, scroll-stoppers
   → Interest: sustained attention, micro-world hinting at use-case
   → Consideration: feature communication, proof cues, informative
   → Evaluation: trust, authority, reviews, certifications
   → Conversion: ⚠️ MINIMAL by design — clean, CTA-dominant, white backgrounds
   → Retention: post-purchase confidence, onboarding
   → Loyalty: editorial, lifestyle, emotional bond
   → Advocacy: share-worthy, community, belonging

   DEFAULT SELECTION LOGIC:
   - Generic "generate an ad" → Morfeo_Creative (09)
   - "awareness" / "brand discovery" → Awareness (01)
   - "conversion" / "buy now" / CTA-focused → Conversion (05)
   - "creative" / "original" / "surreal" → Morfeo_Creative (09)
   - "lifestyle" / "editorial" → Loyalty (07)
   - When in doubt → Morfeo_Creative (09), NOT Conversion

5b. SELECT MODEL (optional):
   → If user wants a person in the ad: pick from ~/clawd/models-catalog/catalog/images/model_XX.jpg (114 available)
   → If user wants product-only ad (no person): leave --model empty
   → If user doesn't specify: ASK if they want a model or product-only
   → Catalog preview: catalog.json at ~/clawd/models-catalog/catalog/catalog.json

6. RUN the generation with ALL inputs filled

### Full command (recommended):

COMFY_DEPLOY_API_KEY="$KEY" uv run {baseDir}/scripts/generate.py \\
  --product-url "https://shop.example.com/product" \\
  --product-image "/tmp/product-photo.jpg" \\
  --logo "/tmp/brand-logo.png" \\
  --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"

### With reference (only when explicitly requested):

COMFY_DEPLOY_API_KEY="$KEY" uv run {baseDir}/scripts/generate.py \\
  --product-url "https://shop.example.com/product" \\
  --product-image "/tmp/product-photo.jpg" \\
  --reference "/tmp/reference-ad.jpg" \\
  --brand-profile "Nike" \\
  --prompt-profile "Master_prompt_01_Awareness" \\
  --output "ad-output.png"

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

COMFY_DEPLOY_API_KEY="$KEY" uv run {baseDir}/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"

### List available brands:

uv run {baseDir}/scripts/generate.py --list-brands

### API Details

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

### ComfyDeploy Input Variables

VariableTypeDescriptionproduct_urlstringProduct page URL to scrapeproductoimage URLProduct image (uploaded to ComfyDeploy)modelimage URLModel/talent face reference. OPTIONAL — empty = product-only ad without a person. When used, select from models catalog (~/clawd/models-catalog/catalog/images/model_XX.jpg, 114 available)referenciaimage URLStyle reference ad — OPTIONAL, empty = bypassed. Only when user asks to clone a referencemarcaimage URLBrand logo — OPTIONAL, empty = bypassed. Use if found easily in good qualitybrand_profileenumBrand name from catalog (70+ brands)prompt_profileenumFunnel stage master promptaspect_ratioenumOutput format (1:1, 4:5, 5:4, 9:16, etc.)languagestringON-DEMAND ONLY. Output language for ad copy/CTA. Default: es. Only send when the user explicitly requests a different language. Otherwise, DO NOT include this parameter — let the pipeline use its default.creative_briefstringON-DEMAND ONLY. Free-text creative direction override. Only use when the user explicitly asks for a specific creative direction, scene, mood, or concept. Otherwise, DO NOT include this parameter — let the pipeline generate its own brief from the Brand Identity profile automatically.

### 01 — Awareness

Goal: Scroll-stop, curiosity, brand introduction
Reject: Generic "product on table" concepts
Strategy: Dynamic camera angles, world-building environments, high-concept creativity
CTA: Soft or optional
Visual Hierarchy: Talent → Product → Optional CTA

### 02 — Interest

Goal: Sustained attention, introduce value proposition
Reject: Abstract visuals that hide the product
Strategy: One clear visual idea, believable micro-world hinting at use-case
CTA: Learn More, Discover, See Details
Visual Hierarchy: Talent → Product → Headline → CTA

### 03 — Consideration

Goal: Informed evaluation, reduce uncertainty
Reject: Pure mood storytelling, vague emotional content
Strategy: Communicate WHAT product does, ONE primary differentiator, ONE proof cue
CTA: Compare, See Details, Explore
Visual Hierarchy: Talent → Product → Key Benefit → Proof Cue → CTA
New: Adds Brand Identity Manifest to Blueprint JSON

### 04 — Evaluation

Goal: Validate purchase decision, proof & trust
Reject: Pure mood, unsupportable claims, visual clutter
Strategy: One trust anchor (quality/legitimacy/authority), one proof cue (reviews/certification)
CTA: See Reviews, Verified Quality, Learn More
Visual Hierarchy: Trust Anchor → Proof Cue → Product → Talent → CTA

### 05 — Conversion

Goal: Trigger decisive action, remove friction
Reject: New hesitation-inducing info, complex compositions
Strategy: One hero (product), one action, optional micro-reassurance
CTA: Buy Now, Get Yours, Complete Order (PRIMARY visual element)
Visual Hierarchy: Product → CTA → Optional Reassurance → Brand → Talent

### 06 — Retention

Goal: Post-purchase confidence, reduce churn
Reject: Hard-sell, urgency, price talk
Strategy: "You made the right choice" + "Here is the next step"
CTA: Start, Set Up, Learn, Track (guidance, not purchase)
Visual Hierarchy: Confirmation → Next Step → Product → Talent

### 07 — Loyalty

Goal: Strengthen emotional bond over time
Reject: Sales layouts, instructional tone, aggressive CTAs
Strategy: "This brand is part of who you are" — habitual engagement
CTA: Optional: Explore, Be Part Of, Continue
Visual Hierarchy: Brand World/Mood → Talent (identity mirror) → Product → Brand

### 08 — Advocacy

Goal: Turn customers into voluntary brand ambassadors
Reject: Sales language, instructional tone, forced testimonials
Strategy: Signal belonging, create share-worthy imagery, enable organic sharing
CTA: Optional or absent: Join the Movement, Part of Us
Visual Hierarchy: Mood → Talent (identity proxy) → Product (symbol) → Brand

### 09 — Morfeo Creative 🎨 (DEFAULT)

Goal: Maximum visual impact, narrative-rich, cinematic quality
Reject: White backgrounds, studio shots, "product on table", generic poses, sterile compositions
Strategy: Build immersive WORLDS, not backgrounds. Talent is a CHARACTER with emotion and action. Subtle surreal/magical elements elevate the mundane. Think movie stills + magical realism + high fashion.
CTA: Present but integrated into scene aesthetics
Visual Hierarchy: Scene → Talent (as character) → Product (organic in scene) → CTA
Creative Philosophy:

NEVER a white background or studio
Every image has depth (foreground/midground/background layers)
Lighting is narrative (golden hour, practicals, colored atmosphere)
One subtle surreal element per scene (impossible beauty, dream-logic detail)
Wardrobe is costume design, not "simple clothes"
Camera has personality (specific film stocks, intentional imperfections)

### Creating New Ad Types

To create a new funnel stage or specialized ad type:

Copy the closest existing Master Prompt from {baseDir}/configs/Product_to_Ads/
Redefine ROUND 1 with the new strategic objective
Adjust ROUND 2 UI hierarchy accordingly
Shift talent/product narrative roles
Modify CTA philosophy and copy voice
Keep the JSON output structure identical for pipeline compatibility
Maintain the Fidelity Lock (ROUND 0) — product and talent are always immutable
Save as Master_prompt_XX_NewStage.json — the node auto-discovers new profiles

### Key Evolution Pattern Across Stages:

AspectEarly (01-02)Mid (03-05)Late (06-08)Morfeo (09)Talent roleAttention anchorCredibility anchorIdentity mirrorCharacter in storyProduct roleSecondary heroEvaluation heroFamiliar symbolOrganic in worldCTASoft/exploratoryProof-led → DecisiveGuidance → OptionalIntegrated/aestheticCopy voiceIntriguingClarity, proof, actionSupportive → ProudEvocative/poeticVisual densityHigh-conceptStructured, scannableEditorial, spaciousCinematic/layeredEnvironmentWorld-buildingContext-richLifestyleImmersive + surrealEnvironmentWorld-buildingContext-richLifestyle, intimate

### Binding Images (strict fidelity — immutable)

talent: Face/body locked, no deviation in facial structure, ethnicity, proportions
product_1-4: Shape, label text, material, proportions preserved 1:1
brand_logo: UI/button style derived from logo geometry

### Soft References (optional, off by default)

Reference image input (referencia) is optional. When provided, it's analyzed for:

POSE_REF → Body position, limbs, weight, gaze, micro-gestures
PHOTO_STYLE_REF → Camera, lens, lighting, grading, grain
LOCATION_REF → Setting, materials, colors, mood

When empty (default), creative direction comes from Brand Identity + Campaign Brief alone.

### 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

The Brand Analyzer uses a 3-phase methodology:

Phase 1: Official research via Google Search (canonical data: name, founding, positioning, vision, mission, tagline)
Phase 1.1: Independent campaign research (10+ distinct campaigns via Google Images/Pinterest)
Phase 2-3: Visual analysis → JSON profile following the standard template

Output covers: brand_info, brand_values, target_audience, tone_of_voice, visual_identity, photography, campaign_guidelines, brand_behavior, channel_expression, compliance.

### Aspect Ratios

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

### Config Files Reference

The skill includes reference copies of all pipeline configuration files:

{baseDir}/configs/
├── Brief_Generator/
│   └── brief_prompt.json              # 10-point campaign brief framework
├── Product_to_Ads/
│   ├── Master_prompt_01_Awareness.json
│   ├── Master_prompt_02_Interest.json
│   ├── Master_prompt_03_Consideration.json
│   ├── Master_prompt_04_Evaluation.json
│   ├── Master_prompt_05_Conversion.json
│   ├── Master_prompt_06_Retention.json
│   ├── Master_prompt_07_Loyalty.json
│   ├── Master_prompt_08_Advocacy.json
│   └── Master_prompt_09_Morfeo_Creative.json  # 🎨 DEFAULT — cinematic, surreal, narrative
└── Reference_Analyzer/
    └── reference_analysis_prompt.txt   # Pose/style/location analysis prompt

These configs are the canonical reference for the pipeline's behavior. The actual live configs are stored in the ComfyUI deployment at ads_SV/configs/.

### Known Limitations

Product image scraping is fragile — always provide product images manually
Some websites block scraping — provide product data manually when scraping fails
Gemini hallucinations — occasional issues in complex reasoning steps
No brief editing — brief is generated automatically; manual override not yet supported
Logo & reference are optional — both use server-side bypass; empty string = not used. Logo: use if good quality. Reference: only on explicit request

### Ad-Ready vs Morpheus

FeatureAd-ReadyMorpheusInputProduct URL (auto-scrapes)Manual product imageBrand intelligence70+ brand profilesNoneFunnel targeting8 funnel stagesNoneBrief generationAuto (10-point creative direction)NoneCreative directionObjective-driven (brief → blueprint)Pack-based (camera, lens, lighting)Best forProduct advertising campaignsFashion/lifestyle editorial photographyControl levelHigh-level (strategy-first)Granular (every visual parameter)

### API Key

Uses ComfyDeploy API key. Set via COMFY_DEPLOY_API_KEY environment variable.

### Source Repository

GitHub: PauldeLavallaz/ads_SV
Architecture: ComfyUI custom node package with 3 nodes:

ProductToAds_Manual — Full manual control, single format
ProductToAds_Auto — Auto-downloads images, generates 4 formats
BrandIdentityAnalyzer — Analyzes brands via Gemini + Google Search
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: PauldeLavallaz
- Version: 1.0.2
## 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-29T08:55:04.842Z
- Expires at: 2026-05-06T08:55:04.842Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ad-ready)
- [Send to Agent page](https://openagent3.xyz/skills/ad-ready/agent)
- [JSON manifest](https://openagent3.xyz/skills/ad-ready/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ad-ready/agent.md)
- [Download page](https://openagent3.xyz/downloads/ad-ready)