# 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

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

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

/keyword-research "e-commerce platform"

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

╔══════════════════════════════════════════════════╗
║  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 --scope full --output md

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

/technical-seo

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# 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"

# 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"

#!/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

# 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"

#!/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}"

# 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

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

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

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

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

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

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

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

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

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

# .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"

# .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$')"

# keywords.txt
keyword 1
keyword 2
keyword 3

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