Skip to content

Commit f32902c

Browse files
docs: update and restructure README per feature releases
- Replace 3 narrative sections (Why This Exists, Who This Is For, Why Depth Over Breadth) with concise 2-paragraph intro - Add Quick Start section above the fold with install and example prompts - Remove redundant Getting Started section - Add new skill category tables: SEO & AI Search, Growth & Conversion, Analytics & Measurement, Strategy & Brand - Add Phase 8 skills to existing category tables - Update skill count references from 27 to 50+ - Remove outdated terminal.png screenshot - Update nav links, demo link text - Update closing tagline Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 7eeb06b commit f32902c

File tree

1 file changed

+69
-71
lines changed

1 file changed

+69
-71
lines changed

README.md

Lines changed: 69 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# claude-marketing
44

5-
**25 open source Claude Code skills, specialized agents, and autonomous workflows for marketing teams.** Paid media, e-commerce, content, strategy, creative, reporting, and development — specialist depth without specialist headcount.
5+
**50+ open source Claude Code skills, specialized agents, and autonomous workflows for marketing teams.** Paid media, e-commerce, content, strategy, creative, reporting, and development — specialist depth without specialist headcount.
66

77
<br>
88
<br>
@@ -29,10 +29,6 @@ git clone https://github.com/thatrebeccarae/claude-marketing.git
2929
<br>
3030
<br>
3131

32-
<a href="https://thatrebeccarae.github.io/claude-marketing/skill-packs/demo/">
33-
<img src="assets/terminal.png" alt="claude-marketing terminal preview" width="760">
34-
</a>
35-
3632
<!--
3733
### What people are saying
3834
@@ -46,71 +42,54 @@ git clone https://github.com/thatrebeccarae/claude-marketing.git
4642
<br>
4743
<br>
4844

