r14-borghei-claude-skills-seo

Imported from reason-machines/marketing-skills (skills/r14-borghei-claude-skills-seo/SKILL.md) via skills.sh. Install upstream with npx skills add reason-machines/marketing-skills --skill r14-borghei-claude-skills-seo. Copyright stays with the author.

📈 SEO & Content Marketing Skills Suite

Skill by ara.so — Marketing Skills collection.

This skill suite provides specialized SEO and content marketing commands derived from the borghei/Claude-Skills framework. It includes 10 domain-specific commands and 5 multi-step workflows for keyword research, content audits, technical SEO, SERP analysis, and content strategy.

What This Project Does

The r14-borghei-claude-skills-seo suite enables AI agents to perform comprehensive SEO and content marketing tasks through structured commands:

• Keyword Research — clustering, opportunity scoring, SERP intent mapping
• Content Audits — quality scoring, duplication detection, cannibalization reports
• Technical SEO — crawl budget, Core Web Vitals, schema markup analysis
• Competitive Analysis — backlink gaps, topic gaps, featured snippet opportunities
• Content Strategy — briefs, calendars, refresh workflows, AI pipelines

All commands follow a consistent 5-step interaction pattern with structured output, progress tracking, and actionable recommendations.

Installation

Clone the Skill

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

# Clone into the skills directory
git clone https://github.com/SheenEmpress/r14-borghei-claude-skills-seo.git ~/.claude/skills/r14-borghei-claude-skills-seo

Register in Claude Code

In a Claude Code session:

/read ~/.claude/skills/r14-borghei-claude-skills-seo/SKILL.md

Or manually add to your project's .claude/skills directory:

cp -r ~/.claude/skills/r14-borghei-claude-skills-seo /path/to/project/.claude/skills/

Core Commands

Keyword Research

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

/keyword-research "e-commerce platform"

With options:

/keyword-research "SaaS analytics" --region us --language en --depth advanced

Expected output structure:

╔══════════════════════════════════════════════════╗
║  Keyword Research — SaaS analytics               ║
╠══════════════════════════════════════════════════╣
║  Fetching seed keywords …    [██████████] 100%   ║
║  Clustering by intent …      [██████████] 100%   ║
║  Scoring opportunities …     [██████████] 100%   ║
╚══════════════════════════════════════════════════╝

┌────────────────────┬────────┬────┬──────────┬──────────┐
│ Keyword            │ Volume │ KD │ Intent   │ Priority │
├────────────────────┼────────┼────┼──────────┼──────────┤
│ saas analytics     │ 12 100 │ 45 │ Info     │  🟢 High │
│ best saas metrics  │  8 900 │ 32 │ Comp     │  🟢 High │
│ saas kpi dashboard │  4 300 │ 28 │ Trans    │  🟡 Med  │
└────────────────────┴────────┴────┴──────────┴──────────┘

Content Audit

Analyzes site-wide content quality, identifies duplicates, and detects keyword cannibalization.

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

With URL filtering:

/content-audit --scope "/blog/*" --output json

Output format:

• Quality scores per page (0-100)
• Duplicate content clusters
• Cannibalization warnings (pages competing for same keywords)
• Recommended actions (update, merge, redirect, delete)

Technical SEO

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

/technical-seo

With specific checks:

/technical-seo --checks "crawl,vitals,schema" --threshold critical

Analyzes:

• Crawl budget efficiency
• Core Web Vitals (LCP, FID, CLS)
• Schema markup validation
• Robots.txt and sitemap issues
• Canonical and hreflang configuration
• Mobile-friendliness
• HTTPS and security headers

Competitor Gap Analysis

Identifies backlink gaps, topic gaps, and featured snippet opportunities relative to competitors.

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

Output includes:

• Backlinks they have that you don't
• Topics they rank for that you don't cover
• Featured snippets they own
• Keyword opportunities with lower competition

Content Brief Generation

Creates AI-generated SEO content briefs with outlines, NLP terms, and word count targets.

/content-brief "how to choose a CRM system"

With targeting:

/content-brief "project management tools comparison" --target-keyword "best project management software" --word-count 2500

Brief includes:

• Target keyword and secondary keywords
• SERP analysis of top 10 results
• Recommended outline structure
• NLP terms and entities to include
• Word count target
• Internal linking suggestions

SERP Monitoring

Daily rank tracking with volatility alerts and CTR optimization recommendations.

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

With reporting:

/serp-monitor --keywords-file keywords.txt --report-format email --alert-threshold 5

Link Prospecting

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

/link-prospecting --topic "digital marketing" --min-da 30

Output format:

