r16-voltagent-seo-content-marketing-agent-skills

# Basic keyword research
/keyword-research "project management software"
 
# With advanced options
/keyword-research "email marketing" --depth deep --competitors 5 --export csv

┌─────────────────────────┬────────┬────────┬──────────┬──────────┐
│ Keyword                 │ Volume │ KD     │ Intent   │ Opportunity│
├─────────────────────────┼────────┼────────┼──────────┼──────────┤
│ email marketing tools   │ 12,400 │ 58     │ Commercial│  🟢 High │
│ best email software     │  8,900 │ 72     │ Commercial│  🟡 Med  │
│ email automation guide  │  3,200 │ 34     │ Informational│ 🟢 High │
│ mailchimp alternatives  │  2,100 │ 45     │ Commercial│  🟢 High │
└─────────────────────────┴────────┴────────┴──────────┴──────────┘

# Audit entire site
/content-audit https://example.com --scope full
 
# Audit specific section
/content-audit https://example.com/blog --scope section --output md

# Full technical audit
/technical-seo https://example.com
 
# Focus on specific areas
/technical-seo https://example.com --focus "core-web-vitals,schema"

✓ Robots.txt validation
✓ XML sitemap structure
✓ Canonical tag implementation
✓ HTTPS/SSL configuration
✓ Mobile responsiveness
✓ Structured data markup
✓ Core Web Vitals (LCP, FID, CLS)
✓ Crawl budget optimization
✓ Internal linking structure
✓ 4xx/5xx error pages

# Analyze competitor landscape
/competitor-gap https://example.com --competitors "competitor1.com,competitor2.com,competitor3.com"
 
# Focus on backlinks
/competitor-gap https://example.com --competitors "competitor1.com" --type backlinks

# Generate content brief
/content-brief "how to automate email campaigns"
 
# With custom parameters
/content-brief "seo tools comparison" --word-count 2500 --competitors 5

# Content Brief: How to Automate Email Campaigns
 
## Target Metrics
- Primary keyword: "automate email campaigns"
- Search volume: 3,200/mo
- Keyword difficulty: 42
- Target word count: 1,800-2,200
- Recommended format: How-to guide
 
## Outline
1. Introduction (150 words)
2. What is Email Automation? (300 words)
3. Benefits of Automation (400 words)
4. Step-by-Step Setup Guide (800 words)
5. Best Practices (350 words)
6. Conclusion & CTA (150 words)
 
## NLP Terms to Include
- email workflow
- trigger-based campaigns
- drip sequences
- behavioral targeting
- segmentation rules
 
## Competitor Analysis
Top 3 ranking pages analyzed for:
- Average word count: 2,100
- Average headings: 12
- Average images: 8
- Common topics: [list]

# Monitor keywords
/serp-monitor --keywords "keyword1,keyword2,keyword3" --domain example.com
 
# Daily tracking report
/serp-monitor --report daily --alert-threshold 5

# Find link prospects
/link-prospecting "content marketing" --min-da 40 --type guest-post
 
# With outreach templates
/link-prospecting "saas tools" --min-da 50 --include-templates

# Analyze page speed
/page-speed-seo https://example.com/page
 
# Focus on specific metrics
/page-speed-seo https://example.com --metrics "lcp,cls,fid"

🔴 Critical Issues (Ranking Impact: High)
- LCP: 4.2s (Target: <2.5s) — Largest image unoptimized
- CLS: 0.28 (Target: <0.1) — Layout shifts from ad injection

🟠 Medium Issues (Ranking Impact: Medium)
- FID: 180ms (Target: <100ms) — Heavy JavaScript blocking
- Render-blocking resources: 8 scripts, 4 stylesheets

🟡 Minor Issues (Ranking Impact: Low)
- Image format optimization opportunity: 12 images
- Server response time: 320ms (Target: <200ms)

# Local SEO check
/local-seo "Business Name" --location "City, State"
 
# Citation audit
/local-seo "Business Name" --focus citations --export csv

# Generate calendar
/content-calendar --topics "email marketing,automation,analytics" --duration 3months
 
# With seasonality data
/content-calendar --topics "tax software" --duration 12months --include-trends

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

① Technical Audit          — crawl & identify issues
② Keyword Research         — build comprehensive keyword map
③ Competitor Analysis      — identify gaps & opportunities
④ Content Audit            — score existing content
⑤ On-Page Optimization     — title, meta, headers
⑥ Internal Linking         — build topical authority
⑦ Schema Implementation    — structured data markup
⑧ Core Web Vitals Fix      — performance optimization
⑨ Content Strategy         — brief creation & calendar
⑩ Link Building Plan       — prospect list & outreach
⑪ Tracking Setup           — analytics & monitoring
⑫ Reporting Dashboard      — ongoing measurement

