start-vibing-stacks 2.29.0 → 2.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/dist/setup.js +15 -1
  2. package/package.json +1 -1
  3. package/stacks/_shared/ads-agents/README.md +452 -0
  4. package/stacks/_shared/ads-agents/RESEARCH-REPORT.md +157 -0
  5. package/stacks/_shared/ads-agents/SKILL.md +210 -0
  6. package/stacks/_shared/ads-agents/SKILLS-UPDATE-REPORT.md +255 -0
  7. package/stacks/_shared/ads-agents/agents/audit-budget.md +116 -0
  8. package/stacks/_shared/ads-agents/agents/audit-compliance.md +131 -0
  9. package/stacks/_shared/ads-agents/agents/audit-creative.md +127 -0
  10. package/stacks/_shared/ads-agents/agents/audit-google.md +113 -0
  11. package/stacks/_shared/ads-agents/agents/audit-meta.md +112 -0
  12. package/stacks/_shared/ads-agents/agents/audit-tracking.md +134 -0
  13. package/stacks/_shared/ads-agents/agents/copy-writer.md +188 -0
  14. package/stacks/_shared/ads-agents/agents/creative-strategist.md +199 -0
  15. package/stacks/_shared/ads-agents/agents/format-adapter.md +175 -0
  16. package/stacks/_shared/ads-agents/agents/visual-designer.md +245 -0
  17. package/stacks/_shared/ads-agents/references/additional-platforms.md +106 -0
  18. package/stacks/_shared/ads-agents/references/benchmarks.md +257 -0
  19. package/stacks/_shared/ads-agents/references/bidding-strategies.md +333 -0
  20. package/stacks/_shared/ads-agents/references/brand-dna-template.md +190 -0
  21. package/stacks/_shared/ads-agents/references/budget-allocation.md +150 -0
  22. package/stacks/_shared/ads-agents/references/compliance.md +280 -0
  23. package/stacks/_shared/ads-agents/references/conversion-tracking.md +246 -0
  24. package/stacks/_shared/ads-agents/references/copy-frameworks.md +187 -0
  25. package/stacks/_shared/ads-agents/references/funnel-content-copy-rules.md +44 -0
  26. package/stacks/_shared/ads-agents/references/gaql-notes.md +49 -0
  27. package/stacks/_shared/ads-agents/references/google-audit.md +217 -0
  28. package/stacks/_shared/ads-agents/references/google-creative-specs.md +119 -0
  29. package/stacks/_shared/ads-agents/references/image-providers.md +133 -0
  30. package/stacks/_shared/ads-agents/references/linkedin-audit.md +141 -0
  31. package/stacks/_shared/ads-agents/references/linkedin-creative-specs.md +129 -0
  32. package/stacks/_shared/ads-agents/references/mcp-integration.md +125 -0
  33. package/stacks/_shared/ads-agents/references/meta-audit.md +141 -0
  34. package/stacks/_shared/ads-agents/references/meta-creative-specs.md +134 -0
  35. package/stacks/_shared/ads-agents/references/microsoft-audit.md +158 -0
  36. package/stacks/_shared/ads-agents/references/microsoft-creative-specs.md +123 -0
  37. package/stacks/_shared/ads-agents/references/platform-specs.md +276 -0
  38. package/stacks/_shared/ads-agents/references/scoring-system.md +169 -0
  39. package/stacks/_shared/ads-agents/references/tiktok-audit.md +165 -0
  40. package/stacks/_shared/ads-agents/references/tiktok-creative-specs.md +139 -0
  41. package/stacks/_shared/ads-agents/references/voice-to-style.md +87 -0
  42. package/stacks/_shared/ads-agents/references/youtube-creative-specs.md +134 -0
  43. package/stacks/_shared/ads-agents/skills/ads-apple/SKILL.md +225 -0
  44. package/stacks/_shared/ads-agents/skills/ads-audit/SKILL.md +108 -0
  45. package/stacks/_shared/ads-agents/skills/ads-budget/SKILL.md +198 -0
  46. package/stacks/_shared/ads-agents/skills/ads-competitor/SKILL.md +198 -0
  47. package/stacks/_shared/ads-agents/skills/ads-create/SKILL.md +198 -0
  48. package/stacks/_shared/ads-agents/skills/ads-creative/SKILL.md +208 -0
  49. package/stacks/_shared/ads-agents/skills/ads-dna/SKILL.md +245 -0
  50. package/stacks/_shared/ads-agents/skills/ads-generate/SKILL.md +173 -0
  51. package/stacks/_shared/ads-agents/skills/ads-google/SKILL.md +192 -0
  52. package/stacks/_shared/ads-agents/skills/ads-landing/SKILL.md +186 -0
  53. package/stacks/_shared/ads-agents/skills/ads-linkedin/SKILL.md +200 -0
  54. package/stacks/_shared/ads-agents/skills/ads-math/SKILL.md +216 -0
  55. package/stacks/_shared/ads-agents/skills/ads-meta/SKILL.md +167 -0
  56. package/stacks/_shared/ads-agents/skills/ads-microsoft/SKILL.md +163 -0
  57. package/stacks/_shared/ads-agents/skills/ads-photoshoot/SKILL.md +220 -0
  58. package/stacks/_shared/ads-agents/skills/ads-plan/SKILL.md +176 -0
  59. package/stacks/_shared/ads-agents/skills/ads-test/SKILL.md +199 -0
  60. package/stacks/_shared/ads-agents/skills/ads-tiktok/SKILL.md +190 -0
  61. package/stacks/_shared/ads-agents/skills/ads-youtube/SKILL.md +199 -0
  62. package/stacks/_shared/memories/funnel-content-copy.md +81 -0
  63. package/templates/CLAUDE-python.md +6 -0
