seo-content-marketing-claude-skill-suite

Q: How do I install seo-content-marketing-claude-skill-suite?

Run npx skills add https://github.com/reason-machines/marketing-skills --skill seo-content-marketing-claude-skill-suite in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/seo-content-marketing-claude-skill-suite/ (personal) or .claude/skills/seo-content-marketing-claude-skill-suite/ (project).

by reason-machinesMarketing & SEO

SEO & content marketing command suite for keyword research, content audits, technical SEO, and SERP analysis

Installs: 983
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/reason-machines/marketing-skills --skill seo-content-marketing-claude-skill-suite

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads seo-content-marketing-claude-skill-suite automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

SEO & Content Marketing Skills Suite

Skill by ara.so — Marketing Skills collection.

This skill suite provides 10 specialized SEO and content marketing commands with structured output, progress tracking, and actionable recommendations. Derived from shanraisshan/claude-code-best-practice for marketing and SEO workflows.

What This Skill Does

Keyword Research: Deep keyword clustering, opportunity scoring, SERP intent mapping
Content Audits: Quality scoring, duplication detection, cannibalization reports
Technical SEO: Crawl budget, Core Web Vitals, schema markup, indexability audits
Competitor Analysis: Backlink gaps, topic gaps, featured snippet opportunities
Content Strategy: Brief generation, editorial calendars, refresh workflows
SERP Monitoring: Rank tracking, volatility alerts, CTR optimization
Link Building: Prospect identification, outreach templates, DA/DR filtering
Local SEO: NAP consistency, Google Business Profile optimization
Performance: Page speed diagnosis mapped to ranking impact

Installation

Option 1: Clone to Claude Skills Directory

# Clone the repository
git clone https://github.com/MagicStarfishBoost/r15-shanraisshan-claude-code-best-practice-seo.git

# Copy to Claude skills directory
cp -r r15-shanraisshan-claude-code-best-practice-seo ~/.claude/skills/seo-content-marketing/

# Register in Claude Code session
/read ~/.claude/skills/seo-content-marketing/SKILL.md

Option 2: Direct Integration

# In your project directory
curl -L https://github.com/MagicStarfishBoost/r15-shanraisshan-claude-code-best-practice-seo/archive/main.zip -o seo-skills.zip
unzip seo-skills.zip

Core Commands

`/keyword-research`

Performs comprehensive keyword analysis with clustering and intent mapping.

Usage:

/keyword-research "e-commerce platform" --depth full
/keyword-research <target-keyword> --scope [quick|full] --output [json|md|csv]

Options:

--depth quick - Top 50 keywords only (default)
--depth full - Complete analysis with clustering
--include-competitors - Add competitor keyword overlap
--output json - Export as JSON

Output Structure:

┌────────────────────────────────────────────────────────┐
│ Keyword Research: "e-commerce platform"                │
├────────────────────────────────────────────────────────┤
│ Total Keywords Analyzed: 1,247                         │
│ Primary Clusters: 8                                     │
│ Opportunity Score: 73/100                              │
└────────────────────────────────────────────────────────┘

Top Opportunities:
┌─────────────────────────────┬────────┬──────┬─────────┬──────┐
│ Keyword                     │ Vol    │ KD   │ Intent  │ Score│
├─────────────────────────────┼────────┼──────┼─────────┼──────┤
│ best e-commerce platform    │ 12,100 │ 45   │ Info    │ 8.2  │
│ e-commerce platform pricing │  3,600 │ 32   │ Comm    │ 7.8  │
│ small business ecommerce    │  8,900 │ 38   │ Comm    │ 7.5  │
└─────────────────────────────┴────────┴──────┴─────────┴──────┘

`/content-audit`

Full-site content quality analysis with duplication and cannibalization detection.

Usage:

/content-audit --url https://example.com --scope full
/content-audit --scope [quick|full|target] --url <site-url>

Options:

--scope quick - Homepage and top 20 pages
--scope full - Entire site crawl
--scope target - Specific URL list
--check-cannibalization - Keyword overlap analysis
--export-csv - Export findings

