r01-hesreallyhim-awesome-claude-code-seo-content-marketing

Skill by ara.so — Marketing Skills collection.

Overview

This skill suite provides 10 specialized SEO and content marketing commands plus 5 multi-step workflows for comprehensive website optimization, keyword research, content strategy, and technical SEO audits. All commands use structured output with progress tracking, findings tables, and prioritized action plans.

Key capabilities:

• Keyword clustering and SERP intent analysis
• Full-site content audits with cannibalization detection
• Technical SEO crawls (Core Web Vitals, schema, indexability)
• Competitor gap analysis (backlinks, topics, snippets)
• AI-powered content brief generation
• Rank tracking with volatility monitoring
• Link prospecting and outreach automation
• Local SEO NAP consistency checks
• Data-driven editorial calendar creation

Installation

# Clone the skill suite to Claude's skills directory
mkdir -p ~/.claude/skills
cp -r . ~/.claude/skills/r01-hesreallyhim-awesome-claude-code-seo/

# Register in Claude Code session
/read ~/.claude/skills/r01-hesreallyhim-awesome-claude-code-seo/SKILL.md

No external dependencies required — all commands are native to the skill suite.

Core Commands

/keyword-research <target>

Performs deep keyword clustering with SERP intent mapping and opportunity scoring.

Options:

• --seed <keywords> — Comma-separated seed keywords
• --volume-min <number> — Minimum monthly search volume (default: 10)
• --difficulty-max <number> — Maximum keyword difficulty 0-100 (default: 70)
• --intent <commercial|informational|navigational|transactional> — Filter by intent
• --output <json|md|csv> — Output format (default: md)

Example:

/keyword-research "project management software" --volume-min 100 --difficulty-max 50 --intent commercial

Output structure:

┌────────────────────────────┬────────┬────────┬──────────────┬──────────┐
│ Keyword                    │ Volume │ Diff   │ Intent       │ Priority │
├────────────────────────────┼────────┼────────┼──────────────┼──────────┤
│ project management tools   │ 18,100 │ 42     │ Commercial   │ 🔴 High  │
│ best pm software           │  8,900 │ 38     │ Commercial   │ 🔴 High  │
│ project tracking software  │  5,400 │ 45     │ Commercial   │ 🟠 Med   │
│ team collaboration tools   │  4,200 │ 51     │ Informational│ 🟡 Low   │
└────────────────────────────┴────────┴────────┴──────────────┴──────────┘

/content-audit

Analyzes site content quality, identifies duplication, and detects keyword cannibalization.

Options:

• --scope <full|sample|urls> — Audit scope (default: sample)
• --urls <file> — Path to URL list file
• --sample-size <number> — Number of pages to sample (default: 100)
• --min-quality <number> — Minimum quality score 0-100 (default: 60)
• --output <json|md|csv> — Output format

Example:

/content-audit --scope full --min-quality 70 --output md

Output includes:

• Content quality scores per page
• Duplicate/thin content identification
• Keyword cannibalization clusters
• Missing metadata (title, description, H1)
• Actionable prioritized fixes

/technical-seo

Comprehensive technical SEO audit covering crawl budget, Core Web Vitals, schema markup, and indexability.

Options:

• --domain <url> — Target domain
• --depth <number> — Crawl depth (default: 3)
• --check-vitals — Include Core Web Vitals analysis
• --check-schema — Validate structured data
• --check-mobile — Mobile-friendliness check
• --output <json|md> — Output format

Example:

/technical-seo --domain https://example.com --check-vitals --check-schema --depth 5

Checks performed:

• Robots.txt and XML sitemap validation
• Canonical tag implementation
• Hreflang configuration (multi-language sites)
• Schema.org markup validation
• Core Web Vitals (LCP, FID, CLS)
• Mobile usability
• HTTPS implementation
• Crawl errors and redirect chains

/competitor-gap <domain> <competitors>

Identifies content and backlink opportunities by analyzing competitor gap.

Options:

• --competitors <urls> — Comma-separated competitor URLs
• --gap-type <backlink|topic|snippet> — Analysis type (default: all)
• --min-authority <number> — Minimum domain authority (default: 30)
• --output <json|md> — Output format

Example:

/competitor-gap example.com --competitors competitor1.com,competitor2.com --gap-type topic

Outputs:

