# Clone or copy the skill suite
git clone https://github.com/retrocenterspark24/r11-qdhenry-claude-command-suite-seo.git

# Install to Claude skills directory
mkdir -p ~/.claude/skills
cp -r r11-qdhenry-claude-command-suite-seo ~/.claude/skills/seo-content-marketing/

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

/keyword-research <target_keyword>

/keyword-research "project management software"

╔══════════════════════════════════════════════════╗
║  Keyword Research  —  "project management software"  ║
╠══════════════════════════════════════════════════╣
║  Collecting seed keywords …  [██████████] 100%    ║
║  Clustering by intent …      [██████████] 100%    ║
║  Scoring opportunities …     [██████████] 100%    ║
╚══════════════════════════════════════════════════╝

┌─────────────────────────┬────────┬─────┬────────┬─────────┐
│ Keyword                 │ Volume │ KD  │ Intent │ Score   │
├─────────────────────────┼────────┼─────┼────────┼─────────┤
│ best project mgmt tools │ 12,400 │  42 │ Comm.  │  🟢 87  │
│ pm software for teams   │  8,900 │  38 │ Comm.  │  🟢 82  │
│ project tracking app    │  6,700 │  51 │ Comm.  │  🟡 68  │
│ how to manage projects  │ 22,100 │  29 │ Info.  │  🟡 71  │
└─────────────────────────┴────────┴─────┴────────┴─────────┘

/content-audit --scope <scope> --output <format>

/content-audit --scope full --output md

// Example: Automated content audit script
const runAudit = async (domain) => {
  const results = await executeCommand('/content-audit', {
    scope: 'full',
    output: 'json',
    domain: domain
  });
  
  // Filter critical issues
  const critical = results.findings.filter(f => f.severity === 'critical');
  
  // Generate report
  return {
    total_pages: results.stats.total,
    issues: critical.length,
    quality_score: results.stats.avg_quality_score,
    duplicates: results.duplication.count,
    cannibalization: results.cannibalization.affected_keywords
  };
};

/technical-seo <domain>

/technical-seo example.com

/competitor-gap --competitors <domains> --type <analysis_type>

/competitor-gap --competitors "competitor1.com,competitor2.com" --type backlink

/content-brief <target_keyword>

/content-brief "email marketing best practices"

# Content Brief: "email marketing best practices"

## Target Metrics
- Primary Keyword: email marketing best practices
- Search Volume: 8,100/month
- Keyword Difficulty: 45
- Target Word Count: 2,400–2,800
- Estimated Time: 6–8 hours

## Search Intent
Commercial Investigation (70%), Informational (30%)

## Recommended Outline
1. Introduction (200 words)
2. What Makes Effective Email Marketing (400 words)
   - Segmentation strategies
   - Personalization tactics
3. 15 Email Marketing Best Practices (1,800 words)
   - Subject line optimization
   - Mobile responsiveness
   - A/B testing
   [...]

## NLP Terms to Include
- email open rate
- click-through rate
- subscriber engagement
- deliverability
[...]

## Competitor Analysis
Top 5 ranking pages analyzed:
- hubspot.com/blog/email-marketing-best-practices (2,850 words, DA: 93)
- mailchimp.com/resources/email-marketing (1,920 words, DA: 92)
[...]

/serp-monitor --keywords <keyword_list> --frequency <frequency>

/serp-monitor --keywords "keyword1,keyword2,keyword3" --frequency daily

/link-prospecting --niche <niche> --min-da <score>

/link-prospecting --niche "saas marketing" --min-da 40

┌─────────────────────────┬─────┬─────┬──────────┬─────────────┐
│ Prospect Domain         │ DA  │ DR  │ Contact  │ Outreach    │
├─────────────────────────┼─────┼─────┼──────────┼─────────────┤
│ marketingblog.example   │  58 │  62 │  ✓ Found │  Template 1 │
│ saasinsider.example     │  51 │  55 │  ✓ Found │  Template 2 │
│ techreview.example      │  67 │  71 │  ⚠ Guess │  Template 1 │
└─────────────────────────┴─────┴─────┴──────────┴─────────────┘

/page-speed-seo <url>

/page-speed-seo https://example.com/blog/post

/local-seo --business <name> --location <location>

/local-seo --business "Acme Pizza" --location "San Francisco, CA"

/content-calendar --topics <topics> --duration <months>

/content-calendar --topics "email marketing,seo,content strategy" --duration 6

/workflows:full-seo-sprint <target_domain> --scope <scope>

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

/workflows:launch-seo <staging_url>

/workflows:content-refresh --filter <filter>

/workflows:content-refresh --filter "declined-last-3-months"

/workflows:authority-building --niche <niche> --duration <weeks>

/workflows:ai-content-pipeline --topic <topic>

/workflows:ai-content-pipeline --topic "saas marketing strategies"

# API keys for data sources
export SEMRUSH_API_KEY="${SEMRUSH_API_KEY}"
export AHREFS_API_KEY="${AHREFS_API_KEY}"
export SCREAMING_FROG_LICENSE="${SCREAMING_FROG_LICENSE}"

# Default settings
export SEO_DEFAULT_REGION="us"
export SEO_OUTPUT_FORMAT="md"
export SEO_AUDIT_DEPTH="standard"

# Data source preferences
data_sources:
  keyword_research: semrush  # semrush|ahrefs|both
  backlinks: ahrefs         # ahrefs|moz|majestic
  serp_tracking: semrush    # semrush|accuranker

# Default command options
defaults:
  region: us
  output_format: md
  audit_depth: standard
  
