r06-alirezarezvani-claude-code-tresor-seo

# r06-alirezarezvani-claude-code-tresor-seo > Skill by [ara.so](https://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](https://github.com/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 ```bash # 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:** ```bash /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. ```bash # 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. ```bash # 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):** ```javascript // 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. ```bash # 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. ```bash # 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. ```bash # 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:** ```markdown # 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. ```bash # 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. ```bash # 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. ```bash # 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. ```bash # 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. ```bash # 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. ```bash /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. ```bash /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. ```bash /workflows:content-refresh https://example.com \ --min-age 180days \ --traffic-drop 30% ``` ### Authority Building End-to-end digital PR and link building campaign. ```bash /workflows:authority-building \ --niche "project management" \ --target-dr 50 \ --duration 90days ``` ### AI Content Pipeline Keyword → brief → draft → optimize → publish automation. ```bash /workflows:ai-content-pipeline \ --keywords-file keywords.csv \ --auto-publish false \ --review-mode true ``` ## Configuration Create a configuration file at `~/.r06-seo/config.json`: ```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:** ```bash 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 ```yaml # .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 ```javascript 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 ```bash # Process multiple domains cat domains.txt | while read domain; do