Imported from reason-machines/marketing-skills (skills/claude-marketing-skills/SKILL.md) via skills.sh. Install upstream with npx skills add reason-machines/marketing-skills --skill claude-marketing-skills. Copyright stays with the author.

claude-marketing-skills

Skill by ara.so — Marketing Skills collection.

claude-marketing is a collection of 56 open-source Claude Code skills, specialized agents, and autonomous workflows that give AI coding agents real marketing expertise. Each skill ships with diagnostic frameworks, industry benchmarks, audit checklists, and platform-specific reference data across paid media, SEO, e-commerce, content, CRO, analytics, and strategy.

Works with Claude Code, Cursor, Aider, Windsurf, GitHub Copilot, and Gemini CLI.

Installation

Clone the Repository

git clone https://github.com/thatrebeccarae/claude-marketing.git
cd claude-marketing

Install Individual Skills

Copy any skill to your Claude Code skills directory:

# Example: Install Google Ads skill
cp -r skills/google-ads ~/.claude/skills/

# Example: Install Klaviyo Analyst skill
cp -r skills/klaviyo-analyst ~/.claude/skills/

# Example: Install AEO/GEO Optimizer
cp -r skills/aeo-geo-optimizer ~/.claude/skills/

Install Skill Packs

Use setup scripts to install related skill groups:

# Paid Media Pack (Google Ads, Meta, Microsoft, LinkedIn, TikTok, cross-platform)
python skill-packs/scripts/setup-paid-media.py

# E-commerce Pack (Shopify, Klaviyo, product feeds, conversion tracking)
python skill-packs/scripts/setup-ecommerce.py

# Analytics Pack (GA4, Looker Studio, GTM, data visualization)
python skill-packs/scripts/setup-analytics.py

# SEO Pack (Technical SEO, AEO/GEO, schema, programmatic SEO)
python skill-packs/scripts/setup-seo.py

# Content Pack (content creation, brand voice, social strategy)
python skill-packs/scripts/setup-content.py

# Strategy Pack (market research, ICP, brand DNA, pricing)
python skill-packs/scripts/setup-strategy.py

Project Structure

claude-marketing/
├── skills/               # 56 individual skills
│   ├── google-ads/
│   │   ├── SKILL.md     # Framework and decision trees
│   │   ├── REFERENCE.md # Benchmarks, API schemas, rate limits
│   │   └── EXAMPLES.md  # Worked prompts with output
│   ├── klaviyo-analyst/
│   ├── aeo-geo-optimizer/
│   └── ...
├── skill-packs/         # Grouped collections with setup wizards
│   ├── paid-media/
│   ├── ecommerce/
│   ├── analytics/
│   └── scripts/
├── agents/              # Standalone analysis agents
│   ├── competitor-analyst/
│   ├── content-strategist/
│   └── paid-media-auditor/
├── workflows/           # n8n autonomous pipelines
│   └── daily-performance-digest/
└── examples/            # Cross-skill workflow walkthroughs

Skill Anatomy

Each skill contains three layers:

SKILL.md — Frameworks, decision trees, diagnostic checklists
REFERENCE.md — Industry benchmarks, API schemas, rate limits, platform-specific data
EXAMPLES.md — Worked prompts with expected output

Key Skills by Category

Paid Media

google-ads — Scored account audits (74 checks, A-F health grade), Quality Score optimization, Performance Max, wasted spend identification.

# Install
cp -r skills/google-ads ~/.claude/skills/

# Example usage
# "Run a scored audit of my Google Ads account"
# "Analyze Quality Score distribution and recommend optimizations"
# "Find wasted spend in search campaigns"

meta-ads — Scored audits (46 checks), creative fatigue diagnosis, pixel/CAPI health, iOS 14.5+ attribution.

cross-platform-audit — Unified multi-platform audit across Google, Meta, Microsoft with budget-weighted aggregate health score.

