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

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:

Technical SEO audit
Content inventory and quality analysis
Keyword research and clustering
Competitor gap analysis
On-page optimization priorities
Internal linking structure analysis
Core Web Vitals optimization
Schema markup implementation
Mobile usability check
Backlink profile audit
Content creation roadmap
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:

Identify pages with declining traffic
Analyze ranking position changes
Check for content freshness signals
Review competitor updates
Generate refresh recommendations
Create updated content briefs
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:

Define link-worthy assets
Identify target publications
Create outreach prospect list
Generate personalized templates
Track outreach campaigns
Monitor link acquisition
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:

Keyword research and prioritization
Content brief generation
AI-assisted draft creation
SEO optimization (NLP, structure)
Internal linking integration
Quality review checklist
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

Start with full-seo-sprint workflow for new projects to establish baseline
Use structured output formats (JSON/CSV) for automation and reporting
Set API keys via environment variables to enable third-party data enrichment
Schedule regular monitoring with /serp-monitor for ongoing performance tracking
Combine commands in sequences for comprehensive analysis (technical → content → keywords)
Export findings to files for long-term tracking and comparison
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

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

About