┌─────────────────────┬────┬────┬──────────┬────────────┐
│ Domain              │ DA │ DR │ Rel Type │ Contact    │
├─────────────────────┼────┼────┼──────────┼────────────┤
│ marketingblog.com   │ 58 │ 62 │ Guest    │ editor@... │
│ seoinsights.io      │ 47 │ 51 │ Resource │ team@...   │
└─────────────────────┴────┴────┴──────────┴────────────┘

Page Speed SEO

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

/page-speed-seo --url "https://example.com/page"

Analyzes:

• Render-blocking JavaScript and CSS
• Largest Contentful Paint (LCP) elements
• Cumulative Layout Shift (CLS) causes
• First Input Delay (FID) bottlenecks
• Image optimization opportunities
• Ranking impact score for each issue

Local SEO

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

/local-seo --business-name "Coffee Shop Downtown"

Checks:

• NAP (Name, Address, Phone) consistency across directories
• Google Business Profile completeness
• Local citation coverage
• Review signals
• Local schema markup

Content Calendar

Builds data-driven editorial calendars from search demand and seasonality data.

/content-calendar --months 3 --topics "seo,content-marketing,analytics"

Calendar includes:

• Topic schedule aligned with search trends
• Seasonal opportunities
• Content formats (blog, video, infographic)
• Target keywords per piece
• Estimated resource requirements

Workflows (Multi-Step)

Full SEO Sprint

12-step comprehensive SEO workflow: audit → keyword map → content plan → technical fixes.

/workflows:full-seo-sprint --scope full

Steps:

1. Technical audit
2. Content audit
3. Keyword research
4. Competitor analysis
5. Keyword mapping
6. Content gap identification
7. Priority action plan
8. Technical fix implementation
9. Content creation brief
10. Link building strategy
11. Monitoring setup
12. Reporting dashboard

Launch SEO

Pre-launch SEO checklist with canonical, hreflang, and sitemap validation.

/workflows:launch-seo --url "https://new-site.com" --checklist comprehensive

Validates:

• Canonical tags
• Hreflang implementation
• XML sitemap
• Robots.txt
• Schema markup
• Meta tags
• Mobile optimization
• Page speed
• SSL/HTTPS

Content Refresh

Identifies and refreshes underperforming pages to recover lost rankings.

/workflows:content-refresh --threshold "rank-drop-5"

Process:

1. Identify declining pages
2. Analyze ranking drops
3. Compare to current top 10
4. Generate refresh recommendations
5. Create update briefs
6. Track recovery

Authority Building

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

/workflows:authority-building --industry "saas" --campaign-length 90

Campaign includes:

• Link-worthy asset ideation
• Content creation brief
• Outreach prospect list
• Email templates
• Follow-up sequences
• Tracking spreadsheet

AI Content Pipeline

Keyword → brief → draft → optimize → publish automation pipeline.

/workflows:ai-content-pipeline --keyword "email marketing best practices" --auto-draft true

Pipeline stages:

1. Keyword validation
2. SERP analysis
3. Brief generation
4. AI draft creation
5. SEO optimization
6. Quality review checklist
7. Publish-ready output

Configuration

Environment Variables

Set these in your environment or .env file:

# SEO tool API keys (reference only - use actual env vars)
export SEMRUSH_API_KEY="${SEMRUSH_API_KEY}"
export AHREFS_API_TOKEN="${AHREFS_API_TOKEN}"
export GOOGLE_SEARCH_CONSOLE_KEY="${GOOGLE_SEARCH_CONSOLE_KEY}"
export GOOGLE_ANALYTICS_KEY="${GOOGLE_ANALYTICS_KEY}"

# Default settings
export SEO_DEFAULT_REGION="us"
export SEO_DEFAULT_LANGUAGE="en"
export SEO_OUTPUT_FORMAT="markdown"

Project Configuration File

Create .seo-skills.yaml in your project root:

# SEO Skills Configuration
project:
  domain: "example.com"
  primary_language: "en"
  target_regions: ["us", "gb", "ca"]

keywords:
  seed_file: "keywords.txt"
  auto_cluster: true
  min_volume: 100
  max_difficulty: 60

content_audit:
  scope: "/blog/*"
  exclude_patterns:
    - "/blog/archive/*"
    - "/blog/tag/*"
  quality_threshold: 60

technical_seo:
  crawl_delay: 1000  # milliseconds
  max_pages: 10000
  check_external_links: true
  validate_schema: true

competitors:
  - "competitor1.com"
  - "competitor2.com"
  - "competitor3.com"

reporting:
  format: "markdown"
  output_dir: "./seo-reports"
  email_alerts: true
  email_recipients:
    - "team@example.com"

Common Patterns

Daily SEO Monitoring