Output:

Content Audit Progress:
[████████████████████░░] 90% (451/502 pages)

Critical Issues (🔴):
• 23 pages with duplicate title tags
• 12 pages with thin content (<300 words)
• 8 keyword cannibalization conflicts

Warnings (🟠):
• 67 pages missing meta descriptions
• 34 pages with low readability score (<40)

Quick Wins (🟢):
• 145 pages ready for schema markup
• 89 pages eligible for internal linking

`/technical-seo`

Technical SEO audit covering crawlability, performance, and indexability.

Usage:

/technical-seo --url https://example.com
/technical-seo --url <site-url> --checks [all|core-web-vitals|indexability|schema]

Checks:

Core Web Vitals (LCP, FID, CLS)
Crawl budget analysis
XML sitemap validation
Robots.txt audit
Schema markup coverage
Mobile usability
HTTPS/security

Example:

/technical-seo --url https://mystore.com --checks all --format report

`/competitor-gap`

Competitor content and backlink gap analysis.

Usage:

/competitor-gap --your-site https://example.com --competitors site1.com,site2.com

Analysis Includes:

Keyword gaps (keywords competitors rank for)
Content gaps (topics/pages missing)
Backlink gaps (referring domains)
Featured snippet opportunities
SERP feature opportunities

Output:

Competitor Gap Analysis:

Keyword Opportunities: 347 keywords where competitors rank but you don't
Top Priority Keywords:
• "project management software comparison" (Vol: 8.1K, KD: 42)
• "best pm tools for teams" (Vol: 5.4K, KD: 38)

Content Gaps: 23 high-value content pieces
• Ultimate Guide to Remote Team Management (competitor1.com)
• PM Tool Integration Tutorial (competitor2.com)

Backlink Gap: 156 high-quality domains
• techcrunch.com (DR: 93) - links to competitor1
• productmanagement.com (DR: 78) - links to competitor2

`/content-brief`

Generate SEO-optimized content briefs with outlines and NLP terms.

Usage:

/content-brief "how to start a podcast" --target-keyword "podcast setup"
/content-brief <topic> --target-keyword <primary-kw> --serp-analysis

Generated Brief Includes:

Target word count
H2/H3 outline structure
Primary and secondary keywords
NLP/LSI terms from top 10 SERP
Competitor content analysis
Internal linking opportunities
Image/media recommendations

Example Output:

# Content Brief: "How to Start a Podcast"

**Primary Keyword**: podcast setup
**Target Word Count**: 2,400-2,800 words
**Search Intent**: Informational (How-to)
**Current SERP Difficulty**: 42/100

## Recommended Outline

### Introduction (200 words)
- Hook: podcasting growth statistics
- Promise: complete setup guide

### H2: Equipment Needed for Podcasting (600 words)
#### H3: Microphones for Beginners
#### H3: Recording Software Options
#### H3: Headphones and Accessories

### H2: Choosing Your Podcast Format (400 words)
...

## NLP Terms to Include (Top 20)
microphone, audio quality, podcast hosting, RSS feed, episode format,
recording software, editing, intro music, show notes, distribution...

## Competitor Analysis
- competitor1.com: 3,200 words, 8 images, video embed
- competitor2.com: 2,100 words, comparison table, checklist

`/serp-monitor`

Daily rank tracking with volatility alerts.

Usage:

/serp-monitor --keywords keywords.csv --url https://example.com
/serp-monitor --add-keyword "new keyword" --location "United States"

Features:

Position tracking (desktop/mobile)
SERP feature monitoring (featured snippets, PAA, etc.)
Volatility alerts
CTR optimization suggestions
Competitor position changes

`/link-prospecting`

Identify high-quality backlink opportunities.

Usage:

/link-prospecting --niche "marketing software" --min-da 40
/link-prospecting --niche <topic> --min-da <number> --strategy [guest-post|resource-page|broken-link]

Strategies:

