AgriciDaniel · popey · Mar 17, 2026
diff --git a/ads/SKILL.md b/ads/SKILL.md
@@ -61,9 +61,13 @@ When the user invokes `/ads audit`, delegate to subagents in parallel:
 1. **Collect context** (see Context Intake above — do this first)
 2. Collect account data (exports, screenshots, or pasted metrics)
 3. Detect business type and identify active platforms
-4. Spawn subagents: audit-google, audit-meta, audit-creative, audit-tracking, audit-budget, audit-compliance
-5. Collect results and generate unified report with Ads Health Score (0-100)
-6. Create prioritized action plan with Quick Wins
+4. Spawn subagents via Task tool with `context: fork`:
+   ```
+   audit-google, audit-meta, audit-creative, audit-tracking, audit-budget, audit-compliance
+   ```
+5. **Validate**: verify each subagent returned valid JSON scores before aggregating
+6. Collect results and generate unified report with Ads Health Score (0-100)
+7. Create prioritized action plan with Quick Wins
 
 For individual commands (`/ads google`, `/ads meta`, etc.), load the relevant
 sub-skill directly. Still collect context first if not already provided.

diff --git a/skills/ads-apple/SKILL.md b/skills/ads-apple/SKILL.md
@@ -1,22 +1,18 @@
 ---
 name: ads-apple
-description: >
-  Apple Search Ads (ASA) deep analysis for mobile app advertisers. Evaluates
-  campaign structure, bid health, Creative Sets, MMP attribution, budget pacing,
-  TAP coverage (Today/Search/Product Pages), and goal CPA benchmarks by country.
-  Use when user says "Apple Search Ads", "ASA", "App Store ads", "Apple ads",
-  "Search Ads", or is advertising a mobile app on iOS.
+description: "Apple Search Ads (ASA) deep analysis for mobile app advertisers. Evaluates campaign structure, bid health, Creative Sets, MMP attribution, budget pacing, TAP coverage (Today/Search/Product Pages), and goal CPA benchmarks by country. Use when user says 'Apple Search Ads', 'ASA', 'App Store ads', 'Apple ads', 'Search Ads', or is advertising a mobile app on iOS."
 ---
 
 # Apple Search Ads (ASA) Deep Analysis
 
 ## Process
 
 1. Collect ASA account data (exports from Apple Search Ads dashboard or pasted metrics)
-2. Identify active placement types (Search Results, Search Tab, Today Tab, Product Pages)
-3. Evaluate all applicable checks as PASS, WARNING, or FAIL
-4. Calculate ASA Health Score (0-100)
-5. Generate findings report with action plan
+2. **Validate**: confirm data includes campaign-level spend, installs, and CPT for ≥30 days
+3. Identify active placement types (Search Results, Search Tab, Today Tab, Product Pages)
+4. Evaluate all applicable checks as PASS, WARNING, or FAIL
+5. Calculate ASA Health Score (0-100)
+6. Generate findings report with action plan
 
 ## What to Analyze
 

diff --git a/skills/ads-audit/SKILL.md b/skills/ads-audit/SKILL.md
@@ -1,29 +1,26 @@
 ---
 name: ads-audit
-description: >
-  Full multi-platform paid advertising audit with parallel subagent delegation.
-  Analyzes Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, and Microsoft Ads
-  accounts. Generates health score per platform and aggregate score. Use when
-  user says "audit", "full ad check", "analyze my ads", "account health check",
-  or "PPC audit".
+description: "Full multi-platform paid advertising audit with parallel subagent delegation. Analyzes Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, and Microsoft Ads accounts. Generates health score per platform and aggregate score. Use when user says 'audit', 'full ad check', 'analyze my ads', 'account health check', or 'PPC audit'."
 ---
 
 # Full Multi-Platform Ads Audit
 
 ## Process
 
 1. **Collect account data** — request exports, screenshots, or API access