E-commerce

klaviyo-analyst (MCP-first) — Full Klaviyo audit: 4-phase account review, flow gap analysis, segment health, deliverability diagnostics.

# Install
cp -r skills/klaviyo-analyst ~/.claude/skills/

# Requires Klaviyo MCP server
# Install: npx -y @klaviyo/mcp-server-klaviyo

# Example usage
# "Audit my Klaviyo flows and identify gaps"
# "Analyze email deliverability and segment health"
# "Generate revenue attribution report for Q1"

shopify-analyst — Store health audits, checkout optimization, product feed validation, app conflict detection.

SEO & AI Search

aeo-geo-optimizer — AI search optimization for ChatGPT, Perplexity, Google AI Overviews. Content scoring, citation patterns, AI crawler management.

# Install
cp -r skills/aeo-geo-optimizer ~/.claude/skills/

# Example usage
# "Optimize this page for AI search citations"
# "Audit content for ChatGPT and Perplexity visibility"
# "Generate llms.txt for my documentation site"

technical-seo-audit — Deep crawl analysis, Core Web Vitals, indexation health, structured data validation.

schema-markup-generator — JSON-LD structured data for Article, FAQ, HowTo, Product, Review, LocalBusiness.

# Example: Generate product schema
from skills.schema_markup_generator import generate_schema

product_data = {
    "name": "Organic Cotton T-Shirt",
    "description": "100% organic cotton, fair trade certified",
    "price": 29.99,
    "currency": "USD",
    "availability": "InStock",
    "brand": "EcoWear",
    "image": "https://example.com/images/tshirt.jpg",
    "sku": "ECO-TS-001",
    "gtin": "00012345678905"
}

schema_json = generate_schema("Product", product_data)
print(schema_json)

Content & Strategy

brand-dna — Extract brand identity from URL: voice, colors, typography, imagery, values → brand-profile.json.

# Install
cp -r skills/brand-dna ~/.claude/skills/

# Example usage
# "Extract brand DNA from https://example.com"
# "Analyze brand voice and create brand-profile.json"

content-creator — Brand voice analysis, SEO optimization, content calendar planning, multi-platform strategy.

market-research — Consulting-grade reports (50+ pages): Porter's Five Forces, PESTLE, SWOT, TAM/SAM/SOM.

Conversion & Growth

cro-auditor — CRO audits using LIFT model, ICE/PIE prioritization, A/B test hypothesis generation.

# Install
cp -r skills/cro-auditor ~/.claude/skills/

# Example usage
# "Run a CRO audit on my landing page"
# "Generate A/B test hypotheses prioritized by ICE score"
# "Analyze form drop-off and recommend fixes"

landing-page-optimizer — Page audit: above-the-fold, value props, CTAs, social proof, mobile optimization.

Configuration

Environment Variables

Skills that connect to external platforms require API credentials:

# Google Ads
export GOOGLE_ADS_DEVELOPER_TOKEN=your_dev_token
export GOOGLE_ADS_CLIENT_ID=your_client_id
export GOOGLE_ADS_CLIENT_SECRET=your_client_secret
export GOOGLE_ADS_REFRESH_TOKEN=your_refresh_token

# Meta Ads
export META_ACCESS_TOKEN=your_access_token
export META_AD_ACCOUNT_ID=act_1234567890

# Klaviyo
export KLAVIYO_API_KEY=your_api_key
export KLAVIYO_PRIVATE_KEY=your_private_key

# Google Analytics 4
export GA4_PROPERTY_ID=12345678
export GA4_CREDENTIALS_PATH=/path/to/service-account.json

# Shopify
export SHOPIFY_STORE_URL=your-store.myshopify.com
export SHOPIFY_ACCESS_TOKEN=your_access_token

MCP Server Configuration

For MCP-enabled skills (Klaviyo, Google Ads, Shopify):

