ai-marketing-claude-code-skills

AI Marketing Claude Code Skills

Skill by ara.so — Marketing Skills collection.

This project provides pre-packaged marketing expertise as "skills" that AI coding agents (Claude Code, OpenClaw, Cursor, etc.) can load and execute. Instead of prompting from scratch, these skills give your agent structured frameworks for positioning, content strategy, LinkedIn authority, homepage audits, and more.

What This Project Does

AI Marketing Skills turn marketing frameworks into executable instructions for AI agents. Each skill contains:

• Triggers: Natural language phrases that activate the skill
• Framework: Step-by-step methodology from marketing experts
• Output format: Structured deliverables (audits, strategies, content)
• Execution modes: Quick, standard, or deep analysis levels

The project includes 23 free skills and 10 premium skills covering strategy, content, research, conversion, and productivity.

Installation

Quick Install (Auto-detect Platform)

git clone https://github.com/BrianRWagner/ai-marketing-claude-code-skills.git
cd ai-marketing-claude-code-skills
bash scripts/install.sh

The installer auto-detects Claude Code, OpenClaw, Cursor, and Windsurf and installs to the correct location.

Manual Install for Claude Code

# Clone the repository
git clone https://github.com/BrianRWagner/ai-marketing-claude-code-skills.git

# Create Claude Code skills directory if it doesn't exist
mkdir -p ~/.claude/skills