Guest post opportunities
Resource page links
Broken link building
Unlinked mentions
Competitor backlink replication

Output:

Link Prospecting: "marketing software"

Found 127 opportunities:

High Priority (DA 60+):
┌────────────────────────────┬─────┬──────────┬─────────────┐
│ Domain                     │ DA  │ Strategy │ Contact     │
├────────────────────────────┼─────┼──────────┼─────────────┤
│ marketingprofs.com         │ 82  │ Guest    │ editor@...  │
│ contentmarketinginst.com   │ 78  │ Resource │ contact@... │
└────────────────────────────┴─────┴──────────┴─────────────┘

Outreach Template:
Subject: Contribution idea: [Personalized topic]
...

`/page-speed-seo`

Page speed analysis mapped to SEO/ranking impact.

Usage:

/page-speed-seo --url https://example.com/page
/page-speed-seo --url <page-url> --device [mobile|desktop]

Metrics:

Largest Contentful Paint (LCP)
First Input Delay (FID)
Cumulative Layout Shift (CLS)
Render-blocking resources
Image optimization opportunities
Ranking impact estimation

`/local-seo`

Local SEO audit for Google Business Profile and citations.

Usage:

/local-seo --business-name "Joe's Coffee" --location "Seattle, WA"

Checks:

NAP (Name, Address, Phone) consistency
Google Business Profile optimization
Local citation audit
Review management
Local keyword rankings
Competitor local analysis

`/content-calendar`

Data-driven editorial calendar from search demand and seasonality.

Usage:

/content-calendar --keywords keywords.csv --months 6
/content-calendar --niche "gardening" --frequency weekly --months 3

Features:

Search volume seasonality
Content type mix (how-to, listicle, comparison)
Keyword clustering by topic
Publishing frequency recommendations
Content refresh reminders

Multi-Step Workflows

`full-seo-sprint`

Complete 12-step SEO audit and implementation plan.

Usage:

/workflow full-seo-sprint --url https://example.com --scope comprehensive

Steps:

Technical SEO audit
Content inventory
Keyword research
Competitor analysis
On-page optimization plan
Content gap identification
Internal linking strategy
Backlink analysis
Local SEO (if applicable)
Schema markup plan
Performance optimization
Implementation roadmap

`launch-seo`

Pre-launch SEO checklist and validation.

Usage:

/workflow launch-seo --url https://staging.example.com

Validates:

Canonical tags
Hreflang (if multi-language)
XML sitemap
Robots.txt
Meta tags
Schema markup
Mobile responsiveness
Core Web Vitals
Analytics/tracking setup

`content-refresh`

Identify and refresh underperforming content.

Usage:

/workflow content-refresh --url https://example.com --min-age 12months

Process:

Identify declining pages (traffic/rankings down)
Content quality assessment
Keyword opportunity check
Competitor comparison
Refresh recommendations
Implementation checklist

`authority-building`

End-to-end link building campaign.

Usage:

/workflow authority-building --niche "SaaS" --target-links 50 --duration 90days

Stages:

Competitor backlink analysis
Link prospect identification
Content asset creation plan
Outreach campaign setup
Follow-up automation
Link acquisition tracking

`ai-content-pipeline`

Automated content creation from keyword to publish.

Usage:

/workflow ai-content-pipeline --topic "email marketing best practices"

Pipeline:

Keyword research
Content brief generation
AI draft creation
SEO optimization
Human review checklist
Publishing preparation

Configuration

Environment Variables

# Required for API integrations
export AHREFS_API_KEY=your_ahrefs_key
export SEMRUSH_API_KEY=your_semrush_key
export GSC_CREDENTIALS_PATH=/path/to/google-search-console-creds.json
export GA4_PROPERTY_ID=your_ga4_property_id

# Optional
export SERP_API_KEY=your_serpapi_key
export OPENAI_API_KEY=your_openai_key  # For AI content features

Config File (`.seo-config.yaml`)

default_location: "United States"
default_language: "en"
crawl_delay_ms: 100
max_pages_audit: 5000
output_format: "markdown"  # json, markdown, csv