Set up automated daily checks:

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

/serp-monitor --keywords-file keywords.txt --report-format email
/page-speed-seo --url "https://example.com" --threshold warning
/technical-seo --checks "crawl,vitals" --output json > daily-technical.json

Content Production Workflow

Streamlined content creation process:

# 1. Research keyword
/keyword-research "topic" --depth advanced

# 2. Generate brief
/content-brief "chosen keyword" --word-count 2000

# 3. Create draft (use AI or human writer)

# 4. Optimize before publish
/page-speed-seo --url "draft-url"
/technical-seo --checks "schema" --url "draft-url"

Monthly SEO Reporting

Comprehensive monthly workflow:

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

MONTH=$(date +%Y-%m)
REPORT_DIR="./reports/${MONTH}"
mkdir -p "${REPORT_DIR}"

# Full audits
/content-audit --scope full --output md > "${REPORT_DIR}/content-audit.md"
/technical-seo --output md > "${REPORT_DIR}/technical-seo.md"

# Competitive analysis
/competitor-gap --competitors "comp1.com,comp2.com" --output md > "${REPORT_DIR}/competitor-gap.md"

# Performance tracking
/serp-monitor --keywords-file keywords.txt --report-format md > "${REPORT_DIR}/rankings.md"

echo "Monthly report generated in ${REPORT_DIR}"

Pre-Launch Checklist

Complete pre-launch validation:

# Run full launch workflow
/workflows:launch-seo --url "${STAGING_URL}" --checklist comprehensive

# Additional checks
/technical-seo --checks all
/page-speed-seo --url "${STAGING_URL}"
/local-seo --business-name "${BUSINESS_NAME}"  # if applicable

Troubleshooting

Command Not Found

Issue: Commands are not recognized.

Solution: Ensure the skill is loaded:

/read ~/.claude/skills/r14-borghei-claude-skills-seo/SKILL.md

Or check your project's .claude/skills/ directory contains the skill files.

API Rate Limiting

Issue: SEO tool APIs return rate limit errors.

Solution: Configure rate limiting in .seo-skills.yaml:

api:
  rate_limit:
    requests_per_minute: 30
    retry_attempts: 3
    backoff_multiplier: 2

Large Site Audits Timing Out

Issue: Content or technical audits fail on large sites.

Solution: Use scope filtering:

# Audit specific sections
/content-audit --scope "/blog/*" --max-pages 1000

# Or run incremental audits
/content-audit --scope "/blog/2024/*"
/content-audit --scope "/blog/2023/*"

Missing Dependencies

Issue: Workflow fails with missing data.

Solution: Ensure prerequisite commands have run:

# Some workflows require prior data
/keyword-research "topic"  # Run first
/content-brief "topic"      # Then use results

Output Format Issues

Issue: Reports are not in the desired format.

Solution: Specify output format explicitly:

/content-audit --output json  # or md, csv, html

Or set default in config:

reporting:
  format: "markdown"  # json, csv, html

Competitor Data Not Available

Issue: Competitor analysis returns incomplete data.

Solution: Verify competitor domains are accessible and ensure API keys are configured:

export AHREFS_API_TOKEN="${AHREFS_API_TOKEN}"
export SEMRUSH_API_KEY="${SEMRUSH_API_KEY}"

Check domain spelling and accessibility:

/competitor-gap --competitors "correct-domain.com" --debug

Advanced Usage

Custom Keyword Scoring

Override default keyword opportunity scoring:

# .seo-skills.yaml
keyword_scoring:
  weights:
    search_volume: 0.3
    keyword_difficulty: 0.25
    click_potential: 0.2
    relevance: 0.15
    trend: 0.1
  filters:
    min_volume: 100
    max_difficulty: 50
    exclude_patterns:
      - "free"
      - "download"

Integration with CI/CD

Add SEO checks to your deployment pipeline:

# .github/workflows/seo-check.yml
name: SEO Pre-Deploy Check

on:
  pull_request:
    branches: [main]

jobs:
  seo-audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Run Technical SEO Check
        run: |
          /technical-seo --checks "schema,vitals" --output json
          
      - name: Validate Content
        run: |
          /content-audit --scope "$(git diff --name-only origin/main | grep '.md$')"

Batch Processing

Process multiple URLs or keywords efficiently:

# keywords.txt
keyword 1
keyword 2
keyword 3

# Batch process
while read keyword; do
  /content-brief "$keyword" --output "briefs/${keyword// /-}.md"
done < keywords.txt

Reference

All Commands Summary

All Workflows Summary

Resources

• Source Repository: borghei/Claude-Skills
• This Adaptation: r14-borghei-claude-skills-seo
• License: MIT