openads-ai 0.3.0 → 0.4.0

package/dist/doctor.js

@@ -92,6 +92,45 @@ export async function runDoctor() {
         console.log(`  ${chalk.red('✗')} uvx: Not installed. Run 'curl -LsSf https://astral.sh/uv/install.sh | sh'`);
         hasErrors = true;
     }
+    // ─── Local AI Check ────────────────────────────────────────────────
+    if (config?.localBaseUrl) {
+        console.log(`\n${chalk.bold('Local AI')}`);
+        const baseUrl = config.localBaseUrl.replace(/\/$/, '');
+        // 1. Check if the endpoint is reachable
+        try {
+            const tagsUrl = `${baseUrl.replace('/v1', '')}/api/tags`;
+            const res = await fetch(tagsUrl, { signal: AbortSignal.timeout(3000) });
+            if (res.ok) {
+                const data = await res.json();
+                const models = (data.models || []).map((m) => m.name || m.model || '');
+                console.log(`  ${chalk.green('✓')} Ollama server: Reachable at ${baseUrl}`);
+                // 2. Check if the configured model is pulled
+                const configuredModel = config.provider.includes('/')
+                    ? config.provider.split('/').pop()
+                    : config.provider;
+                const modelFound = models.some(m => m === configuredModel || m.startsWith(configuredModel.split(':')[0]));
+                if (modelFound) {
+                    console.log(`  ${chalk.green('✓')} Model: ${chalk.cyan(configuredModel)} is available`);
+                }
+                else {
+                    console.log(`  ${chalk.red('✗')} Model: ${chalk.cyan(configuredModel)} not found in Ollama`);
+                    console.log(`     ${chalk.gray('Available models:')} ${models.length > 0 ? models.join(', ') : 'none'}`);
+                    console.log(`     ${chalk.gray(`Run: ollama pull ${configuredModel}`)}`);
+                    hasErrors = true;
+                }
+            }
+            else {
+                console.log(`  ${chalk.red('✗')} Ollama server: Not reachable at ${baseUrl}`);
+                console.log(`     ${chalk.gray('Start Ollama with: ollama serve')}`);
+                hasErrors = true;
+            }
+        }
+        catch (e) {
+            console.log(`  ${chalk.red('✗')} Ollama server: Connection failed — ${e.message}`);
+            console.log(`     ${chalk.gray('Make sure Ollama is running: ollama serve')}`);
+            hasErrors = true;
+        }
+    }
     if (hasErrors) {
         console.log(`\n${chalk.red('Some checks failed. Please run `openads setup` to configure your environment.')}`);
         process.exit(1);

package/dist/mcp-extension.js

@@ -4,16 +4,20 @@ import { hasGlobalRtk } from "./token-optimizer.js";
 import fs from "fs";
 import path from "path";
 import os from "os";
-// ─── Essential Campaign Analysis & Audit Tools ──────────────────────
-// Filtering down from 39 tools to 11 essential campaign performance tools
-// massively optimizes local LLM context, prevents tool confusion, and breaks repeating loops.
-const ESSENTIAL_META_TOOLS = new Set([
+// ─── Tier-Based Tool Filtering ──────────────────────────────────────
+// Express → skip MCP entirely (handled by OPENADS_SKIP_MCP env var)
+// Standard → 6 read-only discovery + performance tools
+// Full → 11 tools (read + write operations)
+const STANDARD_META_TOOLS = new Set([
     "get_ad_accounts",
     "list_campaigns",
     "get_campaign",
     "get_campaign_performance",
     "get_insights",
-    "list_ad_sets",
+    "list_ad_sets"
+]);
+const FULL_META_TOOLS = new Set([
+    ...STANDARD_META_TOOLS,
     "list_ads",
     "get_creative_performance",
     "pause_campaign",
@@ -33,6 +37,12 @@ export default async function (pi) {
     catch (e) {
         return;
     }
+    // Skip MCP tool registration during Autoresearch.
+    // The model never needs live ad platform tools when generating hypotheses,
+    // and each tool schema consumes ~150 tokens of scarce context.
+    if (process.env.OPENADS_SKIP_MCP === '1') {
+        return;
+    }
     const clients = [];
     // ─── Google Ads MCP ───────────────────────────────────────────────
     if (config.connectGoogle) {
@@ -77,12 +87,14 @@ export default async function (pi) {
         }
     }
     // ─── Dynamically Register Tools ──────────────────────────────────
+    const tier = process.env.OPENADS_TIER || 'standard';
+    const allowedMetaTools = tier === 'full' ? FULL_META_TOOLS : STANDARD_META_TOOLS;
     for (const { name: serverName, client } of clients) {
         try {
             const toolsResult = await client.listTools();
             for (const tool of toolsResult.tools) {
-                // Filter out advanced/OAuth/developer tools for Meta Ads to keep the LLM context extremely clean
-                if (serverName === "meta-ads" && !ESSENTIAL_META_TOOLS.has(tool.name)) {
+                // Filter Meta tools by tier (standard=6 read-only, full=11 read+write)
+                if (serverName === "meta-ads" && !allowedMetaTools.has(tool.name)) {
                     continue;
                 }
                 pi.registerTool({

package/dist/schedule.js

@@ -206,6 +206,8 @@ function uninstallCrontab(name) {
     });
 }
 // ─── Run a Scheduled Task ────────────────────────────────────────────
+// Applies the same mode-aware prompt + selective skill loading as the main CLI
+// so scheduled tasks work reliably on local models.
 export async function runScheduledTask(name) {
     const schedules = loadSchedules();
     const schedule = schedules.find(s => s.name === name);
@@ -247,23 +249,74 @@ export async function runScheduledTask(name) {
         env.OPENAI_BASE_URL = config.localBaseUrl;
         env.OPENAI_API_KEY = env.OPENAI_API_KEY || 'sk-local-ai-key-placeholder';
     }
-    const skillsDir = path.resolve(pkgDir, 'skills');
-    const contextDir = path.join(CONFIG_DIR, 'context');
-    const cleanModel = config.provider;
     const isLocal = !!config.localBaseUrl;
+    const cleanModel = config.provider;
     const modelIdForPi = isLocal && cleanModel.includes('/') ? cleanModel.split('/')[1] : cleanModel;
+    const skillsDir = path.resolve(pkgDir, 'skills');
+    const contextDir = path.join(CONFIG_DIR, 'context');
+    // ─── Mode-aware system prompt ───────────────────────────────────────
+    // Scheduled audit tasks use the 'default' prompt mode (they need MCP tools).
+    // Write a temporary system prompt file for this run.
+    const agentDir = path.join(CONFIG_DIR, 'agent');
+    if (!fs.existsSync(agentDir))
+        fs.mkdirSync(agentDir, { recursive: true });
+    const homeDir = os.homedir();
+    const contextPath = path.join(CONFIG_DIR, 'context', 'my-business.md');
+    const isLaunchMode = config.mode === 'launch';
+    const scheduleSystemPrompt = [
+        'You are OpenAds, an AI marketing assistant. You are running a scheduled automated task.',
+        'Your job: execute the task concisely and produce a clean, structured markdown report.',
+        'Use MCP tools to query live campaign data. Never use placeholder IDs.',
+        '',
+        '## Platform Tools',
+        '- For Meta: call get_ad_accounts() first (no params), then list_campaigns(account_id), then get_campaign_performance or get_insights.',
+        '- Anti-loop rule: never call the same tool twice in one turn.',
+        '',
+        '## Output Rules',
+        '- Structure your output as a clean markdown report with headers, tables, and bullet points.',
+        '- Flag issues clearly: 🔴 Critical | 🟡 Warning | 🟢 Opportunity.',
+        '- End with a numbered list of recommended actions.',
+        '',
+        `## Safety`,
+        `- Home directory: ${homeDir}. Never use placeholder paths.`,
+        isLaunchMode
+            ? '- Mode: Launch (Read-Write). Show a preview card and get Y/N before any write operation.'
+            : '- Mode: Audit (Read-Only). You can only read and analyze — no writes.',
+        '',
+        `## Business Context`,
+        fs.existsSync(contextPath)
+            ? `Read your business context file at ${contextPath} before starting.`
+            : 'No business context file found. Proceed with the task using available data.',
+    ].join('\n');
+    const scheduleSysPromptPath = path.join(agentDir, 'SCHEDULE-SYSTEM.md');
+    fs.writeFileSync(scheduleSysPromptPath, scheduleSystemPrompt);
+    // ─── Selective skill loading ────────────────────────────────────────
+    // Scheduled tasks are audit-type by default → load only the 3 ad platform skills.
+    // This saves ~7K tokens vs loading all 24 skills.
+    const scheduleSkills = [
+        path.join(skillsDir, 'ads', 'google-ads.md'),
+        path.join(skillsDir, 'ads', 'meta-ads.md'),
+        path.join(skillsDir, 'product-marketing.md'),
+    ].filter(p => fs.existsSync(p));
+    const skillArgs = [];
+    for (const skill of scheduleSkills) {
+        skillArgs.push('--skill', skill);
+    }
     const args = [
         piCliPath,
         '--model', modelIdForPi,
-        '--skill', skillsDir,
+        '--system-prompt', scheduleSysPromptPath,
+        ...skillArgs,
         ...(fs.existsSync(contextDir) ? ['--skill', contextDir] : []),
         '--print',
         schedule.prompt,
     ];
+    // Local models may be slow — give them up to 10 minutes
+    const timeoutMs = isLocal ? 600000 : 300000;
     const result = spawnSync('node', args, {
         env,
         encoding: 'utf8',
-        timeout: 300000, // 5 minute timeout
+        timeout: timeoutMs,
         stdio: ['ignore', 'pipe', 'pipe'],
     });
     if (result.stdout) {

package/dist/setup.js

@@ -33,7 +33,7 @@ export async function runSetup() {
         catch (e) { }
     }
     // Step 1: Model Selection
-    console.log(chalk.cyan('Step 1/4: Choose your AI model\n'));
+    console.log(chalk.cyan('Step 1/6: Choose your AI model\n'));
     const providerChoices = [
         { name: 'google', message: 'Google (Gemini)' },
         { name: 'openai', message: 'OpenAI (ChatGPT)' },
@@ -210,8 +210,47 @@ export async function runSetup() {
         console.log(chalk.green(`\n✓ Local AI configured — ready to connect to ${localBaseUrl}.\n`));
     }
     console.log(chalk.gray('─────────────────────────────────────────\n'));
-    // Step 2: Choose operational mode
-    console.log(chalk.cyan('Step 2/5: Choose operational mode\n'));
+    // Step 2: Experience Tier
+    console.log(chalk.cyan('Step 2/6: Choose your experience tier\n'));
+    console.log('  OpenAds adapts its depth based on your model\'s capability:\n');
+    console.log(`  ${chalk.yellow('⚡ Express')}   — Fast & reliable. Compact prompts, structured output.`);
+    console.log(`  ${chalk.blue('📊 Standard')}  — Balanced depth. Live data tools, detailed reports.`);
+    console.log(`  ${chalk.magenta('🚀 Full')}      — Maximum depth. Multi-step analysis, creative exploration.\n`);
+    // Auto-detect recommended tier based on model choice
+    const isLocalSetup = provider === 'local';
+    const modelLower = (selectedModel || localModelName || customModel || '').toLowerCase();
+    let suggestedTier = 'full';
+    if (isLocalSetup) {
+        suggestedTier = (modelLower.includes('70b') || modelLower.includes('72b') || modelLower.includes('405b')) ? 'standard' : 'express';
+    }
+    else {
+        const isLiteTier = modelLower.includes('flash') || modelLower.includes('mini') || modelLower.includes('haiku');
+        suggestedTier = isLiteTier ? 'standard' : 'full';
+    }
+    const tierChoices = [
+        { name: 'express', message: `${chalk.yellow('⚡')} Express  — Best for: Llama 8B, Mistral 7B, Phi-3  ${suggestedTier === 'express' ? chalk.green('← Recommended') : ''}` },
+        { name: 'standard', message: `${chalk.blue('📊')} Standard — Best for: Gemini Flash, GPT-4o Mini, Llama 70B  ${suggestedTier === 'standard' ? chalk.green('← Recommended') : ''}` },
+        { name: 'full', message: `${chalk.magenta('🚀')} Full     — Best for: GPT-4o, Claude Sonnet, Gemini Pro  ${suggestedTier === 'full' ? chalk.green('← Recommended') : ''}` },
+    ];
+    let initialTierIndex = tierChoices.findIndex(c => c.name === (existingConfig.tier || suggestedTier));
+    if (initialTierIndex === -1)
+        initialTierIndex = tierChoices.findIndex(c => c.name === suggestedTier);
+    const { selectedTier } = await enquirer.prompt({
+        type: 'select',
+        name: 'selectedTier',
+        message: 'Select your experience tier:',
+        choices: tierChoices,
+        initial: initialTierIndex
+    });
+    const tierLabels = {
+        express: `${chalk.yellow('⚡ Express')}`,
+        standard: `${chalk.blue('📊 Standard')}`,
+        full: `${chalk.magenta('🚀 Full')}`,
+    };
+    console.log(chalk.green(`\n✓ Experience tier: ${tierLabels[selectedTier]}.\n`));
+    console.log(chalk.gray('─────────────────────────────────────────\n'));
+    // Step 3: Choose operational mode
+    console.log(chalk.cyan('Step 3/6: Choose operational mode\n'));
     console.log('OpenAds has two operational modes:');
     console.log(` - ${chalk.green.bold('Audit Mode (Safe / Read-only)')}: AI can analyze performance, find budget waste, and recommend strategies. Zero risk.`);
     console.log(` - ${chalk.red.bold('Launch Mode (Read-Write)')}: AI is authorized to optimize bids, modify budgets, and launch ads (always requires confirmation).\n`);
@@ -228,8 +267,8 @@ export async function runSetup() {
     mode = modeAnswers.selectedMode;
     console.log(chalk.green(`\n✓ Operational mode configured: ${mode === 'launch' ? 'Launch Mode (Read-Write)' : 'Audit Mode (Safe / Read-only)'}.\n`));
     console.log(chalk.gray('─────────────────────────────────────────\n'));
-    // Step 3: Google Ads
-    console.log(chalk.cyan('Step 3/5: Connect Google Ads (optional)\n'));
+    // Step 4: Google Ads
+    console.log(chalk.cyan('Step 4/6: Connect Google Ads (optional)\n'));
     console.log('OpenAds can read and analyze your Google Ads campaigns, keywords, and performance.\n');
     const { connectGoogle } = await enquirer.prompt({
         type: 'confirm',
@@ -268,7 +307,7 @@ export async function runSetup() {
     }
     console.log(chalk.gray('─────────────────────────────────────────\n'));
     // Step 4: Meta Ads
-    console.log(chalk.cyan('Step 4/5: Connect Meta Ads (optional)\n'));
+    console.log(chalk.cyan('Step 5/6: Connect Meta Ads (optional)\n'));
     console.log('OpenAds can read your Meta campaigns, creatives, and audience performance.\n');
     let metaToken = '';
     const { connectMeta } = await enquirer.prompt({
@@ -374,8 +413,8 @@ export async function runSetup() {
         }
     }
     console.log(chalk.gray('─────────────────────────────────────────\n'));
-    // Step 5: Business Context
-    console.log(chalk.cyan('Step 5/5: Tell me about your business\n'));
+    // Step 6: Business Context
+    console.log(chalk.cyan('Step 6/6: Tell me about your business\n'));
     const { productContext } = await enquirer.prompt({
         type: 'input',
         name: 'productContext',
@@ -398,6 +437,7 @@ export async function runSetup() {
         provider: finalModel,
         apiKey,
         localBaseUrl,
+        tier: selectedTier,
         mode,
         connectGoogle,
         metaToken,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openads-ai",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Open-source AI command center for digital marketers. Audit campaigns, write ad copy, and build strategies — from your terminal.",
   "main": "dist/cli.js",
   "bin": {

package/skills/analytics/analytics.md

@@ -1,32 +1,102 @@
 ---
 name: analytics
-description: Set up tracking, analyze traffic, and fix attribution gaps.
+description: Set up tracking, analyze traffic, interpret GA4 data, and fix attribution gaps.
 ---
 # Analytics Skill
 
 ## When to Use This Skill
 
-Activate when analyzing website traffic, setting up GA4, tracking events, or dealing with attribution gaps.
+Activate when the user is:
+- Setting up or auditing GA4 or Google Analytics tracking
+- Diagnosing traffic drops, conversion rate changes, or attribution issues
+- Analyzing funnel performance, event data, or audience behavior
+- Building dashboards or interpreting key marketing metrics
+
+Read `product-marketing.md` first to understand which metrics matter most for this business.
+
+---
+
+## GA4 Audit Checklist
+
+Before drawing conclusions, verify these foundational items:
+
+| Check | How to Verify |
+|-------|---------------|
+| GA4 tag firing | Check Realtime > Events — do page_view events appear? |
+| Conversion events | Confirm key_events are marked in Admin > Events |
+| Cross-domain tracking | Use DebugView to verify cookies persist across domains |
+| Bot traffic exclusion | Admin > Data Filters — is "Internal traffic" excluded? |
+| Sampling thresholds | Use smaller date ranges or BigQuery for sampled reports |
 
 ---
 
-## The Attribution Problem
-Always remind the user: no platform has 100% perfect tracking. 
-- **Platform data (Ads, Meta)** claims credit for everything.
-- **GA4** underreports due to GDPR consent rejection and cross-device drops.
-- **Truth** is usually in the middle. Use GA4 for relative trends, not absolute truth.
-
-## GA4 Event Strategy
-Recommend standard events over custom events when possible:
-1. `generate_lead`
-2. `sign_up`
-3. `purchase`
-4. `add_to_cart`
-
-## UTM Best Practices
-Enforce strict UTM taxonomy:
-- `utm_source`: The platform (e.g., `google`, `facebook`, `linkedin`)
-- `utm_medium`: The channel type (e.g., `cpc`, `social`, `email`)
-- `utm_campaign`: The specific campaign name
-- `utm_content`: The ad variant or creative
-- `utm_term`: The keyword (for search)
+## Core Metrics to Always Report
+
+When summarizing analytics, structure findings around these:
+
+```
+Sessions       | The entry point — is traffic growing or shrinking?
+Engaged rate   | >50% is healthy. <30% is a red flag.
+Avg. engagement| Low time on page = message mismatch or poor UX
+Key events     | Purchases, signups, demo requests — the real measure
+Conversion rate| Key events / Sessions. Benchmark vs. industry.
+Bounce rate    | (GA4 definition differs from UA — clarify which)
+Source/Medium  | Which channels drive quality vs. volume?
+```
+
+---
+
+## Attribution Models
+
+Explain these to the user when comparing channel performance:
+
+- **Last Click** (default): Credits the last touchpoint before conversion. Biased toward bottom-of-funnel channels (search, retargeting).
+- **First Click**: Credits the first touchpoint. Biased toward top-of-funnel (social, display).
+- **Data-Driven** (GA4 default): ML-based, distributes credit across touchpoints. Best for accounts with >1K conversions/month.
+- **Linear**: Equal credit to all touchpoints. Simple but rarely accurate.
+
+> Always ask: "Are you comparing channels using the same attribution model?" Mixing models is a common mistake.
+
+---
+
+## Diagnosing Traffic Drops
+
+If the user reports a traffic or conversion drop:
+
+1. **Isolate the time range**: Compare week-over-week and year-over-year to rule out seasonality.
+2. **Segment by channel**: Did organic, paid, or direct drop? Or all of them?
+3. **Check for tracking breaks**: Did the drop coincide with a code deploy or tag manager update?
+4. **Look at landing pages**: Which pages lost traffic? Is it a crawling/indexing issue?
+5. **Compare device segments**: Did mobile drop while desktop held? Could be a UX or load speed issue.
+6. **Check Search Console**: Organic impressions vs. clicks — ranking drop or CTR drop?
+
+---
+
+## Output Format
+
+When reporting analytics findings, use this structure:
+
+```markdown
+## Analytics Summary — [Date Range]
+
+### 📊 Traffic Overview
+| Metric | This Period | Prior Period | Change |
+|--------|-------------|--------------|--------|
+| Sessions | | | |
+| Engaged Rate | | | |
+| Key Events | | | |
+| CVR | | | |
+
+### 🔴 Critical Issues
+- [Issue]: [Impact] → [Recommended Action]
+
+### 🟡 Warnings
+- [Issue]: [Impact] → [Recommended Action]
+
+### 🟢 Opportunities
+- [Opportunity]: [Potential Impact] → [Next Step]
+
+### 📋 Recommended Actions (Priority Order)
+1. [Action] — [Expected Impact]
+2. [Action] — [Expected Impact]
+```

package/skills/automation/autoresearch-plan.md

@@ -46,6 +46,7 @@ At the end of the interactive planning sequence, output a beautiful **Experiment
 ```
 
 ### Next Action Trigger
-Conclude by asking the user directly:
+- **AUTOMATIC STATE PERSISTENCE**: You MUST automatically save this validated configuration as a JSON file to `~/.openads/active-experiment.json` so that the core loop (`/autoresearch` or `ar-core`) can read and execute it across different terminal sessions!
+- Conclude by asking the user directly:
 **"Would you like me to start the autonomous loop now? (Y/N)"**
 - If they say **Yes**, transition directly into executing the core `/autoresearch` loop using this configuration.

package/skills/automation/autoresearch.md

@@ -19,6 +19,13 @@ The core philosophy of Autoresearch is:
 
 When running the loop, execute at least **3 full cycles** autonomously before presenting the final results. Do not stop to prompt the user between cycles.
 
+### Phase 0: Validate Goal & Metric (MUST NOT GUESS)
+- Before you begin any loop cycles, you MUST check if there is an active experiment plan saved on disk in `~/.openads/active-experiment.json`.
+- If the file `~/.openads/active-experiment.json` exists, read it immediately! Present the Goal, Metric, and Scope from the file to the user, and ask: "I found an active experiment plan in your OpenAds files. Goal: [Goal], Metric: [Metric]. Would you like to run the autonomous loop on this config? (Y/N) or define a new one?"
+- If the file does not exist, and the user hasn't explicitly specified their target Goal and Metric in their message, you MUST halt immediately, present 3 concrete, inspiring examples of B2B/Shopify goals and metrics, and ask the user to input their custom Goal and Metric before launching the loop.
+  - **NO PLACEHOLDER PATHS**: When reading files, always use the literal home directory path provided in the system prompt. Never use generic placeholders like `/Users/username/Desktop/`.
+- **NEVER** guess a goal/metric or automatically proceed with loop cycles on a generic assumption!
+
 ### Phase 1: Ingest Fuel & Initialize
 - Quickly review `product-marketing.md` and any provided prior experiment data (like a CSV or campaign performance logs).
 - **CONCISE INGESTION RULE**: Extract 3-5 high-level patterns of what worked and what failed. Do not list individual rows or campaigns one-by-one.

package/skills/express/analytics.md

@@ -0,0 +1,23 @@
+---
+name: analytics-express
+description: Analyze traffic and conversion metrics.
+---
+# Analytics
+
+Analyze the user's traffic and conversion data. Focus on actionable insights, not raw numbers.
+
+## Output Format
+
+### 📊 Analytics Summary
+
+| Metric | Value | Trend | Verdict |
+|--------|-------|-------|---------|
+| Sessions | [X] | [↑/↓ X%] | [Good/Bad/Watch] |
+| Conversion Rate | [X%] | [↑/↓ X%] | [Good/Bad/Watch] |
+| Bounce Rate | [X%] | [↑/↓ X%] | [Good/Bad/Watch] |
+| Top Channel | [name] | [↑/↓ X%] | [Good/Bad/Watch] |
+
+### Key Findings
+- 🔴 [Critical finding] → [Action]
+- 🟡 [Warning] → [Action]
+- 🟢 [Opportunity] → [Action]

package/skills/express/audit.md

@@ -0,0 +1,28 @@
+---
+name: audit-express
+description: Quick campaign performance audit.
+---
+# Campaign Audit
+
+Check the user's ad campaigns and flag issues clearly.
+
+If the user pasted campaign data, analyze it directly. If no data is provided, ask them to paste their campaign metrics or describe their campaigns.
+
+## Output Format
+
+Use this exact structure:
+
+### 📊 Campaign Overview
+| Campaign | Status | Spend | CTR | ROAS | Conversions |
+|----------|--------|-------|-----|------|-------------|
+| [name] | [active/paused] | [$X] | [X%] | [Xx] | [X] |
+
+### Issues Found
+- 🔴 **[Critical]**: [Issue] → [Fix in 1 sentence]
+- 🟡 **[Warning]**: [Issue] → [Fix in 1 sentence]
+- 🟢 **[Opportunity]**: [Untapped potential] → [Action in 1 sentence]
+
+### Top 3 Actions
+1. **[Action]** — [Expected impact]
+2. **[Action]** — [Expected impact]
+3. **[Action]** — [Expected impact]

package/skills/express/autoresearch.md

@@ -0,0 +1,32 @@
+---
+name: autoresearch-express
+description: Generate testable marketing hypotheses.
+---
+# Autoresearch Loop
+
+Generate NEW testable marketing hypotheses. Prior data is fuel — not the deliverable.
+
+## Process
+1. **Read** prior data (if CSV provided). Extract top 3 patterns in 2 sentences each.
+2. **Generate** 8 new hypothesis variants based on gaps and opportunities.
+3. **Score** each 1-10 on novelty, testability, and expected impact.
+4. **Keep** hypotheses scoring ≥7. Discard the rest with 1-sentence reason.
+5. **Log**: "Generated X. Kept Y. Discarded Z."
+
+Run 2 cycles of Generate → Score → Keep.
+
+## Output Format
+
+### 🔬 Autoresearch Results
+
+**Patterns Found** (from prior data):
+1. [Pattern] — [Implication]
+2. [Pattern] — [Implication]
+
+**New Hypotheses** (prioritized):
+| # | Hypothesis | Asset/Copy | Rationale | Score |
+|---|-----------|------------|-----------|-------|
+| 1 | [hypothesis] | [specific copy/creative] | [why it should work] | [X/10] |
+| 2 | ... | ... | ... | ... |
+
+**Next Step**: [Recommended first test to run]

package/skills/express/copywriting.md

@@ -0,0 +1,31 @@
+---
+name: copywriting-express
+description: Generate high-performing ad copy fast.
+---
+# Ad Copywriting
+
+Write ad copy using the user's product context and target audience.
+
+## Rules
+- Use PAS framework: Pain → Agitate → Solution
+- Respect platform limits: Google headlines ≤30 chars, descriptions ≤90 chars
+- Write in the user's brand tone
+- Include a clear CTA in every variant
+
+## Output Format
+
+### 🎯 Ad Copy Variants
+
+**Headline Options** (pick 5):
+1. "[headline]" — [rationale in 5 words]
+2. "[headline]" — [rationale]
+3. "[headline]" — [rationale]
+4. "[headline]" — [rationale]
+5. "[headline]" — [rationale]
+
+**Primary Text** (pick 3):
+1. [2-3 sentence copy with CTA]
+2. [2-3 sentence copy with CTA]
+3. [2-3 sentence copy with CTA]
+
+**Recommended A/B Test**: Test headline [X] with primary text [Y] vs headline [Z] with primary text [W].

package/skills/express/cro.md

@@ -0,0 +1,26 @@
+---
+name: cro-express
+description: Conversion rate optimization audit.
+---
+# CRO Audit
+
+Audit the user's landing page or funnel for conversion blockers.
+
+## Output Format
+
+### 🎯 CRO Audit: [Page/Funnel Name]
+
+**Current CVR**: [X%] → **Target**: [Y%]
+
+### Friction Points
+| Element | Issue | Impact | Fix |
+|---------|-------|--------|-----|
+| Headline | [issue] | [High/Med/Low] | [specific fix] |
+| CTA | [issue] | [High/Med/Low] | [specific fix] |
+| Form | [issue] | [High/Med/Low] | [specific fix] |
+| Trust | [issue] | [High/Med/Low] | [specific fix] |
+
+### Quick Wins (implement this week)
+1. **[Change]** — Expected lift: [X%]
+2. **[Change]** — Expected lift: [X%]
+3. **[Change]** — Expected lift: [X%]

package/skills/express/product.md

@@ -0,0 +1,11 @@
+---
+name: product-express
+description: Your business context.
+---
+# My Business
+
+Read the user's business context file first. Use their product name, ICP, and tone in every response.
+
+If no context file exists, ask: "What do you sell or promote?" before proceeding.
+
+Always reference the user's product by name. Never use generic examples.

package/skills/express/research.md

@@ -0,0 +1,26 @@
+---
+name: research-express
+description: Competitor and customer research.
+---
+# Market Research
+
+Help the user understand their competitors and customers.
+
+## For Competitor Analysis
+
+### Competitor Map
+| Competitor | Core Claim | Their Weakness | Your Angle |
+|------------|------------|----------------|------------|
+| [name] | [claim] | [weakness] | [how to beat them] |
+
+**White Space**: [Position nobody owns yet]
+**Recommended Angle**: [1-sentence positioning the user should test]
+
+## For Customer Research
+
+### ICP Quick Profile
+- **Who**: [Job title, company size]
+- **Pain**: [#1 problem in their words]
+- **Trigger**: [What makes them start looking]
+- **Objection**: [Top reason they wouldn't buy] → **Counter**: [Proof that resolves it]
+- **Language**: Use "[exact phrase]", avoid "[jargon]"