-2. **Detect business type** — analyze account signals per ads orchestrator
-3. **Identify active platforms** — determine which platforms are in use
-4. **Delegate to subagents** (if available, otherwise run inline sequentially):
+2. **Validate**: confirm at least one platform's data is available before proceeding
+3. **Detect business type** — analyze account signals per ads orchestrator
+4. **Identify active platforms** — determine which platforms are in use
+5. **Delegate to subagents** (if available, otherwise run inline sequentially):
    - `audit-google` — Conversion tracking, wasted spend, structure, keywords, ads, settings (G01-G74)
    - `audit-meta` — Pixel/CAPI health, creative fatigue, structure, audience (M01-M46)
    - `audit-creative` — LinkedIn, TikTok, Microsoft creative checks + cross-platform synthesis
    - `audit-tracking` — LinkedIn, TikTok, Microsoft tracking + cross-platform tracking health
    - `audit-budget` — LinkedIn, TikTok, Microsoft budget/bidding + cross-platform allocation
    - `audit-compliance` — All-platform compliance, settings, performance benchmarks
-5. **Score** — calculate per-platform and aggregate Ads Health Score (0-100)
-6. **Report** — generate prioritized action plan with Quick Wins
+6. **Validate**: verify each subagent returned valid scores with required fields before aggregating
+7. **Score** — calculate per-platform and aggregate Ads Health Score (0-100)
+8. **Report** — generate prioritized action plan with Quick Wins
 
 ## Data Collection
 

diff --git a/skills/ads-budget/SKILL.md b/skills/ads-budget/SKILL.md
@@ -1,11 +1,6 @@
 ---
 name: ads-budget
-description: >
-  Budget allocation and bidding strategy review across all ad platforms.
-  Evaluates spend distribution, bidding strategy appropriateness, scaling
-  readiness, and identifies campaigns to kill or scale. Uses 70/20/10 rule,
-  3x Kill Rule, and 20% scaling rule. Use when user says "budget allocation",
-  "bidding strategy", "ad spend", "ROAS target", "media budget", or "scaling".
+description: "Budget allocation and bidding strategy review across all ad platforms. Evaluates spend distribution, bidding strategy appropriateness, scaling readiness, and identifies campaigns to kill or scale. Uses 70/20/10 rule, 3x Kill Rule, and 20% scaling rule. Use when user says 'budget allocation', 'bidding strategy', 'ad spend', 'ROAS target', 'media budget', or 'scaling'."
 ---
 
 # Budget Allocation & Bidding Strategy
@@ -17,8 +12,10 @@ description: >
 3. Read `ads/references/bidding-strategies.md` for strategy decision trees
 4. Read `ads/references/benchmarks.md` for CPC/CPA benchmarks
 5. Read `ads/references/scoring-system.md` for health score algorithm
-6. Evaluate budget allocation, bidding strategy, and scaling readiness
-7. Generate recommendations with kill list and scale list
+6. **Validate**: confirm spend data covers ≥14 days before evaluating kill/scale decisions
+7. Evaluate budget allocation, bidding strategy, and scaling readiness
+8. **Validate**: verify kill list candidates have sufficient data (≥20 clicks or ≥$100 spend) before recommending pause
+9. Generate recommendations with kill list and scale list
 
 ## Budget Allocation Framework
 

diff --git a/skills/ads-competitor/SKILL.md b/skills/ads-competitor/SKILL.md
@@ -1,11 +1,6 @@
 ---
 name: ads-competitor
-description: >
-  Competitor ad intelligence analysis across Google, Meta, LinkedIn, TikTok,
-  and Microsoft. Analyzes competitor ad copy, creative strategy, keyword
-  targeting, estimated spend, and identifies competitive gaps and opportunities.
-  Use when user says "competitor ads", "ad spy", "competitive analysis",
-  "competitor PPC", or "ad intelligence".
+description: "Competitor ad intelligence analysis across Google, Meta, LinkedIn, TikTok, and Microsoft. Analyzes competitor ad copy, creative strategy, keyword targeting, estimated spend, and identifies competitive gaps and opportunities. Use when user says 'competitor ads', 'ad spy', 'competitive analysis', 'competitor PPC', or 'ad intelligence'."
 ---
 
 # Competitor Ad Intelligence
