r06-alirezarezvani-claude-code-tresor-seo

Skill by ara.so — Marketing Skills collection.

SEO & Content Marketing skill suite providing keyword research, content audits, SERP analysis, technical SEO diagnostics, and content strategy automation. Derived from alirezarezvani/claude-code-tresor with structured output, progress tracking, and multi-step workflow orchestration.

What This Project Does

This skill suite provides 10 specialized SEO commands and 5 multi-step workflows:

Core Commands:

• Keyword research with clustering and intent mapping
• Full-site content audits and cannibalization detection
• Technical SEO crawls (Core Web Vitals, schema, indexability)
• Competitor gap analysis (backlinks, topics, snippets)
• AI-generated content briefs with NLP terms
• SERP rank tracking with volatility alerts
• Link prospecting and outreach automation
• Page speed diagnostics mapped to ranking impact
• Local SEO audits (NAP, GBP, citations)
• Data-driven content calendar generation

Workflows:

• Full SEO sprint (audit → keyword map → content plan)
• Pre-launch SEO checklist
• Content refresh pipeline
• Authority building campaigns
• AI content production pipeline

Installation

# Clone the skill suite
git clone https://github.com/LairLightningDerrick/r06-alirezarezvani-claude-code-tresor-seo.git

# Copy to Claude Code skills directory
cp -r r06-alirezarezvani-claude-code-tresor-seo ~/.claude/skills/

# Or install via npm if available
npm install -g r06-alirezarezvani-claude-code-tresor-seo

Register in Claude Code session:

/read ~/.claude/skills/r06-alirezarezvani-claude-code-tresor-seo/SKILL.md

Key Commands

Keyword Research

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

# Basic keyword research
/keyword-research "project management software"

# Advanced with filters
/keyword-research "project management software" \
  --min-volume 500 \
  --max-difficulty 40 \
  --intent commercial,transactional \
  --output json

Expected Output Structure:

╔═══════════════════════════════════════════════════╗
║  Keyword Research  —  "project management software"  ║
╠═══════════════════════════════════════════════════╣
║  Fetching search volume …    [██████████] 100% ✓  ║
║  Analyzing SERP intent …     [██████████] 100% ✓  ║
║  Clustering keywords …       [██████████] 100% ✓  ║
║  Scoring opportunities …     [██████████] 100% ✓  ║
╚═══════════════════════════════════════════════════╝

┌──────────────────────────┬────────┬────────┬──────────┬──────────┐
│ Keyword                  │ Volume │ Diff.  │ Intent   │ Priority │
├──────────────────────────┼────────┼────────┼──────────┼──────────┤
│ project management tools │ 18,100 │   35   │ Comm.    │  🟢 High │
│ pm software for teams    │  8,900 │   28   │ Trans.   │  🟢 High │
│ best project tracker     │  6,400 │   42   │ Info.    │  🟡 Med  │
│ free pm software         │  4,200 │   18   │ Trans.   │  🟢 High │
└──────────────────────────┴────────┴────────┴──────────┴──────────┘

📊 Clusters Found: 5 primary, 12 secondary
🎯 Quick Wins: 8 keywords (low difficulty, high volume)

Content Audit

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

# Basic audit
/content-audit https://example.com

# Full scope with exports
/content-audit https://example.com \
  --scope full \
  --check-duplicates \
  --check-cannibalization \
  --output md,csv

Code Pattern (Integration Example):

// If integrating with custom crawler
const contentAudit = require('r06-seo-suite/content-audit');

const results = await contentAudit.run({
  domain: 'https://example.com',
  scope: 'full',
  options: {
    checkDuplicates: true,
    checkCannibalization: true,
    minWordCount: 300,
    maxTitleLength: 60
  }
});

console.log(results.summary);
// {
//   totalPages: 1204,
//   duplicateContent: 47,
//   cannibalizationIssues: 12,
//   missingMetaDesc: 302,
//   thinContent: 89,
//   qualityScore: 7.2
// }

Technical SEO Audit

Crawl budget, Core Web Vitals, schema markup, and indexability diagnostics.

# Basic technical audit
/technical-seo https://example.com

# Detailed with specific checks
/technical-seo https://example.com \
  --check-cwv \
  --check-schema \
  --check-robots \
  --check-sitemap \
  --check-mobile

Output Structure:

┌─────────────────────┬──────────┬──────────┬──────────┐
│ Metric              │ Current  │ Target   │ Status   │
├─────────────────────┼──────────┼──────────┼──────────┤
│ Crawlable pages     │    1,204 │    1,505 │  ⚠ 80%   │
│ Pages w/ title tag  │    1,180 │    1,204 │  ✓ 98%   │
│ Core Web Vitals     │     Good │     Good │  ✓ Pass  │
│ Schema markup       │      342 │    1,204 │  ✗ 28%   │
│ Mobile-friendly     │       97 │      100 │  ⚠ 97%   │
└─────────────────────┴──────────┴──────────┴──────────┘

