openads-ai 0.1.0

package/skills/research/customer-research.md

@@ -0,0 +1,63 @@
+---
+name: customer-research
+description: Understand your audience before writing a single ad.
+---
+# Customer Research
+
+## When to Use This Skill
+
+Activate when the user needs to:
+- Define or refine their Ideal Customer Profile (ICP)
+- Understand what language their customers use (voice-of-customer)
+- Identify pain points, objections, and buying triggers
+- Research a new market or audience segment before launching ads
+
+Read `product-marketing.md` first to check if context already exists.
+
+---
+
+## Research Frameworks
+
+### 1. Jobs To Be Done (JTBD)
+Ask: "When [situation], I want to [motivation], so I can [outcome]."
+This reveals the real reason people buy — not the feature, but the progress they're trying to make.
+
+### 2. Voice-of-Customer Mining
+Pull real language from:
+- G2/Capterra reviews (yours and competitors)
+- Reddit threads in your niche
+- Support tickets and chat logs
+- Sales call transcripts
+- Amazon reviews for adjacent products
+
+Use their exact words in ad copy. Customers describe problems better than marketers do.
+
+### 3. The "Five Whys" for Pain Points
+Start with the surface problem and ask "why?" five times to get to the emotional root:
+1. "Our sales are down" → Why?
+2. "We're not getting enough leads" → Why?
+3. "Our ads aren't converting" → Why?
+4. "We're targeting the wrong people" → Why?
+5. "We don't actually know who our best customer is" ← This is the real problem.
+
+---
+
+## Output Format
+
+When completing customer research, produce a structured brief:
+
+```yaml
+audience:
+  who: ""           # Job title, demographics, or persona
+  situation: ""     # What's happening in their life/business right now
+  pain_points:
+    - ""            # Top 3 pains in their own words
+  objections:
+    - ""            # Top 3 reasons they wouldn't buy
+  buying_triggers:
+    - ""            # What makes them start looking for a solution
+  success_metric: "" # How they measure if it worked
+  language:
+    words_they_use: []   # Exact phrases from reviews/forums
+    words_to_avoid: []   # Jargon or terms that don't resonate
+```

package/skills/strategy/go-to-market.md

@@ -0,0 +1,57 @@
+---
+name: go-to-market
+description: Plan launches, budget allocation, and channel strategy.
+---
+# Go-To-Market (GTM) Strategy Skill
+
+## When to Use This Skill
+
+Activate when the user is:
+- Launching a new product, service, or campaign
+- Planning GTM budget and distribution channels
+- Designing a value-based pricing model
+- Analyzing Product-Market Fit (PMF)
+
+Read `product-marketing.md` first to align with the core Ideal Customer Profile (ICP) and value proposition.
+
+---
+
+## 📈 Product-Market Fit (PMF) Scoring
+Before spending a single dollar on paid ads, verify if the product is ready. Use the **Sean Ellis PMF Survey Rule**:
+*   Ask early users: *"How would you feel if you could no longer use this product?"*
+*   If **≥ 40%** answer **"Very Disappointed"**, the product has achieved baseline PMF and is ready for paid scaling.
+*   If **< 40%**, focus on product improvements, user onboarding, and copy clarity before spending on advertising.
+
+---
+
+## 💰 GTM Budget Allocation
+For early-stage products or new launches, follow the **70 / 20 / 10 Rule** for budget allocation:
+
+1.  **70% — Core (Proven Channels & Audiences):**
+    *   Focus on high-intent search (Google Ads exact match) or highly proven interest cohorts on Meta.
+    *   Goal: Reliable, low-cost conversions to prove the unit economics.
+2.  **20% — Amplification (New Angles & Audiences):**
+    *   Test adjacent customer profiles or new platforms (e.g., running LinkedIn Ads if Google is fully saturated).
+    *   Goal: Discover the next scaling lever.
+3.  **10% — Experimental (High-Risk, High-Reward):**
+    *   Test bold hooks, sponsorship integrations, or interactive tools.
+    *   Goal: Uncover unconventional acquisition channels.
+
+---
+
+## 🗺️ Channel Selection Matrix
+Choose paid channels based on where the ICP spends time and how they buy:
+
+*   **Google Search Ads:** Best for **high-intent buyers** who are actively searching for a solution. Use exact match STAGs (Single Theme Ad Groups).
+*   **Meta Ads (FB/IG):** Best for **demand generation** (interruptive marketing). You must explain the problem in the first 3 seconds of video, as users are not actively looking to buy.
+*   **LinkedIn Ads:** Best for **B2B products** where buying decisions are based on professional job titles, company size, or industry. Focus on thought leadership or downloadable guides.
+*   **Local / Organic:** Best for **organic compound growth** (SEO and community). Must be paired with a clear, benefit-driven value proposition.
+
+---
+
+## 🎯 GTM Launch Checklist
+1.  [ ] **ICP Defined:** Clear understanding of job titles, key pain points, and success metrics.
+2.  [ ] **Value Metric Aligned:** Pricing is structured around how the customer measures success.
+3.  [ ] **Analytics Set Up:** GA4 installed with `generate_lead` or `purchase` events tracking properly.
+4.  [ ] **15 Headlines + 4 Descriptions Drafted:** Ad copy prepared following the benefit-driven structure.
+5.  [ ] **Retargeting Pixel Active:** Meta pixel or Google tag active to capture early traffic.

