marketingskills-ai-agents

What this skill does

# Marketing Skills for AI Agents

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.

[coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) is a collection of markdown-based AI agent skills covering CRO, copywriting, SEO, analytics, paid ads, email, and growth engineering. Install them once and any compatible agent (Claude Code, Cursor, Codex, Windsurf) gains specialized marketing expertise and frameworks.

---

## How Skills Work

Each skill is a markdown file that tells AI agents:
- **When to activate** (trigger phrases)
- **What frameworks to apply** (e.g. AIDA, PAS, Jobs-to-be-Done)
- **What to produce** (copy, code, audits, strategies)
- **Which other skills to reference** (cross-skill dependencies)

All skills read `product-marketing-context` first — it's the shared foundation containing your product, audience, and positioning.

---

## Installation

### Option 1: CLI (Recommended)

```bash
# Install all 33 skills at once
npx skills add coreyhaines31/marketingskills

# Install only specific skills
npx skills add coreyhaines31/marketingskills --skill page-cro copywriting seo-audit

# See all available skills before installing
npx skills add coreyhaines31/marketingskills --list
```

Skills land in `.agents/skills/` with a symlink to `.claude/skills/` for Claude Code.

### Option 2: Claude Code Plugin

```
/plugin marketplace add coreyhaines31/marketingskills
/plugin install marketing-skills
```

### Option 3: Git Clone

```bash
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/
```

### Option 4: Git Submodule (for team projects)

```bash
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills
# Reference skills from .agents/marketingskills/skills/
```

---

## Project Structure

```
marketingskills/
├── skills/
│   ├── product-marketing-context/   ← Start here — foundation for all others
│   ├── page-cro/
│   ├── copywriting/
│   ├── seo-audit/
│   ├── ab-test-setup/
│   ├── email-sequence/
│   ├── paid-ads/
│   └── ... (33 skills total)
└── README.md
```

Each skill directory contains a `SKILL.md` (or `README.md`) with structured instructions the agent reads.

---

## First Step: Set Up Product Marketing Context

Before using any other skill, create your context file. This is the single most important step.

```
"Create my product marketing context"
```

The agent will generate `.agents/skills/product-marketing-context/context.md` by asking about:
- Product name, description, and category
- Target audience and ICPs
- Core value proposition and positioning
- Key competitors
- Pricing and business model
- Tone and brand voice

Every other skill reads this file automatically before executing.

---

## Available Skills Reference

### Foundation
| Skill | Use When |
|-------|----------|
| `product-marketing-context` | Creating or updating your shared product/positioning doc |

### SEO & Content
| Skill | Use When |
|-------|----------|
| `seo-audit` | Auditing or diagnosing SEO issues |
| `ai-seo` | Optimizing for LLM/AI search citations |
| `site-architecture` | Planning URL structure, navigation, internal links |
| `programmatic-seo` | Building SEO pages at scale from templates + data |
| `schema-markup` | Adding structured data / JSON-LD |
| `content-strategy` | Planning what content to create and why |

### CRO (Conversion Rate Optimization)
| Skill | Use When |
|-------|----------|
| `page-cro` | Optimizing any marketing or landing page |
| `signup-flow-cro` | Improving signup/trial activation flows |
| `onboarding-cro` | Improving post-signup activation and time-to-value |
| `form-cro` | Optimizing lead capture, contact, or non-signup forms |
| `popup-cro` | Creating or improving popups, modals, slide-ins |
| `paywall-upgrade-cro` | In-app paywalls, upgrade screens, feature gates |

### Copy & Content
| Skill | Use When |
|-------|----------|
| `copywriting` | Writing homepage, landing page, or any marketing copy |
| `copy-editing` | Editing or improving existing copy |
| `cold-email` | Writing B2B cold outreach sequences |
| `email-sequence` | Building drip, lifecycle, or onboarding emails |
| `social-content` | LinkedIn, Twitter/X, Instagram content |

### Paid & Measurement
| Skill | Use When |
|-------|----------|
| `paid-ads` | Google Ads, Meta, LinkedIn, Twitter campaigns |
| `ad-creative` | Generating ad headlines, descriptions, primary text |
| `ab-test-setup` | Planning and implementing A/B experiments |
| `analytics-tracking` | Setting up or auditing GA4, Segment, Mixpanel |

### Growth & Retention
| Skill | Use When |
|-------|----------|
| `referral-program` | Building referral or affiliate programs |
| `free-tool-strategy` | Planning free tools for lead gen or SEO |
| `churn-prevention` | Cancellation flows, save offers, dunning |
| `lead-magnets` | Creating email capture lead magnets |

### Sales & GTM
| Skill | Use When |
|-------|----------|
| `revops` | Lead lifecycle, CRM, marketing-to-sales handoff |
| `sales-enablement` | Pitch decks, one-pagers, objection handling |
| `launch-strategy` | Product launches, feature announcements |
| `pricing-strategy` | Pricing, packaging, monetization decisions |
| `competitor-alternatives` | Comparison and alternative pages |

### Strategy
| Skill | Use When |
|-------|----------|
| `marketing-ideas` | Brainstorming marketing strategies and tactics |
| `marketing-psychology` | Applying behavioral science to marketing |

---

## Usage Examples

### Example 1: Audit and improve a landing page

```
"Audit my landing page at src/pages/index.tsx and suggest CRO improvements"
```

The agent reads `product-marketing-context`, activates `page-cro`, then:
1. Reviews the page structure, headline, CTA placement
2. Applies frameworks (AIDA, above-the-fold analysis, social proof audit)
3. Outputs a prioritized list of changes with implementation code

### Example 2: Write a homepage from scratch

```
"Write homepage copy for my SaaS product using the copywriting skill"
```

Output includes hero headline variants, subheadline, feature sections, social proof blocks, and CTAs — all grounded in your `product-marketing-context`.

### Example 3: Set up A/B testing

```
"Help me set up an A/B test for my pricing page CTA button"
```

The agent activates `ab-test-setup` and generates:

```javascript
// Example output: Google Optimize / custom A/B test scaffold
const experiments = {
  pricing_cta_test: {
    id: 'pricing-cta-v1',
    variants: [
      { id: 'control', cta: 'Start Free Trial' },
      { id: 'variant_a', cta: 'Get Started Free' },
      { id: 'variant_b', cta: 'Try It Free — No Card Required' }
    ],
    metric: 'signup_click',
    minimumDetectableEffect: 0.05,
    confidenceLevel: 0.95
  }
};

// Split traffic deterministically by user ID
function getVariant(userId, experimentId) {
  const hash = simpleHash(`${userId}-${experimentId}`);
  const variantIndex = hash % experiments[experimentId].variants.length;
  return experiments[experimentId].variants[variantIndex];
}
```

### Example 4: Generate programmatic SEO pages

```
"Create a programmatic SEO page template for '[tool] alternatives' pages"
```

The agent activates `programmatic-seo` + `competitor-alternatives` and scaffolds:

```javascript
// Next.js dynamic route: /pages/[competitor]-alternatives.js
export async function getStaticPaths() {
  const competitors = await fetchCompetitors(); // your data source
  return {
    paths: competitors.map(c => ({ params: { competitor: c.slug } })),
    fallback: 'blocking'
  };
}

export async function getStaticProps({ params }) {
  const data = await getCompetitorData(params.competitor);
  return { props: { competitor: data }, revalidate: 86400 };
}
```

### Example 5: Build an email sequence

```
"Write a 5-email onboarding sequence for new trial users"
```

Activates `email-sequence` + `onboarding-cro`. Produces:
- Email 1: Welcome + single activation