@@ -14,11 +9,13 @@ description: >
 
 1. Identify target competitors (from user input or industry analysis)
 2. Read `ads/references/benchmarks.md` for industry CPC/CTR/CVR baselines
-3. Research competitor ad presence across platforms
-4. Analyze ad copy, creative, and messaging themes
-5. Estimate competitor spend and keyword strategy
-6. Identify gaps and opportunities
-7. Generate competitive intelligence report
+3. Research competitor ad presence across platforms using free intelligence sources
+4. **Validate**: confirm ≥2 competitors identified with active ads before proceeding
+5. Analyze ad copy, creative, and messaging themes
+6. Estimate competitor spend and keyword strategy
+7. Identify gaps and opportunities
+8. **Validate**: verify gap analysis references actual competitor data, not assumptions
+9. Generate competitive intelligence report
 
 ## Data Sources
 
@@ -33,54 +30,28 @@ description: >
 
 ### Google Ads Auction Insights
 Available from the user's own Google Ads account:
-- Impression share vs competitors
-- Overlap rate (how often you compete)
-- Outranking share (who wins more often)
+- Impression share, overlap rate, outranking share
 - Top of page rate and absolute top of page rate
 - Available for Search and Shopping campaigns
 
-### Platform-Specific Research
-
-#### Google
-- Ads Transparency Center: search by advertiser name or domain
-- Search for competitor brand terms to see their ads live
-- Auction Insights for impression share comparison
-
-#### Meta
-- Ad Library: filter by advertiser, country, platform (FB/IG), date range
-- Shows creative (image/video), ad copy, active dates
-- Shows platform placement (Facebook, Instagram, Audience Network)
-
-#### LinkedIn
-- Ad Library: search by company name
-- Shows Sponsored Content, Message Ads
-- Limited data compared to Meta Ad Library
-
-#### TikTok
-- Creative Center: top-performing ads by industry, country, objective
-- Hashtag analytics: trending sounds and hashtags
-- No per-advertiser library — use Creative Center for industry trends
-
 ## Competitive Analysis Framework
 
 ### 1. Ad Copy Analysis
 For each competitor, document:
 - **Headlines**: primary messages and value propositions
-- **CTAs**: what action they're driving (free trial, demo, buy now, learn more)
-- **Offers**: pricing, discounts, free shipping, trials
+- **CTAs**: what action they're driving
+- **Offers**: pricing, discounts, trials
 - **Tone**: professional, casual, urgent, educational, emotional
-- **USPs**: unique selling propositions they emphasize
-- **Pain points**: customer problems they address
+- **USPs**: unique selling propositions emphasized
+- **Pain points**: customer problems addressed
 
 ### 2. Creative Strategy Analysis
 - **Formats used**: image, video, carousel, collection, document
 - **Visual style**: photography, illustration, UGC, stock, branded
-- **Video approach**: studio quality vs UGC vs animated
-- **Creative volume**: how many active ads (indicator of testing velocity)
+- **Creative volume**: number of active ads (testing velocity indicator)
 - **Refresh frequency**: how often new creatives appear
 
-### 3. Messaging Themes
-Categorize competitor messaging into themes:
+### 3. Messaging Theme Matrix
 | Theme | Competitor A | Competitor B | Your Brand |
 |-------|-------------|-------------|------------|
 | Price/Value | ✅ Primary | ⚠️ Secondary | ? |
@@ -91,71 +62,55 @@ Categorize competitor messaging into themes:
 
 ### 4. Keyword Intelligence (Google/Microsoft)
 - Brand keyword bidding: are competitors bidding on your brand?
