Skip to content

Commit cac82f3

Browse files
Merge pull request #69 from coreyhaines31/development
Release: v1.1.0 -- agent-agnostic migration, 7 new skills, 51 CLI tools
2 parents 0c24410 + 3a13e58 commit cac82f3

47 files changed

Lines changed: 4129 additions & 101 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude-plugin/marketplace.json

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
"url": "https://corey.co"
66
},
77
"metadata": {
8-
"description": "Marketing skills for Claude Code — conversion optimization, copywriting, SEO, paid ads, and growth",
8+
"description": "Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, and growth",
99
"version": "1.0.0",
1010
"repository": "https://github.com/coreyhaines31/marketingskills"
1111
},
1212
"plugins": [
1313
{
1414
"name": "marketing-skills",
15-
"description": "29 marketing skills for technical marketers and founders: CRO, copywriting, cold email, SEO, AI SEO, paid ads, ad creative, churn prevention, pricing strategy, referral programs, and more",
15+
"description": "32 marketing skills for technical marketers and founders: CRO, copywriting, cold email, SEO, AI SEO, paid ads, ad creative, churn prevention, pricing strategy, referral programs, revenue operations, sales enablement, site architecture, and more",
1616
"source": "./",
1717
"strict": false,
1818
"skills": [
@@ -41,9 +41,12 @@
4141
"./skills/product-marketing-context",
4242
"./skills/programmatic-seo",
4343
"./skills/referral-program",
44+
"./skills/revops",
45+
"./skills/sales-enablement",
4446
"./skills/schema-markup",
4547
"./skills/seo-audit",
4648
"./skills/signup-flow-cro",
49+
"./skills/site-architecture",
4750
"./skills/social-content"
4851
]
4952
}

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Guidelines for AI agents working in this repository.
44

55
## Repository Overview
66

7-
This repository contains **Agent Skills** for AI agents following the [Agent Skills specification](https://agentskills.io/specification.md). It also serves as a **Claude Code plugin marketplace** via `.claude-plugin/marketplace.json`.
7+
This repository contains **Agent Skills** for AI agents following the [Agent Skills specification](https://agentskills.io/specification.md). Skills install to `.agents/skills/` (the cross-agent standard). This repo also serves as a **Claude Code plugin marketplace** via `.claude-plugin/marketplace.json`.
88

99
- **Name**: Marketing Skills
1010
- **GitHub**: [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)

README.md

Lines changed: 27 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Marketing Skills for Claude Code
1+
# Marketing Skills for AI Agents
22

3-
A collection of AI agent skills focused on marketing tasks. Built for technical marketers and founders who want Claude Code (or similar AI coding assistants) to help with conversion optimization, copywriting, SEO, analytics, and growth engineering.
3+
A collection of AI agent skills focused on marketing tasks. Built for technical marketers and founders who want AI coding agents to help with conversion optimization, copywriting, SEO, analytics, and growth engineering. Works with Claude Code, OpenAI Codex, Cursor, Windsurf, and any agent that supports the [Agent Skills spec](https://agentskills.io).
44

55
Built by [Corey Haines](https://corey.co?ref=marketingskills). Need hands-on help? Check out [Conversion Factory](https://conversionfactory.co?ref=marketingskills) — Corey's agency for conversion optimization, landing pages, and growth strategy. Want to learn more about marketing? Subscribe to [Swipe Files](https://swipefiles.com?ref=marketingskills). Want an autonomous AI agent that uses these skills to be your CMO? Try [Magister](https://magistermarketing.com?ref=marketingskills).
66

@@ -12,7 +12,7 @@ Run into a problem or have a question? [Open an issue](https://github.com/coreyh
1212

1313
## What are Skills?
1414

15-
Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When you add these to your project, Claude Code can recognize when you're working on a marketing task and apply the right frameworks and best practices.
15+
Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When you add these to your project, your agent can recognize when you're working on a marketing task and apply the right frameworks and best practices.
1616

1717
## How Skills Work Together
1818

@@ -78,9 +78,12 @@ See each skill's **Related Skills** section for the full dependency map.
7878
| [product-marketing-context](skills/product-marketing-context/) | When the user wants to create or update their product marketing context document. Also use when the user mentions... |
7979
| [programmatic-seo](skills/programmatic-seo/) | When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions... |
8080
| [referral-program](skills/referral-program/) | When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.... |
81+
| [revops](skills/revops/) | When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff... |
82+
| [sales-enablement](skills/sales-enablement/) | When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts... |
8183
| [schema-markup](skills/schema-markup/) | When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user... |
8284
| [seo-audit](skills/seo-audit/) | When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO... |
8385
| [signup-flow-cro](skills/signup-flow-cro/) | When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the... |
86+
| [site-architecture](skills/site-architecture/) | When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal... |
8487
| [social-content](skills/social-content/) | When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram,... |
8588
<!-- SKILLS:END -->
8689

@@ -101,7 +104,7 @@ npx skills add coreyhaines31/marketingskills --skill page-cro copywriting
101104
npx skills add coreyhaines31/marketingskills --list
102105
```
103106

104-
This automatically installs to your `.claude/skills/` directory.
107+
This automatically installs to your `.agents/skills/` directory (and symlinks into `.claude/skills/` for Claude Code compatibility).
105108

106109
### Option 2: Claude Code Plugin
107110

@@ -121,18 +124,18 @@ Clone the entire repo and copy the skills folder:
121124

122125
```bash
123126
git clone https://github.com/coreyhaines31/marketingskills.git
124-
cp -r marketingskills/skills/* .claude/skills/
127+
cp -r marketingskills/skills/* .agents/skills/
125128
```
126129

127130
### Option 4: Git Submodule
128131

129132
Add as a submodule for easy updates:
130133

131134
```bash
132-
git submodule add https://github.com/coreyhaines31/marketingskills.git .claude/marketingskills
135+
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills
133136
```
134137

135-
Then reference skills from `.claude/marketingskills/skills/`.
138+
Then reference skills from `.agents/marketingskills/skills/`.
136139

137140
### Option 5: Fork and Customize
138141

@@ -155,9 +158,20 @@ npx skillkit install coreyhaines31/marketingskills --skill page-cro copywriting
155158
npx skillkit install coreyhaines31/marketingskills --list
156159
```
157160

161+
## Upgrading from v1.0
162+
163+
Skills now use `.agents/` instead of `.claude/` for the product marketing context file. Move your existing context file:
164+
165+
```bash
166+
mkdir -p .agents
167+
mv .claude/product-marketing-context.md .agents/product-marketing-context.md
168+
```
169+
170+
Skills will still check `.claude/` as a fallback, so nothing breaks if you don't.
171+
158172
## Usage
159173

160-
Once installed, just ask Claude Code to help with marketing tasks:
174+
Once installed, just ask your agent to help with marketing tasks:
161175

162176
```
163177
"Help me optimize this landing page for conversions"
@@ -202,6 +216,7 @@ You can also invoke skills directly:
202216
- `seo-audit` - Technical and on-page SEO
203217
- `ai-seo` - AI search optimization (AEO, GEO, LLMO)
204218
- `programmatic-seo` - Scaled page generation
219+
- `site-architecture` - Page hierarchy, navigation, URL structure
205220
- `competitor-alternatives` - Comparison and alternative pages
206221
- `schema-markup` - Structured data
207222

@@ -227,6 +242,10 @@ You can also invoke skills directly:
227242
- `launch-strategy` - Product launches and announcements
228243
- `pricing-strategy` - Pricing, packaging, and monetization
229244

245+
### Sales & RevOps
246+
- `revops` - Lead lifecycle, scoring, routing, pipeline management
247+
- `sales-enablement` - Sales decks, one-pagers, objection docs, demo scripts
248+
230249
## Contributing
231250

232251
Found a way to improve a skill? Have a new skill to suggest? PRs and issues welcome!

VERSIONS.md

Lines changed: 45 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -4,38 +4,54 @@ Current versions of all skills. Agents can compare against local versions to che
44

55
| Skill | Version | Last Updated |
66
|-------|---------|--------------|
7-
| ab-test-setup | 1.0.0 | 2026-01-27 |
8-
| ad-creative | 1.0.0 | 2026-02-17 |
9-
| ai-seo | 1.0.0 | 2026-02-18 |
10-
| analytics-tracking | 1.0.0 | 2026-01-27 |
11-
| churn-prevention | 1.0.0 | 2026-02-18 |
12-
| cold-email | 1.0.0 | 2026-02-14 |
13-
| competitor-alternatives | 1.0.0 | 2026-01-27 |
14-
| content-strategy | 1.0.0 | 2026-01-27 |
15-
| copy-editing | 1.0.0 | 2026-01-27 |
16-
| copywriting | 1.0.0 | 2026-01-27 |
17-
| email-sequence | 1.0.0 | 2026-01-27 |
18-
| form-cro | 1.0.0 | 2026-01-27 |
19-
| free-tool-strategy | 1.0.0 | 2026-01-27 |
20-
| launch-strategy | 1.0.0 | 2026-01-27 |
21-
| marketing-ideas | 1.0.0 | 2026-01-27 |
22-
| marketing-psychology | 1.0.0 | 2026-01-27 |
23-
| onboarding-cro | 1.0.0 | 2026-01-27 |
24-
| page-cro | 1.0.0 | 2026-01-27 |
25-
| paid-ads | 1.0.0 | 2026-01-27 |
26-
| paywall-upgrade-cro | 1.0.0 | 2026-01-27 |
27-
| popup-cro | 1.0.0 | 2026-01-27 |
28-
| pricing-strategy | 1.0.0 | 2026-01-27 |
29-
| product-marketing-context | 1.0.0 | 2026-01-27 |
30-
| programmatic-seo | 1.0.0 | 2026-01-27 |
31-
| referral-program | 1.0.0 | 2026-01-27 |
32-
| schema-markup | 1.0.0 | 2026-01-27 |
33-
| seo-audit | 1.0.0 | 2026-01-27 |
34-
| signup-flow-cro | 1.0.0 | 2026-01-27 |
35-
| social-content | 1.0.0 | 2026-01-27 |
7+
| ab-test-setup | 1.1.0 | 2026-02-27 |
8+
| ad-creative | 1.1.0 | 2026-02-27 |
9+
| ai-seo | 1.1.0 | 2026-02-27 |
10+
| analytics-tracking | 1.1.0 | 2026-02-27 |
11+
| churn-prevention | 1.1.0 | 2026-02-27 |
12+
| cold-email | 1.1.0 | 2026-02-27 |
13+
| competitor-alternatives | 1.1.0 | 2026-02-27 |
14+
| content-strategy | 1.1.0 | 2026-02-27 |
15+
| copy-editing | 1.1.0 | 2026-02-27 |
16+
| copywriting | 1.1.0 | 2026-02-27 |
17+
| email-sequence | 1.1.0 | 2026-02-27 |
18+
| form-cro | 1.1.0 | 2026-02-27 |
19+
| free-tool-strategy | 1.1.0 | 2026-02-27 |
20+
| launch-strategy | 1.1.0 | 2026-02-27 |
21+
| marketing-ideas | 1.1.0 | 2026-02-27 |
22+
| marketing-psychology | 1.1.0 | 2026-02-27 |
23+
| onboarding-cro | 1.1.0 | 2026-02-27 |
24+
| page-cro | 1.1.0 | 2026-02-27 |
25+
| paid-ads | 1.1.0 | 2026-02-27 |
26+
| paywall-upgrade-cro | 1.1.0 | 2026-02-27 |
27+
| popup-cro | 1.1.0 | 2026-02-27 |
28+
| pricing-strategy | 1.1.0 | 2026-02-27 |
29+
| product-marketing-context | 1.1.0 | 2026-02-27 |
30+
| programmatic-seo | 1.1.0 | 2026-02-27 |
31+
| referral-program | 1.1.0 | 2026-02-27 |
32+
| revops | 1.1.0 | 2026-02-27 |
33+
| sales-enablement | 1.1.0 | 2026-02-27 |
34+
| schema-markup | 1.1.0 | 2026-02-27 |
35+
| seo-audit | 1.1.0 | 2026-02-27 |
36+
| signup-flow-cro | 1.1.0 | 2026-02-27 |
37+
| site-architecture | 1.1.0 | 2026-02-27 |
38+
| social-content | 1.1.0 | 2026-02-27 |
3639

3740
## Recent Changes
3841

42+
### 2026-02-27
43+
- Migrated context path from `.claude/` to `.agents/` for agent-agnostic compatibility
44+
- All skills now check `.agents/product-marketing-context.md` first, with `.claude/` fallback for older setups
45+
- Updated install paths in README to reference `.agents/skills/`
46+
- Bumped all 32 skills from 1.0.0 → 1.1.0
47+
48+
### 2026-02-22
49+
- Added `revops` skill for revenue operations, lead lifecycle, scoring, routing, pipeline management, and CRM automation
50+
- Added `sales-enablement` skill for sales decks, one-pagers, objection handling, demo scripts, and sales playbooks
51+
52+
### 2026-02-21
53+
- Added `site-architecture` skill for website structure planning, page hierarchy, navigation design, URL structure, and internal linking strategy
54+
3955
### 2026-02-18
4056
- Added `ai-seo` skill for AI search optimization (AEO, GEO, LLMO, AI Overviews)
4157
- Moved AEO/GEO content patterns from `seo-audit` references to `ai-seo` skill

skills/ab-test-setup/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: ab-test-setup
33
description: When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," or "hypothesis." For tracking implementation, see analytics-tracking.
44
metadata:
5-
version: 1.0.0
5+
version: 1.1.0
66
---
77

88
# A/B Test Setup
@@ -12,7 +12,7 @@ You are an expert in experimentation and A/B testing. Your goal is to help desig
1212
## Initial Assessment
1313

1414
**Check for product marketing context first:**
15-
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15+
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
1616

1717
Before designing a test, understand:
1818

skills/ad-creative/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: ad-creative
33
description: "When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' or 'ad performance optimization.' This skill covers generating ad creative at scale, iterating based on performance data, and enforcing platform character limits. For campaign strategy and targeting, see paid-ads. For landing page copy, see copywriting."
44
metadata:
5-
version: 1.0.0
5+
version: 1.1.0
66
---
77

88
# Ad Creative
@@ -12,7 +12,7 @@ You are an expert performance creative strategist. Your goal is to generate high
1212
## Before Starting
1313

1414
**Check for product marketing context first:**
15-
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15+
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
1616

1717
Gather this context (ask if not provided):
1818

skills/ai-seo/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: ai-seo
33
description: "When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' or 'zero-click search.' This skill covers content optimization for AI answer engines, monitoring AI visibility, and getting cited as a source. For traditional technical and on-page SEO audits, see seo-audit. For structured data implementation, see schema-markup."
44
metadata:
5-
version: 1.0.0
5+
version: 1.1.0
66
---
77

88
# AI SEO
@@ -12,7 +12,7 @@ You are an expert in AI search optimization — the practice of making content d
1212
## Before Starting
1313

1414
**Check for product marketing context first:**
15-
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15+
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
1616

1717
Gather this context (ask if not provided):
1818

skills/analytics-tracking/SKILL.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: analytics-tracking
33
description: When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," or "tracking plan." For A/B test measurement, see ab-test-setup.
44
metadata:
5-
version: 1.0.0
5+
version: 1.1.0
66
---
77

88
# Analytics Tracking
@@ -12,7 +12,7 @@ You are an expert in analytics implementation and measurement. Your goal is to h
1212
## Initial Assessment
1313

1414
**Check for product marketing context first:**
15-
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15+
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
1616

1717
Before implementing tracking, understand:
1818

@@ -306,3 +306,4 @@ For implementation, see the [tools registry](../../tools/REGISTRY.md). Key analy
306306
- **ab-test-setup**: For experiment tracking
307307
- **seo-audit**: For organic traffic analysis
308308
- **page-cro**: For conversion optimization (uses this data)
309+
- **revops**: For pipeline metrics, CRM tracking, and revenue attribution

skills/churn-prevention/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: churn-prevention
33
description: "When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' or 'involuntary churn.' This skill covers voluntary churn (cancel flows, save offers, exit surveys) and involuntary churn (dunning, payment recovery). For post-cancel win-back email sequences, see email-sequence. For in-app upgrade paywalls, see paywall-upgrade-cro."
44
metadata:
5-
version: 1.0.0
5+
version: 1.1.0
66
---
77

88
# Churn Prevention
@@ -12,7 +12,7 @@ You are an expert in SaaS retention and churn prevention. Your goal is to help r
1212
## Before Starting
1313

1414
**Check for product marketing context first:**
15-
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15+
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
1616

1717
Gather this context (ask if not provided):
1818

skills/cold-email/SKILL.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
---
22
name: cold-email
33
description: Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Covers subject lines, opening lines, body copy, CTAs, personalization, and multi-touch follow-up sequences.
4+
metadata:
5+
version: 1.1.0
46
---
57

68
# Cold Email Writing
@@ -10,7 +12,7 @@ You are an expert cold email writer. Your goal is to write emails that sound lik
1012
## Before Writing
1113

1214
**Check for product marketing context first:**
13-
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15+
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
1416

1517
Understand the situation (ask if not provided):
1618

@@ -153,3 +155,4 @@ Use this data to inform your writing — not as a checklist to satisfy.
153155
- **email-sequence**: For lifecycle/nurture email sequences (not cold outreach)
154156
- **social-content**: For LinkedIn and social posts
155157
- **product-marketing-context**: For establishing foundational positioning
158+
- **revops**: For lead scoring, routing, and pipeline management

0 commit comments

Comments
 (0)