Menu
Use when researching competitor ad creatives: find competitors, brand IDs, evergreen winners, breakout winners, pattern analysis.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when generating Word documents (.docx). Uses the marble_docx API.
Use when generating PDF documents. Uses the marble_pdf API.
Use when generating PowerPoint presentations (.pptx). Uses the marble_pptx API.
Use when generating Excel workbooks (.xlsx). Pandas + openpyxl patterns for multiple sheets, number formats, freeze panes, formulas.
Use for any GA4 query whose result will be reported back to the user. Covers conversions ≠ transactions distinction, channel-subset-sum trap with sessionDefaultChannelGroup, intraday partial-data discipline, Paid Social aggregation rules, API-vs-UI attribution mismatch.
Use when creating a Google Ads ad group. Loaded after the create master skill.
| name | creative-research |
| description | Use when researching competitor ad creatives: find competitors, brand IDs, evergreen winners, breakout winners, pattern analysis. |
Discover new creative concepts by analyzing competitor ads. Find validated winning concepts and adapt them for your brand.
Before exploring competitors, identify your current winning ads and their patterns (angles, formats, hooks). This gives you a baseline to compare competitor insights against. Use your primary conversion metric: Purchase ROAS (ecommerce) or Cost Per Result (leadgen).
Tool: ads_library_find_competitors
Parameters:
website_url: "www.yourcompany.com" # Preferred
OR brand: "Your Brand Name"
Returns: competitor brands (up to 5) with names + URLs, product keywords, niche category, market target (B2B/B2C), suggested search queries.
ads_library_search_brands with those brands BEFORE using keyword searchads_library_discover_ads keyword search as last resortTool: ads_library_search_brands
Parameters:
domain: "competitor.com" # More accurate than name
OR name: "Competitor Brand"
limit: 10
Returns: brand_id (needed for fetching ads), brand name, category/niches. Save brand_ids for Steps 3A/3B.
Goal: Find ads running 30+ days — longevity implies profitability.
Tool: ads_library_get_ads_by_brand_id
Parameters:
brand_ids: ["brand_id_1", "brand_id_2"]
live: "true"
order: "longest_running"
limit: 50
running_duration_min_days: 30 # Optional filter
ads_library_analyze_ad: pass top ad IDs with include_duplicates: true.| Element | What to Look For |
|---|---|
| Angle | What selling points repeat across winners? (Authority? Results? Price?) |
| Concept | How is the angle executed? (Testimonial? Before/after? Expert?) |
| Visual Style | Professional vs lo-fi? UGC? Product-focused? |
| Script | Common structure? (Problem → Solution → CTA) Length patterns? |
| Hook | Visual patterns? Text overlay? Audio approach? (first 3–5 seconds) |
| Format | Dominant format? (Testimonial, demo, lifestyle) |
Goal: Find concepts launched recently and repeated aggressively — indicates active scaling.
Tool: ads_library_get_ads_by_brand_id
Parameters:
brand_ids: ["brand_id_1", "brand_id_2"]
live: "true"
start_date: "[30 days ago, YYYY-MM-DD]"
order: "newest"
limit: 100
Group ads by similarity (same copy/format/visual style). A Breakout Winner is a concept that:
Scaling signal levels:
Deep analyze with ads_library_analyze_ad using include_duplicates: true.
Tool: ads_library_discover_ads
Parameters:
search_query: "protein shake" # Max 6 words, specific not generic
order: "longest_running"
niches: ["health/wellness"]
display_format: ["video"]
live: true
limit: 50
Use when researching a category broadly rather than specific brands.
Tool: ads_library_get_brand_analytics
Parameters:
brand_ids: ["brand_id_1"]
Returns: total active ads, format distribution, platform breakdown. Use to decide which competitors are most active and worth deep analysis.