-- Keyword overlap: which non-brand terms do you both target?
-- Keyword gaps: terms competitors rank for that you don't target
-- Match type strategy: estimated match types from ad triggers
+- Keyword overlap and gaps vs competitors
+- Match type strategy estimated from ad triggers
 
 ### 5. Spend Estimation
-- Meta Ad Library shows spend ranges for political/social ads
-- Google Auction Insights + impression share = directional spend estimate
-- Third-party tools (SEMrush, SpyFu) for more precise estimates
-- Manual estimation formula:
-  ```
-  Estimated Monthly Spend = Impressions × CPM / 1000
-  or
-  Estimated Monthly Spend = Clicks × Estimated CPC
-  ```
+```
+Estimated Monthly Spend = Impressions × CPM / 1000
+— or —
+Estimated Monthly Spend = Clicks × Estimated CPC
+```
+Cross-reference with: Meta Ad Library spend ranges, Google Auction Insights impression share, third-party tools (SEMrush, SpyFu).
 
 ## Gap & Opportunity Identification
 
 ### Platform Gaps
-- Which platforms are competitors NOT on? (opportunity to own)
-- Which platforms are they underspending on? (opportunity to outspend)
+- Which platforms are competitors absent from or underspending on?
 
 ### Messaging Gaps
-- What customer pain points are NO competitors addressing?
-- What value propositions are underrepresented in the market?
-- What content formats are competitors not using?
+- Unaddressed customer pain points
+- Underrepresented value propositions
+- Unused content formats
 
 ### Audience Gaps
-- What demographics/segments are competitors not targeting?
-- What geographic markets are underserved?
-- What funnel stages are competitors neglecting?
+- Untargeted demographics/segments
+- Underserved geographic markets
+- Neglected funnel stages
 
 ### Creative Gaps
-- What ad formats are competitors not using? (video, UGC, Spark Ads)
-- What creative styles are missing from the competitive landscape?
-- What platform-specific features are competitors not leveraging?
+- Unused ad formats (video, UGC, Spark Ads)
+- Missing creative styles
+- Unleveraged platform-specific features
 
-## Competitive Response Strategy
+## Competitive Response Playbook
 
 ### When Competitors Bid on Your Brand
-- Always run brand campaigns to defend (low CPC, high CTR)
-- Dynamic keyword insertion to show your brand prominently
-- Sitelinks to key pages (pricing, features, reviews)
-- Ad copy that emphasizes unique differentiators
-- Consider bidding on competitor brand terms (know the rules)
+- Run brand campaigns (low CPC, high CTR defense)
+- Dynamic keyword insertion + sitelinks to key pages
+- Ad copy emphasizing unique differentiators
 
 ### When You're Outspent
-- Focus on efficiency over volume (better targeting, creative, landing pages)
 - Target long-tail keywords competitors ignore
-- Use Exact match for precision (less waste)
-- Double down on retargeting (lower CPA than prospecting)
-- Compete on creative quality, not budget
+- Exact match for precision, retargeting for efficiency
+- Compete on creative quality and landing page experience
 
 ## Output
 
 ### Deliverables
 - `COMPETITOR-INTELLIGENCE-REPORT.md` — Full competitive analysis
-  - Per-competitor ad presence summary
-  - Ad copy and messaging analysis
-  - Creative strategy comparison
-  - Estimated spend levels
-  - Keyword overlap and gaps
-- `COMPETITIVE-GAPS.md` — Opportunities identified from competitor analysis
-  - Platform gaps
-  - Messaging opportunities
-  - Audience segments to target
-  - Creative format opportunities
+  - Per-competitor ad presence, copy analysis, creative comparison, spend estimates, keyword gaps
+- `COMPETITIVE-GAPS.md` — Opportunities identified
+  - Platform, messaging, audience, and creative gaps
 - Strategic recommendations for competitive positioning
-- Priority actions to gain competitive advantage
+- Priority actions ranked by competitive advantage potential
diff --git a/skills/ads-create/SKILL.md b/skills/ads-create/SKILL.md
@@ -1,12 +1,6 @@
 ---
 name: ads-create