# Thresholds
thresholds:
  keyword_difficulty_high: 60
  quality_score_good: 75
  page_speed_acceptable: 2.5
  min_backlink_da: 30

# Output preferences
output:
  show_progress: true
  use_color: true
  export_path: ./seo-reports/

#!/bin/bash
# monthly-seo-check.sh

DOMAIN="example.com"
DATE=$(date +%Y-%m)
REPORT_DIR="./reports/${DATE}"

mkdir -p "$REPORT_DIR"

# Run core audits
/technical-seo "$DOMAIN" --output json > "$REPORT_DIR/technical.json"
/content-audit --scope full --output json > "$REPORT_DIR/content.json"
/serp-monitor --keywords "$(cat keywords.txt)" --output json > "$REPORT_DIR/rankings.json"

# Generate summary
echo "✓ Monthly SEO health check complete"
echo "  Reports saved to: $REPORT_DIR"

// competitor-monitor.js
const competitors = ['competitor1.com', 'competitor2.com', 'competitor3.com'];

async function monitorCompetitors() {
  for (const competitor of competitors) {
    const gaps = await executeCommand('/competitor-gap', {
      competitors: [competitor],
      type: 'all',
      output: 'json'
    });
    
    // Alert on new opportunities
    if (gaps.backlink_gap.new_links > 10) {
      notify(`${competitor} gained ${gaps.backlink_gap.new_links} new backlinks`);
    }
    
    if (gaps.topic_gap.new_topics.length > 5) {
      notify(`${competitor} covered ${gaps.topic_gap.new_topics.length} new topics`);
    }
  }
}

// Run weekly
setInterval(monitorCompetitors, 7 * 24 * 60 * 60 * 1000);

# content-brief-automation.py
import subprocess
import json
import os

def generate_briefs(keywords_file):
    """Generate content briefs for a list of keywords"""
    with open(keywords_file, 'r') as f:
        keywords = [line.strip() for line in f]
    
    output_dir = './content-briefs/'
    os.makedirs(output_dir, exist_ok=True)
    
    for keyword in keywords:
        result = subprocess.run(
            ['/content-brief', keyword, '--output', 'md'],
            capture_output=True,
            text=True
        )
        
        # Save brief to file
        safe_filename = keyword.replace(' ', '-').lower()
        with open(f'{output_dir}/{safe_filename}.md', 'w') as f:
            f.write(result.stdout)
        
        print(f'✓ Generated brief for: {keyword}')

# Usage
generate_briefs('target-keywords.txt')

#!/bin/bash
# page-speed-monitor.sh

URLS_FILE="critical-pages.txt"
THRESHOLD=2.5  # seconds
ALERT_EMAIL="${ALERT_EMAIL}"

while IFS= read -r url; do
  result=$(/page-speed-seo "$url" --output json)
  lcp=$(echo "$result" | jq -r '.core_web_vitals.lcp')
  
  if (( $(echo "$lcp > $THRESHOLD" | bc -l) )); then
    echo "⚠ Slow page detected: $url (LCP: ${lcp}s)"
    # Send alert
    echo "Page $url has LCP of ${lcp}s (threshold: ${THRESHOLD}s)" | \
      mail -s "Page Speed Alert" "$ALERT_EMAIL"
  fi
done < "$URLS_FILE"

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

# Re-register the skill
/read ~/.claude/skills/seo-content-marketing/SKILL.md

# Check command availability
/help seo

# config.yaml
rate_limits:
  requests_per_minute: 30
  retry_attempts: 3
  retry_delay: 5  # seconds

# Install Screaming Frog (for comprehensive crawls)
# Download from: https://www.screamingfrog.co.uk/seo-spider/

# Install Node.js dependencies (if using programmatic access)
npm install

# Install Python dependencies (for automation scripts)
pip install -r requirements.txt

# Use shallow depth for quick checks
/content-audit --scope blog --depth quick

# Limit crawl pages
/technical-seo example.com --max-pages 500

# Run audits incrementally
/content-audit --scope specific --filter "published-last-month"

# Verify API keys are set
echo $SEMRUSH_API_KEY
echo $AHREFS_API_KEY

# Test API connectivity
curl "https://api.semrush.com/?type=domain_ranks&key=${SEMRUSH_API_KEY}&export_columns=Dn,Rk&domain=example.com"

# Update config with fallback sources
# config.yaml
data_sources:
  keyword_research: both  # will fall back if primary fails

# Check output directory permissions
mkdir -p ~/seo-reports
chmod 755 ~/seo-reports

# Specify absolute path
/content-audit --output json --export ~/seo-reports/audit-$(date +%Y%m%d).json

# Verify JSON validity
jq . ~/seo-reports/audit-20260511.json

# custom-workflows/ecommerce-seo.yaml
name: E-commerce SEO Sprint
steps:
  - command: /technical-seo
    args: { scope: product-pages }
  - command: /keyword-research
    args: { depth: deep, intent: transactional }
  - command: /competitor-gap
    args: { type: topic }
  - command: /content-calendar
    args: { focus: product-content }

# .github/workflows/seo-check.yml
name: SEO Check
on:
  schedule:
    - cron: '0 0 * * 1'  # Weekly on Monday
jobs:
  seo-audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run Technical SEO Audit
        run: |
          /technical-seo ${{ secrets.PRODUCTION_URL }} --output json > seo-audit.json
      - name: Check for Critical Issues
        run: |
          critical=$(jq '.findings[] | select(.severity=="critical") | length' seo-audit.json)
          if [ "$critical" -gt 0 ]; then
            echo "❌ Found $critical critical SEO issues"
            exit 1
          fi