Metaads

## Workflow Routing (SYSTEM PROMPT)

**CRITICAL: Route to the correct workflow based on user intent.**

**When user needs to set up or configure Meta Ads API access:**
Examples: "set up meta ads", "connect meta ads", "configure facebook ads", "my token expired", "meta ads setup", credential errors from --check
-> **READ:** ~/.claude/skills/MetaAds/workflows/Setup.md
-> **EXECUTE:** Walk user through complete setup (Business Manager, App, token, .env)

**When user wants to publish, create, or launch a campaign:**
Examples: "publish ads", "create campaign", "launch campaign", "upload ad images", "publish meta ads", "push this campaign to Meta", "create ad set"
-> **READ:** ~/.claude/skills/MetaAds/workflows/PublishCampaign.md
-> **EXECUTE:** Campaign publishing workflow
-> If credentials fail, route to Setup.md first

**When user wants to check performance, metrics, or analyze results:**
Examples: "check meta ad performance", "ROAS", "which ad is winning", "ad spend", "campaign metrics", "how are my ads doing", "audience breakdown", "creative performance"
-> **READ:** ~/.claude/skills/MetaAds/workflows/AnalyzePerformance.md
-> **EXECUTE:** Performance analysis workflow
-> If credentials fail, route to Setup.md first

**When user wants to manage campaigns (pause/resume/status):**
Examples: "pause campaign", "resume campaign", "campaign status", "list campaigns"
-> Use `uv run ~/.claude/skills/MetaAds/tools/Publish.py` directly with --pause, --resume, --status, or --list

---

## When to Activate This Skill

### Setup & Configuration (Category 0)
- "set up meta ads", "connect meta ads API", "configure facebook ads"
- "meta ads setup", "how do I connect my ad account"
- "my token expired", "token error", "can't access meta ads"
- "refresh my meta token", "renew access token"
- Any credential error from --check

### Campaign Publishing (Category 1)
- "publish ads", "create campaign", "launch campaign"
- "push this to Meta", "set up the campaign", "upload ad images"
- "publish meta ads", "create ad set", "build the campaign"
- "publish this campaign config", "go live with the ads"

### Performance Analysis (Category 2)
- "check meta ad performance", "how are my ads doing"
- "ROAS", "return on ad spend", "ad spend", "ad metrics"
- "which ad is winning", "best performing ad"
- "campaign metrics", "ad set performance", "creative performance"
- "audience breakdown", "age/gender breakdown"
- "CTR", "CPC", "CPM", "CPA", "cost per acquisition"

### Campaign Management (Category 3)
- "pause campaign", "resume campaign", "activate campaign"
- "campaign status", "list campaigns", "show my campaigns"

---

## Core Capabilities

**Guided Setup:**
- Complete walkthrough: Business Manager -> Developer App -> Token -> .env
- Two token paths: System User (never expires) or User Token (60-day, with automated refresh)
- Token exchange automation (agent runs the curl command)
- Pixel setup guidance for conversion tracking
- Error diagnosis with specific fixes for every common failure

**Campaign Publishing:**
- Upload images from local directories to Meta
- Create full campaign hierarchy (campaign -> ad set -> creative -> ad)
- Advantage+ flexible creative with multiple images/texts/headlines
- All objects created PAUSED for manual review
- JSON config-driven for reproducible campaigns

**Performance Analytics:**
- Account-l