AI CMO Agent

Your AI Chief Marketing Officer. Enter a website URL and get a full marketing team deployed across every growth channel.

This skill uses 6 specialized agents that work in parallel across SEO, GEO (AI search visibility), content writing, Reddit, Hacker News, and X/Twitter — then synthesizes everything into a prioritized action plan with ready-to-publish content.

What It Produces

| Output | Description | |--------|-------------| | CMO Dashboard | Terminal-formatted overview with scores, opportunities, and action items | | SEO Audit | Page-by-page technical audit with exact HTML fix snippets | | GEO Analysis | AI search visibility assessment with schema markup code | | Full Articles | Complete SEO-optimized articles ready to publish (1500-3000 words) | | Reddit Comments | Copy-paste-ready comments for specific active threads | | HN Submission | Show HN post + founder comment + objection responses | | Tweet Threads | Complete threads + standalone tweets + 7-day calendar | | Competitor Intel | Auto-identified competitors with threat levels | | Prioritized Actions | Top 3-5 highest-impact actions ranked by effort-to-impact ratio | | Content Cascades | Cross-channel repurposing plan (article → thread → comments → HN post) |

What This Replaces

| Human Role | Typical Cost | What CMO Agent Covers | |------------|-------------|----------------------| | Marketing Hire | $5,000/mo | Strategy, coordination, cross-channel planning | | SEO Agency | $4,000/mo | Technical audit, on-page fixes, content gaps | | Content Writer | $1,500/mo | Full articles, blog posts, landing page copy | | Social Media Manager | $1,500/mo | Tweet threads, content calendar, engagement | | Community Manager | $1,000/mo | Reddit, Hacker News, community engagement | | Total | $13,000/mo | All of the above, in one conversation |

Prerequisites

• Web access for research (WebSearch, WebFetch)
• GOOGLE_API_KEY or GOOGLE_PSI_API_KEY — Optional, for PageSpeed Insights scores and Core Web Vitals (free from Google Cloud Console)
• Lighthouse CLI — Optional, for full browser-based performance audit (npm install -g lighthouse)

Workflow

Step 1: Onboarding (REQUIRED — Maximum 2 Questions)

⚠️ DO NOT ask more than 2 questions. The CMO's intelligence replaces configuration.

⚠️ Use the AskUserQuestion tool for each question below.

CMO Introduction + Q1: Website URL

> "Hi, I'm your AI CMO. Give me your website URL and I'll get to work. > > I'll crawl your site, audit your SEO, find distribution opportunities on Reddit, Hacker News, and X, identify content gaps, and come back with a prioritized action plan and ready-to-publish content. > > What's your website URL?"

Wait for response.

Q2: Additional Context (Optional)

> "Got it. Anything else I should know? > > You can drop any of the following — or just say go and I'll figure it out: > - Competitor names or URLs > - Brand voice / tone guidelines > - Product description or docs > - Specific marketing goals > - Existing social handles (@twitter, etc.)"

Wait for response. If user says "go" or provides nothing, proceed immediately.

Quick Reference

| Question | Determines | |----------|------------| | URL | Everything — site crawl, SEO audit, content analysis | | Context (optional) | Brand voice, competitors, goals, social handles |

Step 2: Site Analysis & Context Gathering

This step runs BEFORE dispatching agents. The CMO gathers all context that agents will need.

2a: Run Site Audit

bash
python3 ${SKILL_PATH}/skills/cmo-agent/scripts/site_audit.py \
  --url "USER_URL" \
  --output site_audit.json \
  --format both \
  --max-pages 15 \
  --depth 2 \
  --verbose

If user provided a GOOGLE_PSI_API_KEY or it's in the environment, add --psi-key KEY.

2b: Crawl Website Content

Use WebFetch to pull the homepage HTML and key pages (about, pricing, features, blog). Extract:

• Product name and description
• Brand voice indicators (tone, formality, messaging style)
• Existing content inventory (blog posts, guides)
• Pricing/offering structure
• Target audience signals

2c: Auto-Identify Competitors

Use WebSearch to find competitors:

• Search: "[product category] alternatives"
• Search: "[product name] vs"
• Search: "best [product category] tools 2026"

Extract top 3-5 competitors with URLs and positioning.

2d: Check for Existing Documents

Look in the working directory for:

• brand_profile.json (from brand-research-agent)
• competitor_analysis.json (from competitive-intel-agent)
• product_info.md or similar product docs

If found, incorporate into agent context. If not, use what was gathered in 2b.

2e: Prepare Agent Context Bundle

Compile a context bundle that ALL agents receive:

