om-scogo 📈 SEO & Content Marketing Agent Skills
Skill by ara.so — Marketing Skills collection.
This skill suite provides 10 specialized SEO commands and 5 multi-step workflows for comprehensive search engine optimization and content marketing. Derived from VoltAgent/awesome-agent-skills, it implements structured analysis tools with visual progress tracking and actionable recommendations.
What This Skill Does
- 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 validation
- Competitor Analysis — backlink gaps, topic gaps, featured snippet opportunities
- Content Strategy — automated briefs, calendars, and publishing pipelines
- Local SEO — NAP consistency, GMB optimization, citation audits
- Performance Monitoring — rank tracking, volatility alerts, CTR optimization
Installation
# Clone the repository
git clone https://github.com/Gravityaespot/r16-voltagent-awesome-agent-skills-seo.git
# Navigate to the skill directory
cd r16-voltagent-awesome-agent-skills-seo
# Install to Claude Code skills directory
mkdir -p ~/.claude/skills/r16-voltagent-seo-content-marketing
cp -r . ~/.claude/skills/r16-voltagent-seo-content-marketing/
# Register the skill in your current session
# Use /read command to load SKILL.md
Core Commands
1. Keyword Research
Analyze search terms with clustering, difficulty scoring, and intent classification.
# Basic keyword research
/keyword-research "project management software"
# With advanced options
/keyword-research "email marketing" --depth deep --competitors 5 --export csv
Output structure:
┌─────────────────────────┬────────┬────────┬──────────┬──────────┐
│ 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 │
└─────────────────────────┴────────┴────────┴──────────┴──────────┘
2. Content Audit
Full-site content quality assessment with duplication and cannibalization detection.
# Audit entire site
/content-audit https://example.com --scope full
# Audit specific section
/content-audit https://example.com/blog --scope section --output md
Analysis includes:
- Content quality scores (0-100)
- Thin content detection (< 300 words)
- Duplicate/near-duplicate pages
- Keyword cannibalization matrix
- Missing meta elements
- Readability metrics
3. Technical SEO Audit
Crawl budget, indexability, schema markup, and Core Web Vitals analysis.
# Full technical audit
/technical-seo https://example.com
# Focus on specific areas
/technical-seo https://example.com --focus "core-web-vitals,schema"
Checks performed:
✓ 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
4. Competitor Gap Analysis
Identify backlink opportunities and content gaps versus competitors.
# 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
Output sections:
- Backlink Gap — domains linking to competitors but not you
- Topic Gap — keywords competitors rank for that you don't
- Featured Snippet Gap — SERP features you could target
- Content Format Gap — missing content types (videos, tools, etc.)
5. Content Brief Generation
AI-generated SEO content briefs with NLP terms and optimization targets.
# Generate content brief
/content-brief "how to automate email campaigns"
# With custom parameters
/content-brief "seo tools comparison" --word-count 2500 --competitors 5
Brief structure:
# 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]
6. SERP Monitoring
Track rankings with volatility detection and CTR optimization.
# Monitor keywords
/serp-monitor --keywords "keyword1,keyword2,keyword3" --domain example.com
# Daily tracking report
/serp-monitor --report daily --alert-threshold 5
7. Link Prospecting
Generate quality backlink prospect lists with DA/DR filters.
# 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
8. Page Speed SEO
Diagnose performance issues mapped to ranking impact.
# Analyze page speed
/page-speed-seo https://example.com/page
# Focus on specific metrics
/page-speed-seo https://example.com --metrics "lcp,cls,fid"
Diagnostic output:
🔴 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)
9. Local SEO Audit
NAP consistency, Google Business Profile optimization, citation audits.
# Local SEO check
/local-seo "Business Name" --location "City, State"
# Citation audit
/local-seo "Business Name" --focus citations --export csv
10. Content Calendar
Data-driven editorial calendar from search demand and seasonality.
# Generate calendar
/content-calendar --topics "email marketing,automation,analytics" --duration 3months
# With seasonality data
/content-calendar --topics "tax software" --duration 12months --include-trends
Multi-Step Workflows
Full SEO Sprint (12 steps)
Complete SEO transformation from audit to implementation.
/workflows:full-seo-sprint https://example.com --scope full
Workflow steps:
① 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
Launch SEO
Pre-launch checklist for new sites or major redesigns.
/workflows:launch-seo https://staging.example.com --production example.com
Validation checklist:
- ✓ Robots.txt configured correctly
- ✓ XML sitemap submitted
- ✓ Canonical tags implemented
- ✓ Hreflang tags (if multi-language)
- ✓ 301 redirects mapped
- ✓ Schema markup validated
- ✓ Analytics installed
- ✓ Search Console verified
- ✓ Core Web Vitals passing
Content Refresh
Identify and optimize underperforming content.
/workflows:content-refresh https://example.com --timeframe 12months
Process:
- Identify pages with ranking decline
- Analyze SERP changes & intent shifts
- Audit content quality & freshness
- Generate optimization recommendations
- Create update schedule
- Monitor post-refresh performance
Authority Building
End-to-end digital PR and link-building campaign.
/workflows:authority-building --topic "sustainable technology" --duration 6months
Campaign structure:
- Asset ideation (linkable content)
- Asset creation (data studies, tools, guides)
- Prospect research & qualification
- Outreach template creation
- Relationship building
- Link acquisition tracking
- Impact measurement
AI Content Pipeline
Automated content production from keyword to publish.
/workflows:ai-content-pipeline --keywords-file keywords.csv --output-dir ./content
Pipeline stages:
Keyword Input → Brief Generation → Outline Creation →
Draft Writing → SEO Optimization → Quality Check →
Publishing Prep → Performance Tracking
Configuration
Create a configuration file for persistent settings:
# ~/.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
Environment variables:
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
Common Patterns
Pattern 1: New Site Launch
# 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
Pattern 2: Existing Site Optimization
# 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
Pattern 3: Content Production
# 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
Pattern 4: Local Business SEO
# 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
Troubleshooting
Issue: Rate Limiting on API Calls
# 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
Issue: Large Site Crawl Timeout
# 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
Issue: Inconsistent SERP Data
# 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
Issue: Memory Usage on Large Exports
# 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
Integration Examples
Export to Google Sheets
# Install gspread (if using Python backend)
pip install gspread oauth2client
# Export keyword research
/keyword-research "topic" --export gsheet --sheet-id ${GOOGLE_SHEET_ID}
Slack Notifications
# Configure webhook
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."
# Enable alerts
/serp-monitor --keywords-file keywords.csv --alert slack --threshold 5
CI/CD Pipeline Integration
# .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
Output Formats
All commands support multiple output formats:
# 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
Best Practices
- Regular Audits — Schedule monthly technical and content audits
- Competitor Monitoring — Track top 3-5 competitors continuously
- Keyword Expansion — Refresh keyword research quarterly
- Content Updates — Refresh top 20% of content every 6 months
- Link Building — Consistent monthly outreach campaigns
- Performance Tracking — Daily rank monitoring for priority keywords
- Core Web Vitals — Monthly performance optimization checks
License
MIT — free to use, modify, and distribute.
Source: github.com/Gravityaespot/r16-voltagent-awesome-agent-skills-seo