-description: >
-  Campaign concept and copy brief generator for paid advertising. Reads
-  brand-profile.json and optional audit results to produce structured campaign
-  concepts, messaging pillars, and copy briefs. Outputs campaign-brief.md to
-  the current directory. Run after /ads dna and before /ads generate. Triggers
-  on: "create campaign", "campaign brief", "ad concepts", "write ad copy",
-  "campaign strategy", "ad messaging", "creative brief", "generate concepts".
+description: "Campaign concept and copy brief generator for paid advertising. Reads brand-profile.json and optional audit results to produce structured campaign concepts, messaging pillars, and copy briefs. Outputs campaign-brief.md to the current directory. Run after /ads dna and before /ads generate. Triggers on: 'create campaign', 'campaign brief', 'ad concepts', 'write ad copy', 'campaign strategy', 'ad messaging', 'creative brief', 'generate concepts'."
 ---
 
 # Ads Create — Campaign Concept & Copy Brief Generator

diff --git a/skills/ads-creative/SKILL.md b/skills/ads-creative/SKILL.md
@@ -1,11 +1,6 @@
 ---
 name: ads-creative
-description: >
-  Cross-platform creative quality audit covering ad copy, video, image, and
-  format diversity across all platforms. Detects creative fatigue, evaluates
-  platform-native compliance, and provides production priorities. Use when
-  user says "creative audit", "ad creative", "creative fatigue", "ad copy",
-  "ad design", or "creative review".
+description: "Cross-platform creative quality audit covering ad copy, video, image, and format diversity across all platforms. Detects creative fatigue, evaluates platform-native compliance, and provides production priorities. Use when user says 'creative audit', 'ad creative', 'creative fatigue', 'ad copy', 'ad design', or 'creative review'."
 ---
 
 # Cross-Platform Creative Quality Audit
@@ -16,9 +11,11 @@ description: >
 2. Read `ads/references/platform-specs.md` for creative specifications
 3. Read `ads/references/benchmarks.md` for CTR/engagement benchmarks
 4. Read `ads/references/scoring-system.md` for weighted scoring algorithm
-5. Evaluate creative quality per platform
-6. Assess cross-platform creative consistency
-7. Generate production priority recommendations
+5. **Validate**: confirm at least one platform has creative data before proceeding
+6. Evaluate creative quality per platform
+7. Assess cross-platform creative consistency
+8. **Validate**: verify fatigue signals reference actual performance trends, not assumptions
+9. Generate production priority recommendations
 
 ## Per-Platform Assessment
 

diff --git a/skills/ads-dna/SKILL.md b/skills/ads-dna/SKILL.md
@@ -1,12 +1,6 @@
 ---
 name: ads-dna
-description: >
-  Brand DNA extractor for paid advertising. Scans a website URL to extract
-  visual identity, tone of voice, color palette, typography, and imagery style.
-  Outputs brand-profile.json to the current directory. Run before /ads create
-  or /ads generate for brand-consistent creative. Triggers on: "brand DNA",
-  "brand profile", "extract brand", "brand identity", "brand colors",
-  "what is the brand voice", "analyze brand", "brand style guide".
+description: "Brand DNA extractor for paid advertising. Scans a website URL to extract visual identity, tone of voice, color palette, typography, and imagery style. Outputs brand-profile.json to the current directory. Run before /ads create or /ads generate for brand-consistent creative. Triggers on: 'brand DNA', 'brand profile', 'extract brand', 'brand identity', 'brand colors', 'what is the brand voice', 'analyze brand', 'brand style guide'."
 ---
 
 # Ads DNA — Brand DNA Extractor

diff --git a/skills/ads-generate/SKILL.md b/skills/ads-generate/SKILL.md
@@ -1,12 +1,6 @@
 ---
 name: ads-generate
-description: >
-  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".
+description: "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'."
 ---
 
 # Ads Generate — AI Ad Image Generator