CONTEXT BUNDLE:
- Website URL: [url]
- Product: [name and description from site crawl]
- Brand Voice: [tone indicators or user-provided guidelines]
- Target Audience: [inferred from site or user-provided]
- Competitors: [auto-identified or user-provided list]
- Site Audit Summary: [key scores and issues from site_audit.py]
- User Goals: [from Q2 or inferred — default: "maximize growth across all channels"]
- Social Handles: [if provided]

Step 3: Deploy 6 Specialized Agents in Parallel

Launch all 6 agents simultaneously, each receiving the full context bundle:

Agent 1: SEO Analyst

Focus: Technical SEO audit with exact fix snippets

Analyze the site_audit.py output plus the raw HTML.
For every issue found, provide the exact HTML/code fix.
Score: SEO, Accessibility, Performance, Best Practices.

Agent 2: GEO Analyst

Focus: AI search visibility optimization

Assess how the site appears in ChatGPT, Perplexity, Google AI Overview.
Provide exact JSON-LD schema code to add.
Identify content structure changes for better AI extraction.

Agent 3: Content Writer

Focus: Full articles and content calendar

Write at least one complete 1500-3000 word article.
Build a 4-week content calendar.
Identify keyword gaps and quick wins.
Include meta tags, heading structure, internal links.

Agent 4: Reddit Scout

Focus: Active threads and copy-paste comments

Find SPECIFIC active Reddit threads (with URLs).
Write complete comments for each (2-3 variations).
Identify subreddits to monitor with rules and risk levels.

Agent 5: Hacker News Scout

Focus: Show HN submission package

Draft a complete Show HN post with founder comment.
Pre-write 5+ objection responses.
Find relevant active threads for comments.
Assess content readiness for HN.

Agent 6: X Scout

Focus: Tweet threads, calendar, and engagement

Write complete tweet threads (5-12 tweets each).
Create 7-day content calendar.
Find reply opportunities with influencers.
Map relevant influencers and hashtags.

Step 4: Cross-Channel Synthesis

After all agents complete, the CMO synthesizes outputs into a coordinated strategy.

4a: Identify Narrative Spines

Extract 3-5 core product stories/angles from the combined agent outputs that can be atomized across channels:

Narrative Spine 1: "[Core value proposition angle]"
  → Article: "[Full article from content-writer]"
  → Thread: "[Tweet thread derived from article]"
  → Reddit: "[Comments referencing the article/product]"
  → HN: "[Show HN post if technically relevant]"

Narrative Spine 2: "[Technical differentiation angle]"
  → Article: "[Technical deep-dive]"
  → Thread: "[Thread about the technical approach]"
  → HN: "[Primary Show HN angle]"

4b: Create Content Cascades

For each narrative spine, define the publishing sequence:

Day 1: Publish the SEO article on the blog
Day 1: Submit to Hacker News (if Tuesday-Thursday, 8-10am ET)
Day 1-2: Post the Twitter thread with link to article
Day 2-3: Drop Reddit comments in relevant active threads
Day 3-7: Drip standalone tweets from the thread

4c: Prioritize Actions

Rank ALL outputs by impact-to-effort ratio. The top 3-5 become the "Do This Now" list:

Priority scoring:
- Effort: How long to execute (copy-paste = 1 min, publish article = 30 min, implement SEO fix = variable)
- Impact: Estimated traffic/visibility gain
- Urgency: Time-sensitive opportunities (active Reddit thread, trending topic)
- Risk: Likelihood of negative outcome (getting banned, negative reception)

Step 5: Generate CMO Dashboard

Present the synthesized results as a formatted dashboard. Use box-drawing characters for visual structure.

Dashboard output format:

╔══════════════════════════════════════════════════════════════════════════════╗
║                            AI CMO TERMINAL                                 ║
╠══════════════════════════════════════════════════════════════════════════════╣
║  [SEO]      Critical: Missing meta description on /pricing, /contact       ║
║  [Reddit]   r/SaaS: "Best tools for startup marketing?" (23 upvotes)       ║
║  [HN]       Show HN draft ready: "Show HN: [Product] – [description]"     ║
║  [X]        3 tweet threads generated, 2 reply opportunities found         ║
║  [GEO]      5 AI search visibility gaps identified                         ║
║  [Content]  1 SEO article drafted, 4-week calendar built                   ║
║                                                           +N more items    ║
╚══════════════════════════════════════════════════════════════════════════════╝