keyword_research:
  min_volume: 100
  max_difficulty: 70
  include_questions: true

content_audit:
  min_word_count: 300
  check_readability: true
  duplication_threshold: 85

technical_seo:
  core_web_vitals_threshold:
    lcp_ms: 2500
    fid_ms: 100
    cls: 0.1

Common Patterns

Pattern 1: New Site SEO Setup

# Step 1: Technical foundation
/technical-seo --url https://newsite.com --checks all

# Step 2: Keyword research for content plan
/keyword-research "main topic" --depth full --output csv

# Step 3: Generate content calendar
/content-calendar --keywords keywords.csv --months 6

# Step 4: Pre-launch validation
/workflow launch-seo --url https://newsite.com

Pattern 2: Existing Site Optimization

# Step 1: Full audit
/workflow full-seo-sprint --url https://example.com --scope comprehensive

# Step 2: Identify quick wins
/content-audit --url https://example.com --scope full

# Step 3: Find content refresh opportunities
/workflow content-refresh --url https://example.com --min-age 6months

# Step 4: Competitor gap analysis
/competitor-gap --your-site https://example.com --competitors competitor1.com,competitor2.com

Pattern 3: Content Marketing Campaign

# Step 1: Research topic opportunities
/keyword-research "topic area" --depth full --include-competitors

# Step 2: Generate content briefs for top keywords
/content-brief "top keyword 1" --serp-analysis
/content-brief "top keyword 2" --serp-analysis

# Step 3: Build editorial calendar
/content-calendar --niche "topic area" --frequency weekly --months 3

# Step 4: Link building plan
/link-prospecting --niche "topic area" --min-da 40 --strategy guest-post

Pattern 4: Rank Recovery

# Step 1: Identify declined pages
/serp-monitor --url https://example.com --period 90days

# Step 2: Content quality check
/content-audit --scope target --urls declined-pages.csv

# Step 3: Competitor SERP analysis
/competitor-gap --your-site https://example.com --competitors <top-3-competitors>

# Step 4: Technical issues check
/technical-seo --url https://example.com --checks indexability

Interaction Pattern

All commands follow a 5-step structure:

Scope Confirmation - Verify target and options with user
Live Analysis - Progress bar while working
Findings Table - Structured results sorted by impact
Action Plan - Prioritized, time-boxed recommendations
Next Steps - Suggested follow-up commands

Progress Display:

╔══════════════════════════════════════════════════╗
║  SEO Audit  —  domain.com                        ║
╠══════════════════════════════════════════════════╣
║  Crawling pages …      [████████░░]  80%  1204/1505  ║
║  Checking backlinks …  [███░░░░░░░]  30%   943/3147  ║
║  Scoring content …     [██████████] 100%    Done ✓   ║
╚══════════════════════════════════════════════════╝

Troubleshooting

Issue: API Rate Limits

# Check current rate limit status
/check-api-limits

# Adjust crawl delay in config
export CRAWL_DELAY_MS=500  # Increase delay between requests

Issue: Large Site Audits Timeout

# Use batched approach
/content-audit --url https://example.com --batch-size 500 --resume

# Or reduce scope
/content-audit --url https://example.com --scope quick

Issue: Missing Dependencies

# Install required Python packages
pip install ahrefs semrush google-auth-oauthlib pandas beautifulsoup4

# Or use requirements file
pip install -r requirements.txt

Issue: Google Search Console Authentication

# Set up OAuth credentials
export GSC_CREDENTIALS_PATH=/path/to/credentials.json

# Run initial authentication flow
python scripts/authenticate_gsc.py

Issue: Inconsistent Keyword Data

# Use multiple data sources
/keyword-research "keyword" --sources ahrefs,semrush,gsc

# Cross-reference with Google Trends
/keyword-research "keyword" --include-trends

Best Practices