package/templates/audit-google-ads.md

@@ -0,0 +1,14 @@
+---
+description: Perform a comprehensive audit of Google Ads campaigns
+---
+
+You are the Google Ads Auditor. 
+The user has requested a full audit of their Google Ads account.
+
+1. First, check if the Google Ads MCP is connected. If it is, use `list_accounts` to see available accounts, and `get_campaign_performance` to analyze the top spending campaigns.
+2. If it is not connected, ask the user to export their campaign, keyword, and search terms reports as CSVs and paste them or provide them to you.
+3. Apply the `google-ads.md` skill to analyze structure, bidding, quality score, and ad copy.
+4. Provide a structured report with:
+   - 🔴 Critical Issues (e.g. budget bleed, broad match on manual CPC)
+   - 🟡 Warnings (e.g. low quality scores, ad groups with too many keywords)
+   - 🟢 Opportunities (e.g. adding extensions, improving RSA ad strength)

package/templates/autoresearch-plan.md

@@ -0,0 +1,14 @@
+---
+description: Launch the configuration wizard for an autonomous marketing iteration loop
+---
+
+You are the Autoresearch planner. The user wants to set up an autonomous loop to iterate on marketing assets (ad copy, landing pages, hypotheses).
+
+Your task is to ask the user 3 questions to define the boundaries of the loop. Ask them one by one, or if they provided enough context upfront, draft the plan for them.
+
+The 3 things you need to define:
+1. **The Goal**: What exactly are we generating or optimizing? (e.g. "Generate 50 headlines", "Find 3 ad variants with Excellent strength")
+2. **The Metric**: How will we score them? (e.g. "Character limits + PAS framework", or using an MCP tool)
+3. **The Scope**: What are the strict constraints? (e.g. "Must mention our main differentiator, no clickbait")
+
+Once you have these 3 things, output a final **Autoresearch Plan** block and ask the user if they want to start the loop.

package/templates/go-to-market.md

@@ -0,0 +1,10 @@
+---
+description: Create a comprehensive Go-To-Market strategy for your product
+---
+
+You are the Go-To-Market Strategist.
+The user wants to plan their launch or distribution strategy.
+
+1. Read `product-marketing.md` to understand the product value proposition and ICP.
+2. Apply the `go-to-market.md` strategy skill to evaluate Product-Market Fit scoring, budget allocation rules (70/20/10 rule), and target channel strategies.
+3. Guide the marketer through drafting their GTM strategy document and custom launch checklist.

package/templates/write-ad-copy.md

@@ -0,0 +1,13 @@
+---
+description: Generate high-performing ad copy for any platform
+---
+
+You are the Ad Copywriter.
+The user wants you to write ad copy. 
+
+1. Ask them which platform (Google Ads, Meta, TikTok, LinkedIn) if they haven't specified.
+2. Read `product-marketing.md` to understand the core value prop and ICP.
+3. Apply the relevant skill for the chosen platform (e.g., `google-ads.md` for RSAs, `meta-ads.md` for Facebook feeds).
+4. Apply the `copywriting.md` and `ad-creative.md` skills to ensure strong hooks and clear benefits.
+5. Provide at least 3 distinct angles or variants (e.g., Pain, Social Proof, Curiosity).
+6. If the MCP for that platform is connected, offer to draft the ads directly to their account (paused) for their review.