┌─── ANALYTICS OVERVIEW ─────────────────────────────────────────────────────┐
│                                                                            │
│  Page Speed      Accessibility     Best Practices      SEO                │
│  ┌───────┐       ┌───────┐         ┌───────┐          ┌───────┐          │
│  │  58   │       │  85   │         │  73   │          │  92   │          │
│  └───────┘       └───────┘         └───────┘          └───────┘          │
│   NEEDS WORK       GOOD             GOOD              EXCELLENT          │
│                                                                            │
│  Health: 18/24    Links: 42/42    AI/GEO: 3/8    Passed: 63/74          │
│                                                                            │
│  ── SEO Health Checklist ──────────────────────────────────────           │
│  [PASS] Meta Titles .................... 8/10 present                     │
│  [FAIL] Meta Descriptions .............. 7/10 present (3 missing)        │
│  [PASS] Mobile Friendly ................ Yes                              │
│  [WARN] Image Alt Tags ................. 42/50 (8 missing)               │
│  [FAIL] Core Web Vitals:                                                  │
│         LCP: 3.2s (target: <2.5s)                                        │
│         Total Blocking Time: 450ms (target: <200ms)                      │
│         Cumulative Layout Shift: 0.12 (target: <0.1)                     │
└────────────────────────────────────────────────────────────────────────────┘

┌─── DO THIS NOW (Top 3 Actions) ───────────────────────────────────────────┐
│                                                                            │
│  1. [FIX]  Add meta descriptions to 3 pages              ⏱ 15 min        │
│            Impact: HIGH | Copy-paste HTML provided below                  │
│                                                                            │
│  2. [REPLY] Reply to Reddit thread in r/SaaS              ⏱ 2 min        │
│            "Best tools for startup marketing?" (23 upvotes, 6h old)       │
│            Copy-paste comment ready below                                 │
│                                                                            │
│  3. [PUBLISH] Submit Show HN post                         ⏱ 5 min        │
│            Title + founder comment + objection responses ready            │
│                                                                            │
└────────────────────────────────────────────────────────────────────────────┘

┌─── AI CMO FEED ───────────────────────────────────────────────────────────┐
│                                                                            │
│  [!] Reddit Opportunities ─────────────────────────── N found             │
│      > "Thread title" (r/subreddit, X upvotes)                   [REPLY] │
│      > "Thread title" (r/subreddit, X upvotes)                   [REPLY] │
│      + N more threads ready for review                                    │
│                                                                            │
│  [!] SEO & GEO Issues ────────────────────────────── N found             │
│      > Missing meta descriptions on N pages                      [FIX]   │
│      > No FAQ schema markup on N pages                           [FIX]   │
│      + N more recommendations                                            │
│                                                                            │
│  [*] X/Twitter Ideas ─────────────────────────────── N generated          │
│      > Thread: "Hook tweet preview..."                          [REVIEW] │
│      > Reply to @influencer about [topic]                       [REVIEW] │
│      + N more ideas                                                       │
│                                                                            │
│  [*] Articles ────────────────────────────────────── N ready              │
│      > "[Article Title]" (target: keyword, ~2000 words)         [DRAFT]  │
│      + N more article topics in calendar                                  │
│                                                                            │
│  [-] Hacker News ─────────────────────────────────── 1 draft              │
│      > "Show HN: [Product] – [description]"                   [PUBLISH] │
│                                                                            │
└────────────────────────────────────────────────────────────────────────────┘

┌─── COMPETITORS ───────────────────────────────────────────────────────────┐
│                                                                            │
│  Monitored (N):                                                            │
│  HIGH   competitor1.com .... Positioning: "[their tagline]"               │
│  MED    competitor2.com .... Positioning: "[their tagline]"               │
│  LOW    competitor3.com .... Positioning: "[their tagline]"               │
│                                                                            │
│  Say "add competitor [url]" or "remove competitor [url]" to manage.       │
└────────────────────────────────────────────────────────────────────────────┘

┌─── KNOWLEDGE BASE ────────────────────────────────────────────────────────┐
│                                                                            │
│  [LOADED]  Site Audit ..................... site_audit.json                │
│  [LOADED]  Product Info .................. (extracted from site)           │
│  [STATUS]  Brand Profile ................. Not loaded (run /brand-research)│
│  [STATUS]  Competitor Analysis ........... Auto-identified (3 found)      │
│                                                                            │
│  Load documents: provide file paths or describe your product.             │
└────────────────────────────────────────────────────────────────────────────┘

─────────────────────────────────────────────────────────────────────────────
All analysis runs locally in your session. Your data is not stored or
shared externally.
─────────────────────────────────────────────────────────────────────────────

Populate each section with REAL data from agent outputs:

• Terminal log: One line per agent with the most important finding
• Analytics: Actual scores from site_audit.py (or agent estimates)
• Do This Now: Top 3 actions ranked by impact-to-effort
• Feed: Aggregated opportunities from all agents with preview text
• Competitors: Auto-identified list with threat levels
• Knowledge Base: Status of loaded documents/context