// ~/.claude/mcp_settings.json
{
  "mcpServers": {
    "klaviyo": {
      "command": "npx",
      "args": ["-y", "@klaviyo/mcp-server-klaviyo"],
      "env": {
        "KLAVIYO_API_KEY": "${KLAVIYO_API_KEY}"
      }
    },
    "google-ads": {
      "command": "npx",
      "args": ["-y", "@google-ads/mcp-server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "${GOOGLE_ADS_DEVELOPER_TOKEN}",
        "GOOGLE_ADS_CLIENT_ID": "${GOOGLE_ADS_CLIENT_ID}",
        "GOOGLE_ADS_CLIENT_SECRET": "${GOOGLE_ADS_CLIENT_SECRET}",
        "GOOGLE_ADS_REFRESH_TOKEN": "${GOOGLE_ADS_REFRESH_TOKEN}"
      }
    }
  }
}

Common Workflows

Cross-Platform Paid Media Audit

# Install required skills
python skill-packs/scripts/setup-paid-media.py

# Run audit
# "Run a cross-platform audit of my Google Ads, Meta, and Microsoft Ads accounts"
# Output: Budget-weighted aggregate health score (A-F), platform-specific recommendations

E-commerce Email Audit

# Install Klaviyo skill
cp -r skills/klaviyo-analyst ~/.claude/skills/

# Run audit
# "Audit my Klaviyo account and identify flow gaps"
# "Compare my email performance to industry benchmarks"
# "Generate revenue attribution report for abandoned cart flows"

AI Search Optimization

# Install AEO/GEO skill
cp -r skills/aeo-geo-optimizer ~/.claude/skills/

# Optimize content
# "Audit this blog post for AI search citations"
# "Generate llms.txt for my developer documentation"
# "Optimize product pages for ChatGPT and Perplexity visibility"

Landing Page Conversion Audit

# Install CRO skills
cp -r skills/cro-auditor ~/.claude/skills/
cp -r skills/landing-page-optimizer ~/.claude/skills/

# Run audit
# "Run a CRO audit on https://example.com/landing-page"
# "Prioritize conversion optimizations using ICE scoring"
# "Generate A/B test hypotheses for the hero section"

Working with Agents

Agents are standalone analysis tools that can run independently or within n8n workflows.

Competitor Analyst Agent

# agents/competitor-analyst/competitor_analyst.py
from competitor_analyst import CompetitorAnalyst

analyst = CompetitorAnalyst()

# Analyze competitor ads from public ad libraries
report = analyst.analyze_competitor(
    competitor_domain="competitor.com",
    platforms=["google", "meta", "linkedin"],
    date_range="last_90_days"
)

print(report.messaging_patterns)
print(report.creative_formats)
print(report.positioning_gaps)

Content Strategist Agent

# agents/content-strategist/content_strategist.py
from content_strategist import ContentStrategist

strategist = ContentStrategist()

# Generate content strategy from research feed
strategy = strategist.generate_strategy(
    topic="AI search optimization",
    sources=["rss_feeds", "web_scraping"],
    output_format="notion"
)

print(strategy.content_angles)
print(strategy.keyword_clusters)
print(strategy.content_calendar)

Autonomous Workflows

Daily Performance Digest (n8n)

# Install workflow
cp -r workflows/daily-performance-digest ~/.n8n/workflows/

# Configure in n8n:
# 1. Set schedule trigger (daily at 8am)
# 2. Add Slack webhook for notifications
# 3. Configure platform credentials (Google Ads, Meta, GA4)
# 4. Activate workflow

What it does:

Pulls performance data from Google Ads, Meta, GA4
Runs anomaly detection on key metrics
Generates Looker Studio snapshot
Posts digest to Slack with priority alerts

Code Examples

Generate Schema Markup

from skills.schema_markup_generator import SchemaGenerator

generator = SchemaGenerator()