# Copy all skills
cp -r ai-marketing-claude-code-skills/* ~/.claude/skills/

Install for OpenClaw

mkdir -p ~/.openclaw/skills
cp -r ai-marketing-claude-code-skills/* ~/.openclaw/skills/

OpenClaw uses SKILL-OC.md files (token-efficient versions) when available, falling back to SKILL.md if not present.

Install for Cursor

# From project root
bash scripts/convert.sh --platform=cursor --output-dir=./.cursor/rules

This converts SKILL.md files to .mdc format with proper frontmatter for Cursor.

Install for Windsurf

bash scripts/convert.sh --platform=windsurf --output-dir=./.windsurf/rules

Install Flags

# Install to all detected platforms
bash scripts/install.sh --all

# Install to specific platform only
bash scripts/install.sh --platform=cursor

# Include premium skills (if you've purchased them)
bash scripts/install.sh --include-pro

# Preview without actually installing
bash scripts/install.sh --dry-run

Available Skills Reference

List All Skills

cd ai-marketing-claude-code-skills
bash scripts/list-skills.sh

Output shows:

• Skill name
• Category
• File location
• Free vs Premium status

Key Free Skills

Strategy & Positioning:

• positioning-basics - Core positioning framework (who, what, why different)
• ai-discoverability-audit - How your brand appears in AI search (ChatGPT, Perplexity, Claude)
• marketing-principles - Apply timeless principles from Drucker, Ogilvy, Godin, etc.

Content & Authority:

• linkedin-authority-builder - Build LinkedIn thought leadership system
• content-idea-generator - Generate content ideas based on ICP and positioning
• voice-extractor - Extract and document authentic writing voice from samples
• de-ai-ify - Remove AI jargon, restore human voice
• social-card-gen - Generate platform-specific social posts (Twitter, LinkedIn, Reddit)

Research & Intelligence:

• last30days - Research any topic across Reddit, X, web (last 30 days)
• reddit-insights - Semantic search and analysis of Reddit content
• youtube-summarizer - Fetch transcripts and generate structured summaries
• linkedin-profile-optimizer - Audit and rewrite LinkedIn profile for visibility

Conversion & Sales:

• homepage-audit - Quick conversion audit for landing pages
• cold-outreach-sequence - Build personalized LinkedIn/email sequences
• case-study-builder - Turn client wins into formatted case studies
• testimonial-collector - Systematically gather testimonials

Productivity:

• plan-my-day - Energy-optimized daily planning (circadian + GTD)
• newsletter-creation-curation - Industry-adaptive B2B newsletter creation
• go-mode - Deep work execution mode

Using Skills with Claude Code

Once installed, Claude Code automatically detects and uses skills based on your conversation.

Trigger Skills Naturally

You: "Help me with positioning for my SaaS product"
→ Activates positioning-basics skill

You: "How do I show up in ChatGPT search?"
→ Activates ai-discoverability-audit skill

You: "What should I post on LinkedIn this week?"
→ Activates content-idea-generator skill

Specify Execution Mode

All v3.1+ skills support three execution modes:

You: "Quick positioning help for my startup"
→ Quick mode: Fast answers, minimal questions

You: "Standard positioning audit"
→ Standard mode: Balanced depth

You: "Deep positioning analysis for enterprise rebrand"
→ Deep mode: Comprehensive audit, all phases

Direct Skill Invocation

You: "Use the homepage-audit skill on https://example.com"

You: "Run linkedin-authority-builder in deep mode"

You: "Apply marketing-principles to this decision: [paste context]"

Skill File Structure

Each skill directory contains:

skill-name/
├── SKILL.md          # Full Claude Code version (verbose, all phases)
├── SKILL-OC.md       # OpenClaw version (token-efficient, ~200 lines)
├── README.md         # Human-readable documentation
└── examples/         # Optional usage examples

Anatomy of a SKILL.md File

---
name: skill-name
description: One-line description of what the skill does
triggers:
  - "natural phrase 1"
  - "natural phrase 2"
  - "natural phrase 3"
---

# Skill Name

## Context
[When to use this skill]

## Execution Modes
- **Quick**: Fast answers, 2-3 questions
- **Standard**: Balanced depth, 5-7 questions
- **Deep**: Comprehensive, all phases

## Framework
[Step-by-step methodology]

## Output Format
[Structured deliverable format]

## Examples
[Real usage examples]

Configuration

Environment Variables

Skills that use external APIs require environment variables:

# For skills that search Reddit
export REDDIT_API_KEY="your_reddit_api_key"

# For skills that use web search
export SERP_API_KEY="your_serp_api_key"

# For YouTube transcript fetching
# No API key needed - uses public endpoints

Add to ~/.bashrc, ~/.zshrc, or use a .env file:

# .env file in project root
REDDIT_API_KEY=your_reddit_api_key
SERP_API_KEY=your_serp_api_key

Platform-Specific Paths

Common Patterns

Pattern 1: Strategic Decision Making

You: "Should I focus on LinkedIn or Twitter for B2B SaaS?"

Claude (using marketing-principles):
→ Applies first principles from Drucker, Godin
→ Evaluates based on your ICP
→ Provides framework-backed recommendation

Pattern 2: Content Creation Workflow

You: "I need to build LinkedIn presence"

Step 1: Use linkedin-authority-builder
→ Get positioning, content pillars, posting rhythm

Step 2: Use content-idea-generator
→ Generate 30 days of content ideas

Step 3: Use voice-extractor (on your existing content)
→ Document your authentic voice

Step 4: Use social-card-gen
→ Generate platform-specific variants

Pattern 3: Research + Execution

You: "Research AI agent trends and create a LinkedIn post"

Step 1: Use last30days
→ Research "AI agents" across Reddit, X, web (last 30 days)
→ Get trends, sentiment, key themes

Step 2: Use content-idea-generator
→ Turn insights into post angles

Step 3: Use de-ai-ify
→ Remove AI jargon from final draft

Pattern 4: Audit + Optimize

You: "Audit my homepage and LinkedIn profile"

Step 1: Use homepage-audit
→ Get conversion feedback on landing page

Step 2: Use linkedin-profile-optimizer
→ Rewrite headline, about section
→ AI visibility checklist

Step 3: Use ai-discoverability-audit
→ Check how you appear in ChatGPT, Perplexity, Claude

Converting Skills for Other Platforms

Convert to Cursor Rules

bash scripts/convert.sh --platform=cursor --output-dir=./.cursor/rules

Creates .mdc files with frontmatter:

---
rule: skill-name
description: Skill description
triggers:
  - trigger phrase 1
  - trigger phrase 2
---

[SKILL.md content converted]

Convert to Windsurf Rules

bash scripts/convert.sh --platform=windsurf --output-dir=./.windsurf/rules

Creates .md files with Windsurf-compatible frontmatter.

Convert All Platforms at Once

bash scripts/convert.sh --all

Outputs to ./converted/cursor/, ./converted/windsurf/, etc.

Adding Custom Skills

Create a New Skill

# Create skill directory
mkdir -p ~/.claude/skills/my-custom-skill

# Create SKILL.md
cat > ~/.claude/skills/my-custom-skill/SKILL.md << 'EOF'
---
name: my-custom-skill
description: What this skill does
triggers:
  - "trigger phrase 1"
  - "trigger phrase 2"
  - "trigger phrase 3"
---

# My Custom Skill

## Context
When to use this skill

## Framework
Step-by-step methodology

## Output Format
What the skill delivers

## Examples
Real usage examples
EOF

Skill Development Best Practices

1. Clear triggers: Use natural language phrases users would actually say
2. Execution modes: Support quick/standard/deep for flexibility
3. Structured output: Define clear deliverable format
4. Real examples: Include actual usage examples, not placeholders
5. Self-contained: Skills should work without external dependencies when possible

Troubleshooting

Skills Not Loading

Claude Code:

# Verify installation path
ls -la ~/.claude/skills/

# Check permissions
chmod -R 755 ~/.claude/skills/

# Restart Claude Code

OpenClaw:

# Check if SKILL-OC.md exists (preferred) or SKILL.md (fallback)
ls -la ~/.openclaw/skills/*/SKILL*.md