49-
[Why This Exists](#why-this-exists) · [Who This Is For](#who-this-is-for) · [Why Depth Over Breadth](#why-depth-over-breadth) · [What's Inside](#whats-inside) · [Skills](#skills) · [Skill Packs](#skill-packs) · [Agents](#agents) · [Workflows](#workflows) · [Getting Started](#getting-started) · [Multi-Tool Support](#multi-tool-support) · [How Skills Work](#how-skills-work) · [Composing Skills](#composing-skills) · [Example Prompts](#example-prompts) · [Configuration](#configuration) · [Security](#security) · [Troubleshooting](#troubleshooting) · [Documentation](#documentation) · [Contributing](#contributing) · [License](#license)
45+
[Quick Start](#quick-start) · [Skills](#skills) · [Skill Packs](#skill-packs) · [Agents](#agents) · [Workflows](#workflows) · [Multi-Tool Support](#multi-tool-support) · [How Skills Work](#how-skills-work) · [Composing Skills](#composing-skills) · [Example Prompts](#example-prompts) · [Configuration](#configuration) · [Contributing](#contributing) · [License](#license)
46+
5047

5148
</div>
5249

5350
---
5451

55-
## Why This Exists
56-
57-
[Claude Code](https://docs.anthropic.com/en/docs/claude-code) is Anthropic's AI coding agent — it runs in your terminal and can read files, run commands, and work with APIs. These skills give it marketing expertise it doesn't have out of the box.
58-
59-
Most "AI marketing" tools launching lately are wrappers with an up-charge — skills that don't work, agents that are anything but "autonomous," or repackaged capabilities your platforms already ship natively, sold back to you with a dashboard and a subscription fee.
60-
61-
**claude-marketing is a complete digital marketing skill set with built-in domain expertise.** No wrappers, no subscriptions, no dashboards selling you capabilities you already own. The focused knowledge, benchmarks, and diagnostic frameworks that make Claude Code useful for lean marketing teams — open source, free, and built from years inside Klaviyo, Shopify, GA4, GTM, analytics stacks, and orchestration layers.
62-
63-
- **Skill packs** give Claude Code the same platform expertise a senior marketing consultant brings to an audit
64-
- **Agent workflows** are autonomous pipelines that monitor GA4 properties, detect anomalies, and implement fixes via GTM — without anyone lifting a finger
65-
66-
This is the department that $70K+/year solutions try to sell you. Now anyone can `git clone` it.
67-
68-
Active project, open-sourced as-is. Fork it and make it yours — updates and new releases published regularly. Install what you need and ask questions in plain English.
69-
70-
71-
## Who This Is For
72-
73-
- **Solo marketers and small teams** who need specialist depth without specialist headcount
74-
- **DTC and e-commerce operators** running Klaviyo, Shopify, GA4, or Looker Studio
75-
- **Growth teams** that need cross-platform analysis, not platform-by-platform reports
76-
- **Content marketers** who want research-backed, SEO-optimized content at scale
77-
- **Agencies and consultants** looking to scale their diagnostic and deliverable process
78-
- **Founders** who are tired of paying for audits they could run themselves
79-
- **Developers** working on marketing projects who want safe deployment practices
52+
50+ open-source skills that give [Claude Code](https://docs.anthropic.com/en/docs/claude-code) real marketing expertise — diagnostic frameworks, industry benchmarks, audit checklists, and platform-specific reference data across paid media, SEO, e-commerce, content, CRO, analytics, and strategy. Also works with Cursor, Aider, Windsurf, GitHub Copilot, and Gemini CLI.
8053

81-
Implementation-ready answers — not tutorials, not blog-post-level overviews.
54+
Each skill ships three layers: **SKILL.md** (frameworks and decision trees), **REFERENCE.md** (benchmarks, API schemas, rate limits), and **EXAMPLES.md** (worked prompts with expected output). Not prompt templates — implementation-grade tools tested in real engagements.
8255

83-
## Why Depth Over Breadth
56+
## Quick Start
8457

85-
There are repos with 100+ AI agent personas — a paragraph of instructions and a personality for every conceivable role. Those are prompt templates, not tools. They tell Claude *what to be*, not *what to know*.
58+
```bash
59+
# Clone the repo
60+
git clone https://github.com/thatrebeccarae/claude-marketing.git
8661

87-
claude-marketing takes the opposite approach. Every skill ships with three layers:
62+
# Copy any skill
63+
cp -r claude-marketing/skills/google-ads ~/.claude/skills/
8864

89-
- **SKILL.md** — diagnostic frameworks, decision trees, and workflow patterns tested in real engagements
90-
- **REFERENCE.md** — platform-specific benchmarks, API schemas, rate limits, and field mappings that Claude doesn't have in its training data
91-
- **EXAMPLES.md** — worked examples with realistic prompts and expected output formats
65+
# Or install a full pack
66+
python claude-marketing/skill-packs/scripts/setup-paid-media.py
9267

93-
A 500-line Klaviyo skill with deliverability thresholds, RFM segment definitions, and flow audit checklists will outperform a 200-word "Klaviyo Specialist" persona every time. The persona knows *about* Klaviyo. The skill knows *how to audit one*.
68+
# Then ask Claude Code anything
69+
# "Run a scored audit of my Google Ads account"
70+
# "Audit my Klaviyo flows and tell me what's missing"
71+
# "Optimize this page for AI search citations"
72+
```
9473

95-
Depth compounds when skills compose — an ICP grounded in research data produces a better Klaviyo audit, which produces a sharper GA4 cross-reference, which produces a deck that actually tells a story. See [Composing Skills](examples/) for how this works in practice.
74+
Each skill works independently — install only what you need.
9675

9776
## What's Inside
9877

9978
| Category | What It Is | Count |
10079
|----------|-----------|-------|
101-
| **[Skills](skills/)** | Claude Code skills — install individually or as packs | 27 skills |
80+
| **[Skills](skills/)** | Claude Code skills — install individually or as packs | 50+ skills |
10281
| **[Skill Packs](skill-packs/)** | Grouped collections with setup guides and install wizards | 6 packs |
10382
| **[Examples](examples/)** | Cross-skill workflow walkthroughs showing how skills compose | 3 workflows |
10483
| **[Agents](agents/)** | Standalone agents — portable analysis logic, usable with or without n8n | 3 agents |
10584
| **[Workflows](workflows/)** | Autonomous n8n pipelines that wire agents together on a schedule | 1 pipeline |
10685

10786
## Skills
10887

109-
All 27 skills live in [`skills/`](skills/) — install individually or use a [skill pack](skill-packs/) to set up a related group.
88+
All 50+ skills live in [`skills/`](skills/) — install individually or use a [skill pack](skill-packs/) to set up a related group.
11089

11190
> **All skills tested March 2026 with Claude Code v2.1.** Each skill's SKILL.md includes a `tested` date and `tested_with` version in its frontmatter metadata.
11291
113-
> [**View Live Demo**](https://thatrebeccarae.github.io/claude-marketing/skill-packs/demo/) — See skills in action with example terminal output.
92+
> [**View Demo**](https://thatrebeccarae.github.io/claude-marketing/skill-packs/demo/) — See skills in action with example terminal output.
11493
11594
### DTC & E-commerce
11695

@@ -134,6 +113,8 @@ All 27 skills live in [`skills/`](skills/) — install individually or use a [sk
134113
| **[Competitor Ads Analyst](skills/competitor-ads-analyst/)** | Competitor ad creative analysis from public ad libraries — messaging patterns, creative formats, positioning gaps |
135114
| **[Wasted Spend Finder](skills/wasted-spend-finder/)** | Systematic Google Ads and Meta waste analysis — produces uploadable exclusion lists with thematic categorization |
136115
| **[Cross-Platform Audit](skills/cross-platform-audit/)** | Unified multi-platform scored audit — parallel execution across Google, Meta, and Microsoft with budget-weighted aggregate health score (A-F), cross-platform analysis, and optional deck generation |
116+
| **[LinkedIn Ads](skills/linkedin-ads/)** | B2B advertising — campaign setup, professional targeting, Lead Gen Forms, ABM campaigns, Matched Audiences |
117+
| **[TikTok Ads](skills/tiktok-ads/)** | Short-form video ads — Spark Ads, TikTok Shop, creative strategy, pixel/Events API, audience targeting |
137118

138119
### Content
139120

@@ -142,6 +123,8 @@ All 27 skills live in [`skills/`](skills/) — install individually or use a [sk
142123
| **[SEO Content Writer](skills/seo-content-writer/)** | SEO-optimized content with brand voice analysis — blog posts, social media, email campaigns, landing pages |
143124
| **[Content Workflow](skills/content-workflow/)** | End-to-end content pipeline: research → draft → editorial review → social distribution |
144125
| **[Email Composer](skills/email-composer/)** | Client outreach, deliverable handoffs, scope discussions, and follow-up cadence — with tone calibration per context |
126+
| **[Content Pipeline](skills/content-pipeline/)** | Multi-agent orchestration — chains research, editorial review, and social distribution agents in sequence |
127+
| **[Content Creator](skills/content-creator/)** | Brand voice analysis, SEO optimization scripts, content calendar planning, multi-platform strategy |
145128

146129
### Strategy & Research
147130

@@ -166,51 +149,66 @@ All 27 skills live in [`skills/`](skills/) — install individually or use a [sk
166149
|-------|-------------------|
167150
| **[Pro Deck Builder](skills/pro-deck-builder/)** | Polished HTML slide decks and PDF-ready reports — dark covers, warm light content, component library |
168151
| **[HTML Report Builder](skills/html-report-builder/)** | Multi-page HTML reports for consulting deliverables — KPI cards, data tables, callout boxes, recommendation cards |
152+
| **[Pro Report Builder](skills/pro-report-builder/)** | HTML consulting reports — dark cover, warm cream pages, KPI cards, data tables, recommendation cards, PDF export |
153+
| **[Data Viz Deck](skills/data-viz-deck/)** | PPTX decks, interactive HTML dashboards, and chart generation from audit data |
169154

170155
### Developer Tools
171156

172157
| Skill | What Claude Can Do |
173158
|-------|-------------------|
174159
| **[Safe Push](skills/safe-push/)** | Pre-push hygiene — PII/secrets scanning, commit message audit, rate-limited pushing, allowlist support |
175160
| **[GitHub README](skills/github-readme/)** | Generate, audit, or update READMEs — detects repo type, selects badges, enforces structure standards |
161+
| **[DOCX](skills/docx/)** | Word document creation, editing, tracked changes, redlining, and analysis |
162+
| **[MCP Builder](skills/mcp-builder/)** | MCP server development guide — Python (FastMCP) and TypeScript, with evaluation framework |
163+
| **[Skill Creator](skills/skill-creator/)** | Guide for creating Claude Code skills — anatomy, progressive disclosure, packaging |
164+
| **[React Best Practices](skills/react-best-practices/)** | 40+ React/Next.js performance optimization rules — waterfalls, bundles, rendering |
176165

177-
## Skill Packs
178-
179-
Grouped collections with setup wizards for installing related skills together:
166+
### SEO & AI Search
180167

181-
- **[DTC Pack](skill-packs/dtc-pack.md)** — 6 skills for e-commerce (Klaviyo Analyst, Klaviyo Developer, Shopify, Google Analytics, Looker Studio, Pro Deck Builder)
182-
- **[Paid Media Pack](skill-packs/paid-media-pack.md)** — 6 skills for paid advertising (Google Ads, Meta Ads, Microsoft Ads, Competitor Ads Analyst, Wasted Spend Finder, Account Structure Review)
183-
- **[Content Pack](skill-packs/content-pack.md)** — 3 skills for content creation (SEO Content Writer, Content Workflow, Email Composer)
184-
- **[Strategy & Research Pack](skill-packs/strategy-pack.md)** — 3 skills for research and strategy (Market Research, ICP Research, Research Digest)
185-
- **[Creative & Design Pack](skill-packs/creative-pack.md)** — 3 skills for creative production (Frontend Design, Tech Diagram, Remotion Video)
186-
- **[Developer Tools Pack](skill-packs/dev-tools-pack.md)** — 2 skills for safe deployment and documentation (Safe Push, GitHub README)
168+
| Skill | What Claude Can Do |
169+
|-------|-------------------|
170+
| **[AEO/GEO Optimizer](skills/aeo-geo-optimizer/)** | AI search optimization — appear in ChatGPT, Perplexity, Google AI Overviews. Content scoring, citation patterns, AI crawler management |
171+
| **[Technical SEO Audit](skills/technical-seo-audit/)** | Deep crawl analysis, Core Web Vitals, indexation health, site architecture, canonical tags, structured data validation |
172+
| **[Schema Markup Generator](skills/schema-markup-generator/)** | JSON-LD structured data — Article, FAQ, HowTo, Product, Review, LocalBusiness, BreadcrumbList |
173+
| **[Programmatic SEO](skills/programmatic-seo/)** | Template-based page generation at scale — integration pages, location pages, comparison pages, internal linking |
174+
| **[GTM](skills/gtm/)** | Google Tag Manager — container audits, consent mode v2, server-side tagging, debugging, tag architecture |
187175

188-
## Getting Started
176+
### Growth & Conversion
189177

190-
### Copy Individual Skills
178+
| Skill | What Claude Can Do |
179+
|-------|-------------------|
180+
| **[CRO Auditor](skills/cro-auditor/)** | Conversion rate optimization — LIFT model heuristic evaluation, ICE/PIE prioritization, A/B test hypothesis generation |
181+
| **[Landing Page Optimizer](skills/landing-page-optimizer/)** | Page audit and optimization — above-the-fold, value props, CTAs, social proof, forms, mobile |
182+
| **[A/B Testing Framework](skills/ab-testing-framework/)** | Experiment design, sample size calculation, statistical significance, Bayesian vs frequentist analysis |
183+
| **[Cold Email & Outreach](skills/cold-email-outreach/)** | Outreach sequences, deliverability optimization, personalization tiers, CAN-SPAM/GDPR compliance |
184+
| **[Retention & Churn Prevention](skills/retention-churn-prevention/)** | Churn analysis, customer health scoring, cohort analysis, win-back campaigns, CLV calculation |
191185

192-
```bash
193-
git clone https://github.com/thatrebeccarae/claude-marketing.git
194-
cd claude-marketing
195-
cp -r skills/google-ads ~/.claude/skills/
196-
```
186+
### Analytics & Measurement
197187

198-
Each skill works independently — install only the ones you need.
188+
| Skill | What Claude Can Do |
189+
|-------|-------------------|
190+
| **[UTM & Attribution Strategy](skills/utm-attribution-strategy/)** | UTM taxonomy design, attribution model selection, cross-channel measurement, GA4 attribution configuration |
199191

200-
### Setup Wizard (for a full pack)
192+
### Strategy & Brand
201193

202-
```bash
203-
# DTC e-commerce pack
204-
python skill-packs/scripts/setup-dtc.py
194+
| Skill | What Claude Can Do |
195+
|-------|-------------------|
196+
| **[Pricing Strategy](skills/pricing-strategy/)** | Pricing models, value metric selection, competitive analysis, pricing page optimization, tier design |
197+
| **[Customer Journey Mapping](skills/customer-journey-mapping/)** | Journey stage mapping, touchpoint inventory, drop-off analysis, persona-based journey variants |
198+
| **[Brand Voice & Guidelines](skills/brand-voice-guidelines/)** | Voice development, personality archetypes, tone matrices, messaging frameworks, style guides |
199+
| **[Social Media Strategy](skills/social-media-strategy/)** | Platform-specific organic strategy, content pillar framework, engagement tactics, content calendars |
200+
| **[Copywriting Frameworks](skills/copywriting-frameworks/)** | AIDA, PAS, BAB, 4Ps, StoryBrand, QUEST, FAB — framework-driven copy for ads, pages, emails |
205201

206-
# Paid media pack
207-
python skill-packs/scripts/setup-paid-media.py
208-
```
202+
## Skill Packs
209203

210-
The wizard checks prerequisites, walks you through API key setup, installs dependencies, and tests connections.
204+
Grouped collections with setup wizards for installing related skills together:
211205

212-
> [!TIP]
213-
> See [DTC Getting Started](skill-packs/dtc-getting-started.md) or [Paid Media Getting Started](skill-packs/paid-media-getting-started.md) for detailed setup per platform.
206+
- **[DTC Pack](skill-packs/dtc-pack.md)** — 6 skills for e-commerce (Klaviyo Analyst, Klaviyo Developer, Shopify, Google Analytics, Looker Studio, Pro Deck Builder)
207+
- **[Paid Media Pack](skill-packs/paid-media-pack.md)** — 6 skills for paid advertising (Google Ads, Meta Ads, Microsoft Ads, Competitor Ads Analyst, Wasted Spend Finder, Account Structure Review)
208+
- **[Content Pack](skill-packs/content-pack.md)** — 3 skills for content creation (SEO Content Writer, Content Workflow, Email Composer)
209+
- **[Strategy & Research Pack](skill-packs/strategy-pack.md)** — 3 skills for research and strategy (Market Research, ICP Research, Research Digest)
210+
- **[Creative & Design Pack](skill-packs/creative-pack.md)** — 3 skills for creative production (Frontend Design, Tech Diagram, Remotion Video)
211+
- **[Developer Tools Pack](skill-packs/dev-tools-pack.md)** — 2 skills for safe deployment and documentation (Safe Push, GitHub README)
214212

215213
## Multi-Tool Support
216214

@@ -529,6 +527,6 @@ MIT — see [LICENSE](LICENSE) for details.
529527

530528
---
531529

532-
**Your marketing department lives here now.**<br>Install the skills, deploy the workflows, and get to work.
530+
**The expertise layer your AI agent is missing.**<br>git clone it. Install what you need. Ask in plain English.
533531

534532
</div>

0 commit comments

Comments
 (0)