🔴 Critical Issues (3)
  • 301 pages blocked by robots.txt
  • Sitemap contains 124 404 URLs
  • 18 pages with duplicate H1 tags

🟠 Warnings (8)
  • 302 pages missing meta descriptions
  • LCP > 2.5s on 23% of pages
  • 89 pages with thin content (<300 words)

Competitor Gap Analysis

Backlink gap, topic gap, and featured snippet opportunities.

# Compare against competitors
/competitor-gap https://example.com \
  --competitors competitor1.com,competitor2.com,competitor3.com \
  --analyze backlinks,topics,snippets

# Focus on specific gap type
/competitor-gap https://example.com \
  --competitors competitor1.com \
  --gap-type backlinks \
  --min-dr 40

Content Brief Generation

AI-generated SEO content brief with structure, NLP terms, and targets.

# Generate brief for target keyword
/content-brief "how to manage remote teams"

# Advanced brief with competitors
/content-brief "how to manage remote teams" \
  --analyze-serp \
  --competitors 5 \
  --include-nlp \
  --target-wordcount 2500

Output Example:

# Content Brief: "how to manage remote teams"

## Target Metrics
- **Word Count:** 2,200-2,800 words
- **Reading Level:** Grade 8-10
- **Target Intent:** Informational + Commercial

## Outline
1. Introduction (150-200 words)
   - Hook: Remote work statistics
   - Problem statement
   
2. Core Challenges (400-500 words)
   - Communication barriers
   - Time zone differences
   - Building trust remotely
   
3. Proven Strategies (800-1000 words)
   - Daily standups & async updates
   - Tool stack recommendations
   - Performance tracking
   
4. Best Practices (400-500 words)
   - Team culture building
   - 1-on-1 check-ins
   
5. Conclusion & CTA (150-200 words)

## NLP Terms to Include
- remote team management
- asynchronous communication
- distributed workforce
- virtual collaboration tools
- remote employee engagement
[...25 more terms]

## SERP Analysis
Top 5 competitors average:
- Word count: 2,350
- Images: 8
- Videos: 1-2
- Internal links: 12
- External links: 8

SERP Monitoring

Daily rank tracking with volatility alerts and CTR optimization.

# Monitor keywords
/serp-monitor \
  --keywords "keyword1,keyword2,keyword3" \
  --domain example.com \
  --frequency daily

# With alerts
/serp-monitor \
  --keywords-file keywords.csv \
  --alert-threshold 3 \
  --notify email

Link Prospecting

Quality backlink prospect list with DA/DR filters and outreach templates.

# Find link prospects
/link-prospecting \
  --niche "project management" \
  --min-dr 30 \
  --max-results 100 \
  --include-contacts

# With outreach templates
/link-prospecting \
  --niche "project management" \
  --generate-templates \
  --output csv

Page Speed SEO

Render-blocking, LCP, CLS, FID diagnosis mapped to ranking impact.

# Analyze page speed
/page-speed-seo https://example.com/page

# Multiple pages
/page-speed-seo \
  --sitemap https://example.com/sitemap.xml \
  --top-pages 20 \
  --mobile

Local SEO Audit

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

# Local SEO check
/local-seo \
  --business "Example Corp" \
  --location "New York, NY" \
  --check-nap \
  --check-gbp \
  --check-citations

Content Calendar

Data-driven editorial calendar from search demand and seasonality.

# Generate calendar
/content-calendar \
  --niche "project management" \
  --duration 90 \
  --frequency weekly \
  --include-trending

# Export to tools
/content-calendar \
  --niche "project management" \
  --export notion,airtable,trello

Workflows (Multi-Step)

Full SEO Sprint

12-step comprehensive SEO sprint workflow.

/workflows:full-seo-sprint https://example.com \
  --scope full \
  --duration 30days

Steps:

1. Technical audit
2. Content audit
3. Keyword research
4. Competitor analysis
5. Gap identification
6. Content strategy
7. Link building plan
8. On-page optimization
9. Schema implementation
10. Performance monitoring
11. Reporting dashboard
12. Next sprint planning

Launch SEO

Pre-launch SEO checklist and validation.

/workflows:launch-seo https://newsite.com \
  --pre-launch \
  --check-all

Validates:

• Canonical tags
• Hreflang (if applicable)
• Sitemap generation
• Robots.txt configuration
• Schema markup
• Core Web Vitals
• Mobile optimization
• Analytics setup

Content Refresh

Identify and refresh underperforming pages.

/workflows:content-refresh https://example.com \
  --min-age 180days \
  --traffic-drop 30%

Authority Building

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

/workflows:authority-building \
  --niche "project management" \
  --target-dr 50 \
  --duration 90days

AI Content Pipeline

Keyword → brief → draft → optimize → publish automation.

/workflows:ai-content-pipeline \
  --keywords-file keywords.csv \
  --auto-publish false \
  --review-mode true

Configuration

Create a configuration file at ~/.r06-seo/config.json:

{
  "api": {
    "semrush_key": "${SEMRUSH_API_KEY}",
    "ahrefs_key": "${AHREFS_API_KEY}",
    "serpapi_key": "${SERPAPI_KEY}",
    "openai_key": "${OPENAI_API_KEY}"
  },
  "defaults": {
    "country": "US",
    "language": "en",
    "search_engine": "google.com",
    "mobile_first": true
  },
  "thresholds": {
    "min_word_count": 300,
    "max_title_length": 60,
    "max_meta_desc_length": 160,
    "target_cwv_lcp": 2.5,
    "target_cwv_fid": 100,
    "target_cwv_cls": 0.1
  },
  "notifications": {
    "email": "${NOTIFICATION_EMAIL}",
    "slack_webhook": "${SLACK_WEBHOOK_URL}",
    "enabled": true
  }
}

Environment Variables:

export SEMRUSH_API_KEY="your-key-here"
export AHREFS_API_KEY="your-key-here"
export SERPAPI_KEY="your-key-here"
export OPENAI_API_KEY="your-key-here"
export NOTIFICATION_EMAIL="alerts@example.com"
export SLACK_WEBHOOK_URL="https://hooks.slack.com/..."

Common Patterns

Integration with CI/CD

# .github/workflows/seo-monitor.yml
name: Daily SEO Monitor

on:
  schedule:
    - cron: '0 9 * * *'

jobs:
  seo-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Run SEO audit
        run: |
          npx r06-seo-suite technical-seo https://example.com \
            --output json > audit-results.json
      
      - name: Check for critical issues
        run: |
          node scripts/check-critical.js audit-results.json
      
      - name: Notify on failures
        if: failure()
        run: |
          curl -X POST ${{ secrets.SLACK_WEBHOOK }} \
            -d '{"text":"SEO audit found critical issues"}'

Programmatic Usage

const SEOSuite = require('r06-seo-suite');

const suite = new SEOSuite({
  apiKey: process.env.SEMRUSH_API_KEY,
  config: {
    country: 'US',
    language: 'en'
  }
});

// Keyword research
const keywords = await suite.keywordResearch({
  seed: 'project management software',
  minVolume: 500,
  maxDifficulty: 40
});

// Content audit
const audit = await suite.contentAudit({
  domain: 'https://example.com',
  scope: 'full',
  options: {
    checkDuplicates: true,
    checkCannibalization: true
  }
});

// Generate content brief
const brief = await suite.contentBrief({
  keyword: 'how to manage remote teams',
  analyzeSERP: true,
  competitors: 5,
  targetWordCount: 2500
});

console.log(brief.outline);
console.log(brief.nlpTerms);

Batch Processing

# Process multiple domains
cat domains.txt | while read domain; do
  /technical-seo "$domain" --output json > "results/${domain//\//_}.json"
done

# Bulk keyword research
/keyword-research \
  --seeds-file keywords.txt \
  --batch-size 50 \
  --output csv > keyword-report.csv

Custom Reporting

const { generateReport } = require('r06-seo-suite/reporting');

const data = {
  technicalAudit: await suite.technicalSEO('https://example.com'),
  contentAudit: await suite.contentAudit('https://example.com'),
  keywordData: await suite.keywordResearch({ seed: 'main topic' })
};

const report = await generateReport({
  data,
  template: 'executive-summary',
  format: 'pdf',
  includeCharts: true
});

await report.save('monthly-seo-report.pdf');

Troubleshooting

API Rate Limits

If you encounter rate limit errors:

# Check current rate limit status
/debug:rate-limits

# Configure retry with backoff
export SEO_SUITE_RETRY_COUNT=3
export SEO_SUITE_RETRY_DELAY=5000

Slow Crawls

For large sites, optimize crawl performance:

# Limit concurrent requests
/technical-seo https://example.com \
  --concurrent 5 \
  --delay 1000

# Crawl specific sections
/content-audit https://example.com \
  --path "/blog/*" \
  --exclude "/archive/*"

Missing Dependencies

# Install all optional dependencies
npm install r06-seo-suite --include=optional

# Specific tools
npm install puppeteer  # For page speed tests
npm install cheerio    # For content parsing

Authentication Issues

# Verify API keys
/debug:check-auth

# Test individual APIs
curl -H "Authorization: Bearer ${SEMRUSH_API_KEY}" \
  "https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=domain_ranks&domain=example.com"

Output Format Issues

# Force specific output format
/keyword-research "topic" --output json --pretty

# Validate output schema
/keyword-research "topic" --validate-output

# Debug mode for detailed logs
DEBUG=r06-seo:* /technical-seo https://example.com

Best Practices

1. Always use environment variables for API keys
2. Start with scoped audits before running full-site scans
3. Set up notifications for critical issues
4. Cache results for frequently accessed data
5. Use batch processing for multiple domains/keywords
6. Export to CSV/JSON for integration with other tools
7. Schedule regular monitoring via cron or CI/CD
8. Review action plans before implementing changes
9. Track changes in version control
10. Validate fixes with follow-up audits