@@ -0,0 +1,167 @@
1
+ ---
2
+ name: ads-meta
3
+ version: 1.6.0
4
+ description: "Meta Ads deep analysis covering Facebook and Instagram advertising. Evaluates 50 checks across Pixel/CAPI health, creative diversity and fatigue, account structure, and audience targeting. Includes Advantage+ assessment. Use when user says Meta Ads, Facebook Ads, Instagram Ads, Advantage+, or Meta campaign."
5
+ user-invokable: false
6
+ ---
7
+
8
+ <!-- Updated: 2026-05-14 | v1.6: Andromeda 2026 playbook (8-12 concepts × 2-3 variations, similarity <40%, 2-3 week fatigue, 20+ tests/month), Advantage+ creative 22% ROAS lift, single-ad-set consolidation -->
9
+
10
+ # Meta Ads Deep Analysis
11
+
12
+ ## Andromeda AI Engine (2026)
13
+
14
+ Meta's Andromeda AI engine (global rollout complete Oct 2025) filters ads using
15
+ 10,000x more complex retrieval models on the NVIDIA Grace Hopper Superchip. Creative
16
+ diversity is now the #1 performance lever, replacing targeting and bidding as the
17
+ primary optimization surface.
18
+
19
+ **Similarity Score thresholds (2026 verified):**
20
+ - **>60%** = retrieval suppression (ads collapsed under one Entity ID, compete with each other)
21
+ - **<40%** = recommended target across active assets (treated as distinct candidates)
22
+ - 100 minor variations (color swaps, text tweaks on same template) perform no better than 10 genuinely distinct concepts
23
+
24
+ **Creative volume reality (2026 data):**
25
+ - Top third of advertisers run ~395 live ads at any time; bottom third runs ~296 (33% gap)
26
+ - Brands testing 20+ new ads/month see 65% higher ROAS than brands testing <10
27
+ - Andromeda-aligned structures deliver 20-35% higher ROAS than legacy structures
28
+ - Advantage+ creative drives 22% ROAS lift over manual creative setups
29
+ - One ad set with 25 diverse creatives outperformed five ad sets with five each by 17% on conversions, 16% on cost
30
+
31
+ **The 2026 creative system (recommended workflow):**
32
+ 1. Build **8-12 conceptually distinct concepts** per campaign (different hooks, formats, emotional triggers, visual treatments)
33
+ 2. Produce **2-3 variations per concept** (the variations must differ on visual/audio/structural levels Andromeda actually parses, not just headline swaps)
34
+ 3. Refresh on **2-3 week cycle** (fatigue window has shrunk from 6+ weeks pre-Andromeda)
35
+ 4. Consolidate into fewer ad sets with more creatives (algorithm performs best when not fragmented)
36
+ 5. Mix high-production brand assets with native UGC/founder-led content; neither alone wins
37
+
38
+ ## Process
39
+
40
+ 1. Collect Meta Ads data (Ads Manager export, Events Manager screenshot, EMQ scores)
41
+ 2. Read `ads-agents/references/meta-audit.md` for full 50-check audit
42
+ 3. Read `ads-agents/references/benchmarks.md` for Meta-specific benchmarks
43
+ 4. Read `ads-agents/references/scoring-system.md` for weighted scoring
44
+ 5. Evaluate all applicable checks as PASS, WARNING, or FAIL
45
+ 6. Calculate Meta Ads Health Score (0-100)
46
+ 7. Generate findings report with action plan
47
+
48
+ ## What to Analyze
49
+
50
+ ### Pixel / CAPI Health (30% weight)
51
+ - Meta Pixel installed and firing on all pages
52
+ - Conversions API (CAPI) active (30-40% data loss without it post-iOS 14.5)
53
+ - Event deduplication configured (event_id matching, ≥90% dedup rate)
54
+ - Event Match Quality (EMQ) ≥8.0 for Purchase event
55
+ - All standard events configured (ViewContent, AddToCart, Purchase, Lead)
56
+ - Custom conversions created for non-standard events
57
+ - Aggregated Event Measurement (AEM) configured for iOS
58
+ - Domain verification completed
59
+ - Server-side events include customer_information parameters
60
+ - Pixel fires with correct currency and value parameters
61
+
62
+ ### Creative (30% weight)
63
+ - ≥3 creative formats active (image, video, carousel, collection)
64
+ - ≥5 creatives per ad set baseline; **target 8-12 distinct concepts** per campaign with 2-3 variations each (Andromeda 2026 standard)
65
+ - Creative fatigue detection: CTR drop >10% week-over-week OR >20% over 14 days = FAIL (Andromeda fatigue window: 2-3 weeks, down from 6+)
66
+ - Video creative: 15s max for Stories/Reels, 30s max for Feed
67
+ - UGC/testimonial creative tested AND mixed with polished brand assets (both belong in rotation)
68
+ - Advantage+ Creative enhancements enabled (drives ~22% ROAS lift over manual)
69
+ - Ad copy: headline under 40 chars, primary text under 125 chars
70
+ - Creative refresh cadence: every 2-3 weeks for high-spend (>$5K/month → 5-15 new creatives/week)
71
+ - Creative Similarity Score <40% across active ads (>60% triggers retrieval suppression)
72
+
73
+ ### Account Structure (20% weight)
74
+ - Campaign Budget Optimization (CBO) vs Ad Set Budget (ABO) intentional
75
+ - Campaign consolidation: 1-3 campaigns total recommended
76
+ - Learning phase health: <30% ad sets in "Learning Limited" (FAIL >50%)
77
+ - Budget per ad set: ≥5x target CPA (minimum for learning phase exit)
78
+ - Ad set audience overlap <30% (Audience Overlap tool)
79
+ - Campaign naming conventions consistent and descriptive
80
+ - Advantage+ Sales Campaigns active for e-commerce
81
+ - Simplified campaign structure: 1-3 campaigns total (fewer, larger ad sets preferred)
82
+
83
+ ### Audience & Targeting (20% weight)
84
+ - Prospecting frequency (7-day): <3.0 (WARNING 3-5, FAIL >5)
85
+ - Retargeting frequency (7-day): <8.0 (WARNING 8-12, FAIL >12)
86
+ - Custom Audiences: website visitors, customer lists, engagement
87
+ - Lookalike Audiences: multiple seed sizes tested (1%, 3%, 5%)
88
+ - Advantage+ Audience tested vs manual targeting
89
+ - Interest targeting: broad enough for algorithm optimization
90
+ - Exclusions: purchasers excluded from prospecting, overlap managed
91
+ - Location targeting reviewed for relevance
92
+
93
+ ## Advantage+ Assessment
94
+
95
+ If Advantage+ features are in use:
96
+ - **Advantage+ Sales Campaigns**: catalog connected, existing customer cap set
97
+ - **Advantage+ Audience**: performance vs manual audience compared
98
+ - **Advantage+ Creative**: enhancements enabled (text, brightness, music)
99
+ - **Advantage+ Placements**: enabled (let Meta optimize placement mix)
100
+ - **Budget allocation**: Advantage+ campaigns getting fair test budget
101
+
102
+ ## Special Ad Categories
103
+
104
+ If ads are in restricted categories:
105
+ - Special Ad Category declared before campaign creation
106
+ - Targeting restrictions verified (no ZIP, age 18-65+ only, no Lookalike)
107
+ - Creative compliance with category-specific policies
108
+ - Read `ads-agents/references/compliance.md` for full requirements
109
+
110
+ ## EMQ Optimization Guide
111
+
112
+ | EMQ Score | Status | Action |
113
+ |-----------|--------|--------|
114
+ | 8.0-10.0 | Excellent | Maintain current setup |
115
+ | 6.0-7.9 | Good | Add more customer_information parameters |
116
+ | 4.0-5.9 | Fair | Implement CAPI, improve data quality |
117
+ | <4.0 | Poor | Critical: CAPI + Enhanced Matching required |
118
+
119
+ Key parameters to maximize EMQ:
120
+ - `em` (email): highest match rate signal
121
+ - `ph` (phone): second highest match signal
122
+ - `fn`, `ln` (first/last name): improves match accuracy
123
+ - `ct`, `st`, `zp` (city, state, zip): geographic matching
124
+ - `external_id`: CRM/user ID for cross-device matching
125
+
126
+ ## Key Thresholds
127
+
128
+ | Metric | Pass | Warning | Fail |
129
+ |--------|------|---------|------|
130
+ | EMQ (Purchase) | ≥8.0 | 6.0-7.9 | <6.0 |
131
+ | Dedup rate | ≥90% | 70-90% | <70% |
132
+ | CTR | ≥1.0% | 0.5-1.0% | <0.5% |
133
+ | Creative formats | ≥3 | 2 | 1 |
134
+ | Creatives per ad set | ≥5 (target 8-12 distinct concepts × 2-3 variations per campaign) | 3-4 | <3 |
135
+ | Distinct concepts (Andromeda) | ≥10 genuinely distinct | 5-9 | <5 |
136
+ | Creative Similarity Score | <40% | 40-60% | >60% (suppression) |
137
+ | Fatigue: CTR WoW drop | <10% | 10-20% | >20% (kill) |
138
+ | Learning Limited | <30% | 30-50% | >50% |
139
+ | Budget per ad set | ≥5x CPA | 2-5x CPA | <2x CPA |
140
+
141
+ ## Output
142
+
143
+ ### Meta Ads Health Score
144
+
145
+ ```
146
+ Meta Ads Health Score: XX/100 (Grade: X)
147
+
148
+ Pixel / CAPI Health: XX/100 ████████░░ (30%)
149
+ Creative: XX/100 ██████████ (30%)
150
+ Account Structure: XX/100 ███████░░░ (20%)
151
+ Audience: XX/100 █████░░░░░ (20%)
152
+ ```
153
+
154
+ ### Deliverables
155
+ - `META-ADS-REPORT.md`: Full 50-check findings with pass/warning/fail
156
+ - EMQ improvement roadmap
157
+ - Creative fatigue alerts (any creative with CTR declining >20%)
158
+ - Quick Wins sorted by impact
159
+ - Advantage+ adoption recommendations
160
+
161
+ ## Threads Placement
162
+
163
+ Threads placement GA Jan 2026, 400M+ MAU. Lower CPMs than Feed/Stories.
164
+ Currently ~0.04% of total spend. Emerging channel. Evaluate:
165
+ - Is Threads placement enabled in Advantage+ Placements?
166
+ - Monitor CPM and engagement vs other placements
167
+ - Early-mover advantage for brands with active Threads presence
@@ -0,0 +1,163 @@
1
+ ---
2
+ name: ads-microsoft
3
+ version: 1.6.0
4
+ description: "Microsoft/Bing Ads deep analysis covering search, Performance Max, Audience Network, and Copilot integration. Evaluates 24 checks with focus on Google import validation, unique Microsoft features, and cost advantage assessment. Use when user says Microsoft Ads, Bing Ads, Bing PPC, Copilot ads, or Microsoft campaign."
5
+ user-invokable: false
6
+ ---
7
+
8
+ <!-- Updated: 2026-05-14 | v1.6: Copilot ad lift recalibrated (15-25% verified vs older 73% claim), PMax for Microsoft Advertising 2026 (combines search + Audience Network + Copilot), Copilot 400M+ MAU Q1 2026 -->
9
+
10
+
11
+ # Microsoft Ads Deep Analysis
12
+
13
+ ## Process
14
+
15
+ 1. Collect Microsoft Ads data (account export, UET tag status, import results)
16
+ 2. Read `ads-agents/references/microsoft-audit.md` for full 24-check audit
17
+ 3. Read `ads-agents/references/benchmarks.md` for Microsoft-specific benchmarks
18
+ 4. Read `ads-agents/references/scoring-system.md` for weighted scoring
19
+ 5. Evaluate all applicable checks as PASS, WARNING, or FAIL
20
+ 6. Calculate Microsoft Ads Health Score (0-100)
21
+ 7. Generate findings report with action plan
22
+
23
+ ## What to Analyze
24
+
25
+ ### Technical Setup (25% weight)
26
+ - UET tag installed and firing on all pages (MS01)
27
+ - Enhanced conversions enabled (MS02)
28
+ - Google Ads import validated: URLs, extensions, bids, goals (MS03)
29
+
30
+ ### Syndication & Bidding (20% weight)
31
+ - Search partner network reviewed, low-performers excluded (MS04)
32
+ - Audience Network enabled only if testing intentionally (MS05)
33
+ - Bid targets 20-35% lower than Google (CPC advantage) (MS06)
34
+ - PMax: 300 campaigns/account (vs 100 Google), LinkedIn profile data available, no video support
35
+ - Target New Customers enabled for PMax, Beta 2026 (MS07)
36
+
37
+ ### Campaign Structure (20% weight)
38
+ - Campaign structure mirrors Google or follows best practices (MS08)
39
+ - Budget proportional to Bing volume: typically 20-30% of Google (MS09)
40
+ - LinkedIn profile targeting for B2B (unique advantage) (MS10)
41
+
42
+ ### Creative & Extensions (20% weight)
43
+ - RSA: ≥8 headlines, ≥3 descriptions (MS11)
44
+ - Multimedia Ads tested (unique rich format) (MS12)
45
+ - Ad copy optimized for Bing demographics (MS13)
46
+ - Action Extension utilized (unique to Microsoft) (MS19)
47
+ - Filter Link Extension tested (MS20)
48
+
49
+ ### Settings & Performance (15% weight)
50
+ - Copilot chat placement enabled for PMax: 15-25% CTR lift verified 2026 (MS14)
51
+ - Conversion goals configured natively, not relying on imported (MS15)
52
+ - CPC 20-40% lower than Google for same keywords (MS16)
53
+ - CVR comparable to Google, not >50% lower (MS17)
54
+ - Impression share tracked for brand and top terms (MS18)
55
+
56
+ ## Google Import Validation
57
+
58
+ Most Microsoft Ads accounts start as Google Ads imports. Critical validation:
59
+
60
+ ### What Transfers Correctly
61
+ - Campaign structure and ad groups
62
+ - Keywords and match types
63
+ - RSA headlines and descriptions
64
+ - Basic bid strategies
65
+
66
+ ### What Needs Manual Review
67
+ - **URLs**: verify all landing page URLs are correct post-import
68
+ - **Extensions**: not all Google extensions have Microsoft equivalents
69
+ - **Bid amounts**: should be 20-35% lower (don't import Google bids as-is)
70
+ - **Conversion goals**: re-create natively for better tracking
71
+ - **Audiences**: import may miss segments, verify all are present
72
+ - **Negative keywords**: verify shared negative lists transferred
73
+
74
+ ### Import Schedule
75
+ - Auto-import: useful but review changes monthly
76
+ - **Warning:** Scheduled imports can re-enable paused campaigns. Deactivate scheduled imports after initial setup.
77
+ - Manual import: more control, recommended for large accounts
78
+ - Never import without post-import audit
79
+
80
+ ## Copilot Integration (2026)
81
+
82
+ Microsoft's AI assistant creates unique ad opportunities. **400M+ MAU on Copilot
83
+ across Microsoft ecosystem as of Q1 2026** (Stackmatix April 2026).
84
+
85
+ ### Copilot Chat Ads
86
+ - Available in Performance Max campaigns
87
+ - **Conversational placements deliver 15-25% higher CTR** vs traditional search ads (verified 2026 partner data); the older "73% lift" figure was early closed-beta and should be treated as anecdotal — use 15-25% as the realistic working range
88
+ - Copilot Checkout launched Jan 2026 (in-chat purchase)
89
+ - Natural language ad delivery (conversational context)
90
+ - Copilot ads show beneath AI responses with Sponsored labels
91
+ - Sponsored responses GA across Copilot since 2025
92
+
93
+ ### How to Evaluate
94
+ - Is Copilot placement enabled? (If not, HIGH priority for PMax)
95
+ - What % of impressions/clicks come from Copilot?
96
+ - CTR/CVR comparison: Copilot vs traditional placements (expect 15-25% lift, not 73%)
97
+ - Ad copy quality: does it read well in conversational context? Leads with specific benefit (not brand name), second-person language, proof points (numbers/outcomes) that give AI context to surface ad appropriately
98
+
99
+ ### PMax for Microsoft Advertising (2026)
100
+ - Combines search + Audience Network + Copilot placements into a single campaign type with automated creative optimization
101
+ - Works best when fed strong first-party conversion data (offline conversions, Enhanced Conversions, CRM imports)
102
+ - LinkedIn profile targeting layered on top remains the unique B2B advantage
103
+
104
+ ## Microsoft-Unique Features
105
+
106
+ These features are exclusive to Microsoft Ads; evaluate adoption:
107
+
108
+ | Feature | Description | Priority |
109
+ |---------|-------------|----------|
110
+ | CTV Ads | Netflix, Max, Hulu, Roku, discovery+. 30-second non-skippable. | Medium |
111
+ | Multimedia Ads | Image-rich search ads with visual elements | Medium |
112
+ | Action Extension | CTA button directly in search ad | Medium |
113
+ | Filter Link Extension | Filterable category links in ad | Low |
114
+ | LinkedIn Profile Targeting | Target by company, industry, job function | High (B2B) |
115
+ | Copilot Chat Placement | Ads within Copilot conversations | High |
116
+ | Auto-generated RSA | Enabled by default Jan 2026, 5% CTR increase | Medium |
117
+ | 9:16 Vertical Video | Vertical video ads (Apr 2025), 90-second max duration | Medium |
118
+
119
+ ## Bing Demographic Context
120
+
121
+ Microsoft Ads reach a distinct audience:
122
+ - Older demographic (35-65+ over-indexed)
123
+ - Higher household income (top 25% income brackets)
124
+ - Desktop-heavy (Windows default browser = Edge = Bing)
125
+ - Enterprise/corporate users (Office 365 integration)
126
+
127
+ Ad copy optimization for this audience:
128
+ - Professional tone, less casual than Google/Meta
129
+ - Emphasize quality, reliability, premium positioning
130
+ - Desktop-optimized landing pages matter more
131
+ - B2B messaging resonates strongly
132
+
133
+ ## Key Thresholds
134
+
135
+ | Metric | Pass | Warning | Fail |
136
+ |--------|------|---------|------|
137
+ | CTR (Search) | ≥2.83% | 1.5-2.83% | <1.5% |
138
+ | CPC (Search) | ≤$1.55 | $1.55-2.50 | >$2.50 |
139
+ | CPC vs Google | 20-40% lower | 10-20% lower | Same or higher |
140
+ | CVR vs Google | Within 20% | 20-50% lower | >50% lower |
141
+ | Impression share (brand) | ≥80% | 60-80% | <60% |
142
+
143
+ ## Output
144
+
145
+ ### Microsoft Ads Health Score
146
+
147
+ ```
148
+ Microsoft Ads Health Score: XX/100 (Grade: X)
149
+
150
+ Technical Setup: XX/100 ████████░░ (25%)
151
+ Syndication: XX/100 ██████████ (20%)
152
+ Structure: XX/100 ███████░░░ (20%)
153
+ Creative: XX/100 █████░░░░░ (20%)
154
+ Settings: XX/100 ████████░░ (15%)
155
+ ```
156
+
157
+ ### Deliverables
158
+ - `MICROSOFT-ADS-REPORT.md`: Full 24-check findings with pass/warning/fail
159
+ - Google import validation results
160
+ - Copilot integration readiness assessment
161
+ - Cost advantage analysis (CPC savings vs Google)
162
+ - Microsoft-unique feature adoption checklist
163
+ - Quick Wins sorted by impact
@@ -0,0 +1,220 @@
1
+ ---
2
+ name: ads-photoshoot
3
+ version: 1.5.0
4
+ description: "Product photography enhancement for ad creatives using banana-claude image generation. Takes a product image and generates 5 professional photography styles for ad use: Studio, Floating, Ingredient, In Use, and Lifestyle. Requires banana-claude (v1.4.1+) with nanobanana-mcp. Triggers on: product photo, product photography, photoshoot, enhance product image, product shoot, product photos for ads, generate product photos, studio shot, lifestyle photo."
5
+ user-invokable: false
6
+ ---
7
+
8
+ # Ads Photoshoot: AI Product Photography
9
+
10
+ Transforms a product image or description into professional ad-ready photography
11
+ in 5 distinct visual styles. Each style generates at two sizes: 1:1 (Meta/LinkedIn)
12
+ and 9:16 (TikTok/Reels/Stories).
13
+
14
+ ## Quick Reference
15
+
16
+ | Command | What it does |
17
+ |---------|-------------|
18
+ | `/ads photoshoot` | Interactive: ask for product + styles |
19
+ | `/ads photoshoot --styles studio floating` | Generate only selected styles |
20
+ | `/ads photoshoot --product shoe.jpg` | Start with a product image file |
21
+ | `/ads photoshoot --all-platforms` | Generate all 5 sizes per style |
22
+
23
+ ## Environment Setup
24
+
25
+ Requires banana-claude (v1.4.1+) with nanobanana-mcp configured.
26
+ Run `/banana setup` to configure API key and MCP.
27
+
28
+ ## Process
29
+
30
+ ### Step 1: Collect Product Information
31
+
32
+ Ask (combine into one message):
33
+ 1. **Product image**: Path to product image file (local) OR product URL OR text description
34
+ > "Provide a product image path (e.g. ./product.jpg), a URL, or describe your product"
35
+ 2. **Product description**: What is it? Key features to highlight? (helps prompt quality)
36
+ 3. **Styles to generate**: Which of the 5 styles? (default: all 5)
37
+ - Studio, Floating, Ingredient, In Use, Lifestyle
38
+ 4. **Target platforms**: Which platforms will these run on?
39
+ - Determines output sizes (default: Meta + TikTok → 1:1 + 9:16)
40
+
41
+ ### Step 2: Load Brand Profile (Optional)
42
+
43
+ Check for `brand-profile.json` in the current directory.
44
+
45
+ If found, extract for style injection:
46
+ - `colors.primary` → inject into backgrounds and accent elements
47
+ - `aesthetic.mood_keywords` → inject as atmosphere descriptors
48
+ - `target_audience` → use for Lifestyle and In Use context
49
+ - `imagery.forbidden` → exclude from all prompts
50
+
51
+ If not found, proceed with standard style templates.
52
+
53
+ ### Step 3: Verify banana-claude
54
+
55
+ Verify banana-claude is installed (run `/banana setup` to check). If not installed,
56
+ display setup instructions and exit.
57
+
58
+ ### Step 4: Construct Prompts per Style
59
+
60
+ For each selected style, build the prompt using the template + product description + brand DNA.
61
+
62
+ #### Style 1: Studio
63
+ Clean, e-commerce style product shot.
64
+
65
+ **Base template:**
66
+ ```
67
+ "[product description], professional product photography, clean white seamless
68
+ background, even studio lighting, soft drop shadow, high detail product focus,
69
+ ecommerce style, [brand.colors.primary] subtle accent reflections if applicable,
70
+ top-down or 3/4 angle, no distractions, catalog quality"
71
+ ```
72
+
73
+ **Composition:** Centered, slight 3/4 angle or flat lay.
74
+ **Output sizes:** 1080×1080, 1080×1920
75
+
76
+ #### Style 2: Floating
77
+ Dramatic levitation effect.
78
+
79
+ **Base template:**
80
+ ```
81
+ "[product description] floating in mid-air, dramatic floating product shot,
82
+ [brand.colors.primary or brand.aesthetic.mood_keywords[0]] gradient background,
83
+ atmospheric shadow below product, levitation effect, product defying gravity,
84
+ clean modern aesthetic, high contrast, striking visual"
85
+ ```
86
+
87
+ **Composition:** Product centered vertically, ample space above and below.
88
+ **Output sizes:** 1080×1080, 1080×1920
89
+
90
+ #### Style 3: Ingredient
91
+ Flat lay with components.
92
+
93
+ **Base template:**
94
+ ```
95
+ "[product description] centered flat lay, surrounded by its key ingredients
96
+ or materials artfully arranged, top-down overhead view, clean light background,
97
+ natural texture surface, product as hero element, ingredients scattered with
98
+ intentional negative space, editorial food photography style"
99
+ ```
100
+
101
+ **Composition:** Top-down, product in center, ingredients fanning out.
102
+ **Output sizes:** 1080×1080 (optimal for this style). Also generate 9:16 vertical for TikTok/Reels/Stories placements.
103
+
104
+ #### Style 4: In Use
105
+ Authentic usage context.
106
+
107
+ **Base template:**
108
+ ```
109
+ "person's hands using [product description] in natural context, lifestyle
110
+ photography, focus on product-hand interaction, shallow depth of field,
111
+ warm natural window light, authentic not staged, [brand.target_audience.profession]
112
+ implied context, [brand.aesthetic.mood_keywords] atmosphere"
113
+ ```
114
+
115
+ **Composition:** Hands prominent, product clearly identifiable, background soft-focus.
116
+ **Note:** Hands only; no full face (avoids model release complications).
117
+ **Output sizes:** 1080×1080, 1080×1920
118
+
119
+ #### Style 5: Lifestyle
120
+ Aspirational full-context shot.
121
+
122
+ **Base template:**
123
+ ```
124
+ "[product description] in aspirational lifestyle scene, [brand.target_audience.age_range]
125
+ demographic implied environment, [brand.target_audience.profession] context,
126
+ [brand.aesthetic.mood_keywords] atmosphere, golden hour or clean natural lighting,
127
+ editorial photography style, [brand.aesthetic.negative_space] composition,
128
+ product clearly visible and prominent"
129
+ ```
130
+
131
+ **Composition:** Environmental context, product as hero element within the scene.
132
+ **Output sizes:** 1080×1080, 1080×1920
133
+
134
+ ### Iterative Refinement
135
+
136
+ For iterative refinement: if initial generation doesn't match brand expectations, adjust the prompt by specifying: lighting direction, color temperature, background texture, or product angle before regenerating.
137
+
138
+ ### Step 5: Generate Images
139
+
140
+ **Domain mode selection per style:**
141
+ - Use banana **Product** mode for Studio, Floating, and Ingredient styles
142
+ - Use banana **Editorial** mode for In Use and Lifestyle styles
143
+ - Set resolution to 2K (default) for all generations
144
+
145
+ **Aspect ratio setup:** Use banana MCP `set_aspect_ratio` before each generation:
146
+ - For 1080x1080: set ratio to 1:1
147
+ - For 1080x1920: set ratio to 9:16
148
+
149
+ For each style x size combination, use `/banana generate` with the constructed
150
+ prompt, selected domain mode, and correct aspect ratio. Save output to
151
+ `./product-photos/[style]/[product-slug]-[style]-[WxH].png`.
152
+
153
+ Track results. If a generation fails, retry once with a simplified prompt.
154
+
155
+ ### Step 6: Organize and Report
156
+
157
+ **Output directory structure:**
158
+ ```
159
+ ./product-photos/
160
+ studio/
161
+ product-studio-1080x1080.png
162
+ product-studio-1080x1920.png
163
+ floating/
164
+ product-floating-1080x1080.png
165
+ product-floating-1080x1920.png
166
+ ingredient/
167
+ product-ingredient-1080x1080.png
168
+ product-ingredient-1080x1920.png
169
+ in-use/
170
+ product-in-use-1080x1080.png
171
+ product-in-use-1080x1920.png
172
+ lifestyle/
173
+ product-lifestyle-1080x1080.png
174
+ product-lifestyle-1080x1920.png
175
+ ```
176
+
177
+ **Summary:**
178
+ ```
179
+ ✓ Product photos generated: [N] images
180
+
181
+ Studio: ./product-photos/studio/ (2 sizes)
182
+ Floating: ./product-photos/floating/ (2 sizes)
183
+ Ingredient: ./product-photos/ingredient/ (2 sizes)
184
+ In Use: ./product-photos/in-use/ (2 sizes)
185
+ Lifestyle: ./product-photos/lifestyle/ (2 sizes)
186
+
187
+ Cost: see .banana/costs.json for total spend
188
+
189
+ Best for:
190
+ • Meta Feed → Studio (4:5) or Lifestyle (4:5)
191
+ • TikTok/Reels → Floating (9:16) or In Use (9:16)
192
+ • LinkedIn → Studio (1:1) or Lifestyle (1:1)
193
+ • Google PMax → Studio (1:1); crop to 1.91:1 after
194
+
195
+ Run `/ads generate` to use these in a full campaign.
196
+ ```
197
+
198
+ ## Cost Estimate
199
+
200
+ Before generating, show:
201
+ - Number of styles selected x 2 sizes = total images
202
+ - Estimated cost based on banana pricing tiers
203
+ - If >$0.50, ask for confirmation
204
+
205
+ ## Platform Recommendations
206
+
207
+ | Style | Best Platforms | Rationale |
208
+ |-------|---------------|-----------|
209
+ | Studio | Meta Feed, LinkedIn, Google PMax | Universal, clean, platform-safe |
210
+ | Floating | Meta Reels, TikTok, Stories | High visual impact on vertical placements |
211
+ | Ingredient | Meta Feed, Pinterest | Works best as square; tells product story |
212
+ | In Use | TikTok, Meta Reels, Stories | Authentic, native-feeling content |
213
+ | Lifestyle | All platforms | Aspirational, broad audience appeal |
214
+
215
+ ## Reference Files
216
+
217
+ - `ads-agents/references/image-providers.md`: API setup and pricing
218
+ - `ads-agents/references/brand-dna-template.md`: Brand injection schema
219
+ - `ads-agents/references/meta-creative-specs.md`: Safe zone for 9:16
220
+ - `ads-agents/references/tiktok-creative-specs.md`: Safe zone constraints