Start with Technical Foundation: Always run /technical-seo before content optimization
Use Workflows for Complex Projects: Multi-step workflows ensure nothing is missed
Export and Track: Use --export-csv or --output json for historical tracking
Batch Similar Commands: Group keyword research or content briefs to save API calls
Schedule Regular Audits: Run /serp-monitor and /content-audit monthly
Combine with Analytics: Cross-reference findings with GA4 and GSC data

Example: Complete SEO Workflow

#!/bin/bash
# Complete SEO optimization workflow

SITE_URL="https://example.com"
NICHE="marketing automation"

# Phase 1: Assessment
echo "Phase 1: Technical and content assessment..."
/technical-seo --url $SITE_URL --checks all --format report > reports/technical-audit.md
/content-audit --url $SITE_URL --scope full --export-csv > reports/content-audit.csv

# Phase 2: Opportunity identification
echo "Phase 2: Finding opportunities..."
/keyword-research "$NICHE" --depth full --output json > data/keywords.json
/competitor-gap --your-site $SITE_URL --competitors competitor1.com,competitor2.com > reports/competitor-gap.md

# Phase 3: Planning
echo "Phase 3: Creating action plan..."
/content-calendar --keywords data/keywords.json --months 6 > plans/content-calendar.md
/link-prospecting --niche "$NICHE" --min-da 50 > plans/link-building.md

# Phase 4: Implementation tracking
echo "Phase 4: Setting up monitoring..."
/serp-monitor --keywords data/keywords.json --url $SITE_URL

echo "SEO workflow complete. Check reports/ and plans/ directories."

Additional Resources

Source Repository
Parent Project
API Documentation: Run /help <command> for detailed options
Community: Open issues for bugs or feature requests

License

MIT License - Free to use, modify, and distribute.

FAQ

What does the seo-content-marketing-claude-skill-suite skill do?

SEO & content marketing command suite for keyword research, content audits, technical SEO, and SERP analysis

How do I install seo-content-marketing-claude-skill-suite?

Run npx skills add https://github.com/reason-machines/marketing-skills --skill seo-content-marketing-claude-skill-suite in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/seo-content-marketing-claude-skill-suite/ (personal) or .claude/skills/seo-content-marketing-claude-skill-suite/ (project).

Which AI agents can use seo-content-marketing-claude-skill-suite?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is seo-content-marketing-claude-skill-suite safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains seo-content-marketing-claude-skill-suite?

It is published by reason-machines in reason-machines/marketing-skills. It has 983 recorded installs.

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Marketing & SEO453.7K installs

seo-content-marketing-claude-skill-suite

Install

Install

Describe the task

Review the result

SKILL.md

SEO & Content Marketing Skills Suite

What This Skill Does

Installation

Option 1: Clone to Claude Skills Directory

Option 2: Direct Integration

Core Commands

/keyword-research

/content-audit

/technical-seo

/competitor-gap

/content-brief

/serp-monitor

/link-prospecting

/page-speed-seo

/local-seo

/content-calendar

Multi-Step Workflows

full-seo-sprint

launch-seo

content-refresh

authority-building

ai-content-pipeline

Configuration

Environment Variables

Config File (.seo-config.yaml)

Common Patterns

Pattern 1: New Site SEO Setup

Pattern 2: Existing Site Optimization

Pattern 3: Content Marketing Campaign

Pattern 4: Rank Recovery

Interaction Pattern

Troubleshooting

Issue: API Rate Limits

Issue: Large Site Audits Timeout

Issue: Missing Dependencies

Issue: Google Search Console Authentication

Issue: Inconsistent Keyword Data

Best Practices

Example: Complete SEO Workflow

Additional Resources

License

FAQ

More from reason-machines/marketing-skills

Popular marketing & seo skills

`/keyword-research`

`/content-audit`

`/technical-seo`

`/competitor-gap`

`/content-brief`

`/serp-monitor`

`/link-prospecting`

`/page-speed-seo`

`/local-seo`

`/content-calendar`

`full-seo-sprint`

`launch-seo`

`content-refresh`

`authority-building`

`ai-content-pipeline`

Config File (`.seo-config.yaml`)