• Keywords competitors rank for (you don't)
• Backlink sources pointing to competitors
• Featured snippet opportunities
• Topic clusters to develop

/content-brief <keyword>

Generates AI-powered SEO content briefs with outlines, NLP terms, and word count targets.

Options:

• --keyword <phrase> — Target keyword
• --intent <commercial|informational|transactional> — Search intent
• --competitors <number> — Number of top-ranking pages to analyze (default: 10)
• --output <json|md> — Output format

Example:

/content-brief "how to optimize page speed" --intent informational --competitors 15

Brief includes:

• Recommended word count range
• Content outline (H2/H3 structure)
• NLP/LSI terms to include
• Questions to answer (People Also Ask)
• Internal linking suggestions
• Meta title and description templates

/serp-monitor <keywords>

Daily rank tracking with volatility alerts and CTR optimization recommendations.

Options:

• --keywords <file> — Path to keyword list file
• --frequency <daily|weekly> — Monitoring frequency
• --alert-threshold <number> — Position change threshold for alerts (default: 3)
• --locations <geo> — Comma-separated geo targets (default: US)
• --output <json|md> — Output format

Example:

/serp-monitor --keywords keywords.txt --frequency daily --alert-threshold 5 --locations "US,UK,CA"

Tracking metrics:

• Current position vs. previous period
• Position volatility score
• Estimated CTR by position
• SERP feature presence (snippets, images, videos)
• Competitor movement

/link-prospecting <topic>

Generates quality backlink prospect lists with DA/DR filters and outreach templates.

Options:

• --topic <phrase> — Target topic or niche
• --min-authority <number> — Minimum domain authority (default: 30)
• --link-type <guest-post|resource|broken|unlinked> — Prospecting method
• --output <json|md|csv> — Output format

Example:

/link-prospecting "content marketing" --min-authority 40 --link-type guest-post --output csv

Output includes:

• Domain authority/rating
• Relevant contact pages
• Email addresses (if found)
• Outreach email templates
• Link insertion opportunities

/page-speed-seo <url>

Diagnoses render-blocking resources, LCP, CLS, FID issues mapped to ranking impact.

Options:

• --url <address> — Target page URL
• --device <mobile|desktop|both> — Device type (default: both)
• --output <json|md> — Output format

Example:

/page-speed-seo https://example.com/page --device mobile

Analysis includes:

• Core Web Vitals scores
• Render-blocking resources
• Image optimization opportunities
• JavaScript/CSS optimization
• Server response time
• Caching recommendations
• Ranking impact estimation

/local-seo <business>

NAP consistency check, Google Business Profile optimization, and local citation audit.

Options:

• --business-name <name> — Business name
• --location <city,state> — Business location
• --check-citations — Audit citation consistency
• --check-gbp — Google Business Profile optimization
• --output <json|md> — Output format

Example:

/local-seo --business-name "Acme Coffee" --location "Seattle,WA" --check-citations --check-gbp

Checks:

• NAP (Name, Address, Phone) consistency across directories
• Google Business Profile completeness
• Local citation quality and quantity
• Review management recommendations
• Local keyword rankings
• Schema LocalBusiness markup

/content-calendar <duration>

Creates data-driven editorial calendar from search demand and seasonality patterns.

Options:

• --duration <months> — Calendar duration in months (default: 3)
• --topics <keywords> — Comma-separated topic seeds
• --frequency <daily|weekly|biweekly> — Publishing frequency
• --include-seasonality — Factor in seasonal trends
• --output <json|md|csv> — Output format

Example:

/content-calendar --duration 6 --topics "seo,content marketing,link building" --frequency weekly --include-seasonality --output csv

Calendar includes:

• Publication dates
• Topic/keyword assignments
• Search volume trends
• Seasonal opportunities
• Content format recommendations
• Internal linking strategy

Workflows (Multi-step Automation)

full-seo-sprint <domain>

12-step comprehensive SEO audit and optimization workflow.

Steps:

1. Technical SEO audit
2. Content inventory and quality analysis
3. Keyword research and clustering
4. Competitor gap analysis
5. On-page optimization priorities
6. Internal linking structure analysis
7. Core Web Vitals optimization
8. Schema markup implementation
9. Mobile usability check
10. Backlink profile audit
11. Content creation roadmap
12. Performance tracking setup

Example:

/workflows:full-seo-sprint example.com --scope full

launch-seo <domain>

Pre-launch SEO checklist with technical validation.

Validates:

• Canonical tags
• Hreflang implementation
• XML sitemap
• Robots.txt configuration
• Meta robots tags
• 404 error handling
• Redirect chains
• HTTPS configuration
• Mobile responsiveness
• Core Web Vitals baseline

Example:

/workflows:launch-seo newsite.com --output md

content-refresh <domain>

Identifies and refreshes underperforming content to recover rankings.

Process:

1. Identify pages with declining traffic
2. Analyze ranking position changes
3. Check for content freshness signals
4. Review competitor updates
5. Generate refresh recommendations
6. Create updated content briefs
7. Track post-refresh performance

Example:

/workflows:content-refresh example.com --threshold 30 --lookback 90

authority-building <domain>

End-to-end digital PR and link-building campaign workflow.

Campaign steps:

1. Define link-worthy assets
2. Identify target publications
3. Create outreach prospect list
4. Generate personalized templates
5. Track outreach campaigns
6. Monitor link acquisition
7. Measure authority growth

Example:

/workflows:authority-building example.com --campaign-duration 90 --target-links 50

ai-content-pipeline <keywords>

Automated keyword → brief → draft → optimize → publish pipeline.

Pipeline stages:

1. Keyword research and prioritization
2. Content brief generation
3. AI-assisted draft creation
4. SEO optimization (NLP, structure)
5. Internal linking integration
6. Quality review checklist
7. Publishing and indexing

Example:

/workflows:ai-content-pipeline --keywords keywords.txt --output-dir ./content --auto-publish false

Configuration

All commands support configuration via environment variables or a .seorc file in the project root.

Environment variables:

# API keys (if integrations are enabled)
export SERP_API_KEY=your_key_here
export AHREFS_API_TOKEN=your_token_here
export SEMRUSH_API_KEY=your_key_here

# Default settings
export SEO_DEFAULT_SCOPE=full
export SEO_OUTPUT_FORMAT=md
export SEO_PROGRESS_BAR=true

.seorc configuration file:

{
  "defaults": {
    "output_format": "md",
    "show_progress": true,
    "scope": "full"
  },
  "keyword_research": {
    "volume_min": 50,
    "difficulty_max": 60,
    "default_intent": "commercial"
  },
  "content_audit": {
    "sample_size": 100,
    "min_quality_score": 70
  },
  "technical_seo": {
    "crawl_depth": 5,
    "check_vitals": true,
    "check_schema": true
  },
  "integrations": {
    "serp_api": "${SERP_API_KEY}",
    "ahrefs": "${AHREFS_API_TOKEN}",
    "semrush": "${SEMRUSH_API_KEY}"
  }
}

Common Usage Patterns

Complete site SEO audit

# Run full technical audit
/technical-seo --domain https://example.com --check-vitals --check-schema --depth 5 --output md

# Analyze all content
/content-audit --scope full --min-quality 60 --output csv

# Research keyword opportunities
/keyword-research "target niche" --volume-min 100 --difficulty-max 50 --output json

# Check competitor gaps
/competitor-gap example.com --competitors competitor1.com,competitor2.com --gap-type all

Content creation workflow

# Research keywords
/keyword-research "topic" --volume-min 200 --intent informational

# Generate content brief
/content-brief "selected keyword" --competitors 15 --output md

# Create editorial calendar
/content-calendar --duration 3 --topics "keyword cluster" --frequency weekly --include-seasonality

Link building campaign

# Find link prospects
/link-prospecting "niche topic" --min-authority 35 --link-type guest-post --output csv

# Analyze backlink gaps
/competitor-gap example.com --competitors top-competitor.com --gap-type backlink

# Run authority building workflow
/workflows:authority-building example.com --target-links 30 --campaign-duration 60

Performance monitoring

# Set up rank tracking
/serp-monitor --keywords keywords.txt --frequency daily --alert-threshold 3

# Monitor page speed
/page-speed-seo https://example.com/page --device both --output md

# Track Core Web Vitals
/technical-seo --domain https://example.com --check-vitals --output json

Output Formats

All commands support multiple output formats via --output:

Markdown (default):

/keyword-research "seo tools" --output md > report.md

JSON for programmatic use:

/content-audit --scope full --output json > audit.json

CSV for spreadsheet import:

/link-prospecting "marketing" --output csv > prospects.csv

Troubleshooting

Command not recognized

Ensure the skill is registered in your Claude Code session:

/read ~/.claude/skills/r01-hesreallyhim-awesome-claude-code-seo/SKILL.md

Missing API integration data

Some commands provide richer data when integrated with third-party APIs (Ahrefs, SEMrush, SERP APIs). Set environment variables or use the built-in estimation mode:

export AHREFS_API_TOKEN=your_token_here
# Or use --mode estimate for commands that support it
/competitor-gap example.com --mode estimate

Large site crawl timeout

For sites with thousands of pages, use sampling or limit crawl depth:

/technical-seo --domain large-site.com --depth 3 --sample-size 500

Output formatting issues

Specify output format explicitly and redirect to file:

/content-audit --scope full --output md > audit_report.md

Best Practices

1. Start with full-seo-sprint workflow for new projects to establish baseline
2. Use structured output formats (JSON/CSV) for automation and reporting
3. Set API keys via environment variables to enable third-party data enrichment
4. Schedule regular monitoring with /serp-monitor for ongoing performance tracking
5. Combine commands in sequences for comprehensive analysis (technical → content → keywords)
6. Export findings to files for long-term tracking and comparison
7. Use workflows for repeatable multi-step processes instead of running individual commands

Integration with Development Workflow

These commands integrate seamlessly into CI/CD and development workflows:

# Pre-deployment SEO check
/workflows:launch-seo staging.example.com --output json > seo-check.json

# Automated content quality gate
/content-audit --scope sample --min-quality 80 --output json || exit 1

# Performance regression detection
/page-speed-seo https://staging.example.com --device mobile --output json > vitals.json