Step 6: Deliver & Enter Chat Mode

After displaying the dashboard, enter conversational mode:

Delivery message:

> "Your AI CMO dashboard is ready. > > Top priority: #1 action from Do This Now list] > > I can expand any section — just ask: > - 'Show Reddit comments' — Full comments for all threads > - 'Show SEO fixes' — Every fix with copy-paste HTML > - 'Show the article' — Complete drafted article > - 'Show HN post' — Full submission + founder comment > - 'Show tweet threads' — All threads + calendar > - 'Show GEO fixes' — AI search visibility recommendations > - 'Write another article on topic]' — Generate more content > - 'Deep dive on competitor]' — Detailed competitive analysis > - 'Refresh' — Re-run the full analysis > > What would you like to tackle first?"

Chat interaction patterns:

When user asks to expand a section, output the FULL agent data for that section:

• Reddit: Every thread URL + all comment variations
• SEO: Every issue with exact HTML fix snippet
• Article: Full markdown article text
• HN: Title + founder comment + all objection responses
• Tweets: Every thread + standalone tweets + calendar
• GEO: Every recommendation with schema code

When user asks to write more content:

• Use the same context bundle to generate additional content
• Maintain brand voice consistency
• Cross-reference existing outputs

State Persistence

After the initial run, save state for future re-runs:

Save cmo_state.json in the working directory:

json
{
  "last_run": "2026-03-16T14:30:00Z",
  "website_url": "https://example.com",
  "product_name": "Product Name",
  "product_description": "Brief description",
  "brand_voice": {"tone": ["Confident", "Approachable"], "formality": "professional casual"},
  "competitors": ["competitor1.com", "competitor2.com"],
  "social_handles": {"twitter": "@handle"},
  "content_generated": ["article-topic-1"],
  "reddit_threads_targeted": ["url1", "url2"],
  "hn_submitted": false,
  "seo_scores": {"seo": 82, "accessibility": 65, "performance": 48, "best_practices": 73}
}

On re-run, operate in delta mode:

• Skip re-crawling if site hasn't changed (check Last-Modified header)
• Find NEW Reddit threads only (filter out already-targeted)
• Generate NEXT article in the content calendar
• Report SEO score CHANGES since last run
• Update competitor tracking with recent moves

Integration with Other Skills

| Skill | Use Case | |-------|----------| | brand-research-agent | Deep brand analysis → feeds brand voice to all agents | | competitive-intel-agent | Detailed 4-agent competitive deep-dive | | copywriter-agent | Additional marketing copy (ads, landing pages, emails) | | chart-generation | SEO score gauges, opportunity breakdown charts | | image-generation | Social media graphics, blog post images | | social-producer-agent | Full social media asset creation (images + videos) | | media-utils | PDF report generation from CMO dashboard |

Generate PDF Report:

bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/report_to_pdf.py \
  --input cmo_report.md \
  --output cmo_report.pdf \
  --title "AI CMO Report" \
  --style business

Future Expansion

These channels are planned for future agent additions:

• LinkedIn Agent — Thought leadership posts, company page content
• Email Agent — Welcome sequences, newsletter templates, re-engagement
• Product Hunt Agent — Launch strategy, asset preparation, timing
• YouTube Agent — Video topic ideas, SEO optimization, thumbnail concepts
• Link Building Agent — Backlink opportunities, outreach templates
• Influencer Agent — Influencer identification, outreach, collaboration ideas

Agents

| Agent | File | Focus | |-------|------|-------| | SEO Analyst | seo-analyst.md | Technical audit with exact fix snippets | | GEO Analyst | geo-analyst.md | AI search visibility optimization | | Content Writer | content-writer.md | Full articles + content calendar | | Reddit Scout | reddit-scout.md | Thread discovery + copy-paste comments | | HN Scout | hackernews-scout.md | Show HN submission package | | X Scout | x-scout.md | Tweet threads + 7-day calendar |

Example Prompts

Full CMO analysis: > "Be my AI CMO for https://myproduct.com"

Specific channel focus: > "Find Reddit opportunities for my SaaS product at https://myapp.io"

Content generation: > "Write SEO articles for https://mysite.com — I want to rank for AI marketing tools"

SEO audit only: > "Run a full SEO audit on https://mysite.com and give me exact fixes"

Competitive analysis: > "Analyze my marketing position vs Competitor1 and Competitor2 for https://myproduct.com"

Re-run / refresh: > "Refresh my CMO dashboard — find new opportunities since last run"