/workflows:launch-seo https://staging.example.com --production example.com

/workflows:content-refresh https://example.com --timeframe 12months

/workflows:authority-building --topic "sustainable technology" --duration 6months

/workflows:ai-content-pipeline --keywords-file keywords.csv --output-dir ./content

Keyword Input → Brief Generation → Outline Creation → 
Draft Writing → SEO Optimization → Quality Check → 
Publishing Prep → Performance Tracking

# ~/.seo-skills-config.yaml
defaults:
  export_format: csv
  min_domain_authority: 40
  target_word_count_range: [1500, 2500]
  
api_keys:
  serp_api: ${SERP_API_KEY}
  semrush_api: ${SEMRUSH_API_KEY}
  ahrefs_api: ${AHREFS_API_KEY}
  
monitoring:
  alert_threshold: 5  # positions
  check_frequency: daily
  
content_calendar:
  default_duration: 3months
  include_seasonality: true

export SERP_API_KEY="your_serp_api_key"
export SEMRUSH_API_KEY="your_semrush_key"
export AHREFS_API_KEY="your_ahrefs_key"
export OPENAI_API_KEY="your_openai_key"  # for AI content features

# Step 1: Pre-launch technical validation
/workflows:launch-seo https://staging.site.com --production site.com
 
# Step 2: Initial keyword research
/keyword-research "primary topic" --depth deep --export keywords.csv
 
# Step 3: Content calendar creation
/content-calendar --topics-file keywords.csv --duration 6months
 
# Step 4: Set up monitoring
/serp-monitor --keywords-file keywords.csv --domain site.com --alert-threshold 10

# Step 1: Comprehensive audit
/workflows:full-seo-sprint https://existing-site.com --scope full
 
# Step 2: Competitor gap analysis
/competitor-gap https://existing-site.com --competitors "comp1.com,comp2.com"
 
# Step 3: Content refresh for declining pages
/workflows:content-refresh https://existing-site.com --timeframe 6months
 
# Step 4: Link building campaign
/workflows:authority-building --topic "industry topic" --duration 3months

# Step 1: Research keywords
/keyword-research "content topic" --export opportunities.csv
 
# Step 2: Generate briefs
for keyword in $(cat opportunities.csv); do
  /content-brief "$keyword" --output "./briefs/${keyword}.md"
done
 
# Step 3: Run content pipeline
/workflows:ai-content-pipeline --keywords-file opportunities.csv --output-dir ./content

# Step 1: Local audit
/local-seo "Business Name" --location "City, State" --export local-audit.csv
 
# Step 2: Citation building
/local-seo "Business Name" --focus citations --action build
 
# Step 3: Local keyword research
/keyword-research "service near me" --location "City, State" --type local
 
# Step 4: GMB optimization
/local-seo "Business Name" --optimize-gmb --include-posts

# Add delays between requests
/keyword-research "topic" --rate-limit 2  # 2 seconds between calls
 
# Use cached results when available
/content-audit https://site.com --use-cache --cache-duration 24h

# Limit crawl scope
/technical-seo https://large-site.com --max-pages 1000
 
# Focus on specific sections
/content-audit https://large-site.com/blog --scope section
 
# Use sitemap for targeted analysis
/technical-seo https://large-site.com --source sitemap

# Specify location and device
/serp-monitor --keywords "keyword" --location "US" --device desktop
 
# Use multiple data sources
/keyword-research "topic" --sources "semrush,ahrefs,serp-api"
 
# Enable result verification
/competitor-gap https://site.com --verify-results --confidence 95

# Stream results instead of batch
/content-audit https://site.com --stream --output csv
 
# Process in chunks
/technical-seo https://site.com --chunk-size 100 --output-per-chunk
 
# Use compression
/keyword-research "topic" --depth deep --export compressed --format json.gz

# Install gspread (if using Python backend)
pip install gspread oauth2client
 
# Export keyword research
/keyword-research "topic" --export gsheet --sheet-id ${GOOGLE_SHEET_ID}

# Configure webhook
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."
 
# Enable alerts
/serp-monitor --keywords-file keywords.csv --alert slack --threshold 5

# .github/workflows/seo-monitor.yml
name: Daily SEO Check
on:
  schedule:
    - cron: '0 9 * * *'  # 9 AM daily
jobs:
  seo-audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run technical audit
        run: /technical-seo https://site.com --output report.json
      - name: Upload report
        uses: actions/upload-artifact@v2
        with:
          name: seo-report
          path: report.json

# Markdown (default)
/keyword-research "topic" --output md
 
# CSV for spreadsheets
/content-audit https://site.com --output csv
 
# JSON for programmatic use
/technical-seo https://site.com --output json
 
# HTML report
/competitor-gap https://site.com --output html --include-charts