# Verify OpenClaw config
cat ~/.openclaw/config.json

Skill Not Triggering

1. Use exact trigger phrases from the skill's frontmatter
2. Try direct invocation: "Use the [skill-name] skill"
3. Specify mode: "Quick [skill-name]" or "Deep [skill-name]"

API-Dependent Skills Failing

# Check environment variables
echo $REDDIT_API_KEY
echo $SERP_API_KEY

# Reload environment
source ~/.bashrc  # or ~/.zshrc

# Test API access
curl -H "Authorization: Bearer $REDDIT_API_KEY" https://oauth.reddit.com/api/v1/me

Conversion Script Issues

# Make script executable
chmod +x scripts/convert.sh
chmod +x scripts/install.sh
chmod +x scripts/list-skills.sh

# Run with verbose output
bash -x scripts/install.sh

# Check script dependencies
which jq  # Required for some conversions

Platform Detection Fails

# Manually specify platform
bash scripts/install.sh --platform=cursor

# Check if platform directories exist
ls -la ~/.claude/
ls -la ~/.openclaw/
ls -la ./.cursor/

Premium Skills

Premium skills include structured reasoning phases, self-critique loops, and advanced frameworks.

Available on Gumroad: https://brianrwagner.gumroad.com

After purchase, extract to pro/ directory and use --include-pro flag:

# Unzip purchased skills
unzip ai-marketing-pro-skills.zip -d ./pro/

# Install with premium skills
bash scripts/install.sh --include-pro

Real-World Examples

Example 1: Launch Positioning

You: "I'm launching a new AI tool for marketers. Help me with positioning."

Claude (using positioning-basics in standard mode):
1. Who is this for? (ICP definition)
2. What do you do? (Core offering)
3. Why are you different? (Unique positioning)
4. What's the category? (Market context)
5. What's the promise? (Value proposition)

→ Delivers: Structured positioning framework document

Example 2: LinkedIn Content System

You: "Build me a LinkedIn content system for SaaS founders"

Claude (using linkedin-authority-builder):
→ Positioning audit
→ 3-5 content pillars
→ Content formats (frameworks, stories, hot takes)
→ Posting rhythm (3-5x/week)
→ 30-day content calendar

Then use content-idea-generator:
→ 30 specific post ideas across pillars

Then use voice-extractor (on your existing writing):
→ Voice guide for AI-assisted writing

Example 3: Competitive Research

You: "Research what people are saying about Notion vs ClickUp in the last 30 days"

Claude (using last30days):
→ Searches Reddit, X, web
→ Aggregates sentiment and themes
→ Identifies switching triggers
→ Highlights feature gaps

Then use competitor-intel-brief (premium):
→ Structured competitive analysis
→ Feature comparison matrix
→ Positioning gaps
→ Opportunity areas

Contributing

To contribute new skills or improvements:

1. Fork the repository
2. Create a new skill directory following the structure
3. Include both SKILL.md (full) and SKILL-OC.md (condensed)
4. Add README.md for human readers
5. Submit pull request

See existing skills for examples.

Project Structure

ai-marketing-claude-code-skills/
├── scripts/
│   ├── install.sh          # Auto-install to detected platforms
│   ├── convert.sh          # Convert to platform formats
│   └── list-skills.sh      # List all available skills
├── positioning-basics/
│   ├── SKILL.md           # Claude Code version
│   ├── SKILL-OC.md        # OpenClaw version
│   └── README.md          # Documentation
├── ai-discoverability-audit/
│   ├── SKILL.md
│   ├── SKILL-OC.md
│   └── README.md
├── [23 free skills total]
├── pro/                    # Premium skills (not included)
│   ├── founder-intelligence/
│   ├── competitor-intel-brief/
│   └── [10 premium skills]
└── README.md              # This file

License

MIT License - Free skills are open source. Premium skills are licensed per purchase.

Additional Resources

• Documentation: https://www.brianrwagner.com/
• Twitter: @BrianRWagner
• LinkedIn: Brian Wagner
• Premium Skills: https://brianrwagner.gumroad.com
• Agent Skills Standard: https://agentskills.ai