# Product schema
product_schema = generator.generate(
    schema_type="Product",
    data={
        "name": "Wireless Headphones",
        "description": "Noise-cancelling wireless headphones",
        "price": 199.99,
        "currency": "USD",
        "availability": "InStock",
        "brand": "AudioCo",
        "aggregateRating": {
            "ratingValue": 4.5,
            "reviewCount": 127
        }
    }
)

print(product_schema)

Run Google Ads Audit

from skills.google_ads import GoogleAdsAuditor

auditor = GoogleAdsAuditor(
    developer_token=os.getenv("GOOGLE_ADS_DEVELOPER_TOKEN"),
    client_id=os.getenv("GOOGLE_ADS_CLIENT_ID"),
    client_secret=os.getenv("GOOGLE_ADS_CLIENT_SECRET"),
    refresh_token=os.getenv("GOOGLE_ADS_REFRESH_TOKEN")
)

# Run scored audit (74 checks)
audit_report = auditor.run_audit(customer_id="1234567890")

print(f"Overall Health Grade: {audit_report.health_grade}")
print(f"Score: {audit_report.score}/100")
print("\nTop Issues:")
for issue in audit_report.top_issues:
    print(f"- {issue.title} (Impact: {issue.impact})")

Extract Brand DNA

from skills.brand_dna import BrandDNAExtractor

extractor = BrandDNAExtractor()

# Extract from URL
brand_profile = extractor.extract(url="https://example.com")

# Save to JSON
brand_profile.save("brand-profile.json")

print(f"Brand Voice: {brand_profile.voice.tone}")
print(f"Primary Colors: {brand_profile.colors.primary}")
print(f"Target Audience: {brand_profile.audience.demographics}")

Optimize for AI Search

from skills.aeo_geo_optimizer import AEOOptimizer

optimizer = AEOOptimizer()

# Analyze content
content = """
Your blog post or documentation content here...
"""

analysis = optimizer.analyze(content)

print(f"AI Search Score: {analysis.score}/100")
print(f"Citation Probability: {analysis.citation_probability}")
print("\nOptimization Recommendations:")
for rec in analysis.recommendations:
    print(f"- {rec.title}: {rec.description}")

Troubleshooting

Skills Not Loading

# Verify skills directory
ls -la ~/.claude/skills/

# Check skill structure (must have SKILL.md)
ls -la ~/.claude/skills/google-ads/

# Restart Claude Code
# Skills are loaded on startup

MCP Server Connection Issues

# Test Klaviyo MCP server
npx -y @klaviyo/mcp-server-klaviyo

# Check environment variables
echo $KLAVIYO_API_KEY

# Verify MCP config
cat ~/.claude/mcp_settings.json

API Authentication Errors

# Google Ads: Verify OAuth2 credentials
# Meta: Check access token has ads_read permission
# Klaviyo: Ensure API key has Full Access scope
# GA4: Verify service account has Viewer role on property

Skill Pack Installation Fails

# Install dependencies
pip install -r skill-packs/requirements.txt

# Run setup with verbose logging
python skill-packs/scripts/setup-paid-media.py --verbose

# Manual installation fallback
cp -r skill-packs/paid-media/skills/* ~/.claude/skills/

Additional Resources

Complete Guide: claude-marketing-guide (free, Notion, 6 pages)
Catalog: Live skill catalog
Substack: dgtl dept*
GitHub: thatrebeccarae/claude-marketing
License: MIT

Example Prompts

"Run a scored audit of my Google Ads account"
"Audit my Klaviyo flows and tell me what's missing"
"Optimize this page for AI search citations"
"Find wasted spend in my Meta campaigns"
"Generate product schema markup for my Shopify store"
"Extract brand DNA from https://example.com"
"Run a CRO audit on my checkout page"
"Analyze competitor ad creative from Facebook Ad Library"
"Create a content calendar for Q2 based on keyword research"
"Generate A/B test hypotheses for my landing page hero section"

About