Content SEO Optimizer

Your content, discovered. This skill audits your published content against SERP competitors and generates a prioritized optimization roadmap.

When to Use

Scenario Use This Skill?

Before publishing a blog post Yes - optimize before going live

After publishing, low traffic Yes - diagnose and fix

YouTube video optimization Yes - title, description, tags

Newsletter landing page Yes - improve discoverability

Academic/medical content Yes - with medical keyword focus

How It Works

YOUR CONTENT URL │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ AGENT 1: PAGE AUDITOR │ │ │ │ • Scrapes your page (Firecrawl/WebFetch) │ │ • Extracts: title, meta, headings, word count, links │ │ • Identifies: primary keyword, secondary keywords │ │ • Flags: technical issues, content gaps │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ AGENT 2: SERP ANALYST │ │ │ │ • Searches Google/Perplexity for your primary keyword │ │ • Analyzes top 10 competitors │ │ • Extracts: title patterns, content formats, themes │ │ • Identifies: differentiation opportunities │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ AGENT 3: OPTIMIZATION ADVISOR │ │ │ │ • Synthesizes audit + SERP data │ │ • Generates McKinsey-style recommendations │ │ • Prioritizes: P0 (critical), P1 (important), P2 (nice) │ │ • Outputs: actionable report with expected impact │ └─────────────────────────────────────────────────────────────┘ │ ▼ SEO AUDIT REPORT (Markdown)

Usage

In Claude Code (Recommended)

Audit SEO for https://yoursite.com/article-about-statins

or

Use content-seo-optimizer for my blog post: [URL]

For YouTube Content

Optimize SEO for my YouTube video: https://youtube.com/watch?v=xxxxx

Claude will:

• Fetch the video page

• Analyze title, description, tags

• Research competing videos

• Suggest optimizations

CLI Mode

python skills/cardiology/content-seo-optimizer/scripts/seo_audit.py
--url "https://yoursite.com/article"
--keyword "statins cardiovascular risk" # Optional override

Output: SEO Audit Report

SEO Audit Report

URL: https://yoursite.com/statin-myths-debunked Audit Date: 2026-01-01 Primary Keyword: statin myths

Executive Summary

Your article targets "statin myths" with moderate optimization. The title is strong but meta description is missing key terms. Competitors are using listicle formats (5 myths, 7 facts) which you should consider adopting. Word count (1,200) is below competitor average (2,100).

Overall Score: 65/100 Quick Wins Available: 3 changes could boost score to 80+

Technical & On-Page Findings

Title Tag

Current: "Debunking Statin Myths - Dr. Singh" Length: 38 characters (optimal: 50-60) Recommendation: "7 Statin Myths Exposed: Cardiologist Reveals Truth [2026]" Rationale: Add number, year, and authority signal

Meta Description

Current: [MISSING] Recommendation: "Interventional cardiologist debunks the 7 most dangerous statin myths. Evidence-based analysis of side effects, muscle pain, and who really needs statins." Length: 158 characters (optimal)

Heading Structure

• H1: ✅ Present ("Debunking Statin Myths")
• H2s: ⚠️ Only 2 (competitors average 7)
• H3s: ❌ None (add for each myth)

Content Depth

• Your word count: 1,200
• Competitor average: 2,100
• Gap: 900 words
• Recommendation: Expand with clinical evidence, patient stories

Link Profile

• Internal links: 3 (low - aim for 8-10)
• External links: 2 (good - both to journals)
• Suggested internal links:
  • Your article on LDL targets
  • Your cholesterol video
  • Your cardiovascular risk calculator

Keyword Analysis

Primary Keyword

Target: "statin myths" Search Volume: ~2,400/month Competition: Medium Your Current Ranking: Not in top 100

Secondary Keywords (add to content)

• statin side effects myths (1,200/mo)
• do statins cause muscle pain (800/mo)
• statin benefits vs risks (600/mo)
• should I take statins (1,500/mo)

Search Intent

Dominant: Informational User Need: Reassurance, evidence-based answers Content Angle: Counter misinformation with authority

Competitive SERP Analysis

Top 5 Competitors

Patterns in Top Results

• Titles: Numbers (5, 7), emotional words (truth, exposed, kill)
• Formats: Listicles dominate (4 of 5)
• Authority: Medical credentials mentioned (Harvard, MD)
• Length: All 1,800+ words

People Also Ask

• Are statin side effects exaggerated?
• What are the real risks of statins?
• Do statins cause memory loss?
• Should everyone over 50 take statins?

Your Differentiation Opportunity

• Angle: Active interventional cardiologist perspective
• Unique: Real cath lab stories, patient outcomes
• Voice: Hinglish content not available in English SERP

Prioritized Recommendations

P0 - Critical (Do This Week)

P1 - Important (Do This Month)

P2 - Nice to Have

Next Steps

1. Immediate: Add meta description (5 minutes)
2. This week: Restructure as "7 Statin Myths" listicle
3. This month: Expand content with evidence + FAQ schema
4. Measure: Check ranking in 2-4 weeks
5. Iterate: Re-audit after changes

Measurement Plan

Medical Content Specific Features

Pre-configured Medical Keywords

The skill understands medical/cardiology context:

Your Topic Suggested Keywords

Statins statin myths, statin side effects, cholesterol medication

SGLT2 SGLT2 inhibitors, diabetes heart medication, Jardiance benefits

Heart failure heart failure treatment, ejection fraction, HFpEF

CAC scoring coronary calcium score, heart scan, cardiac CT

Blood pressure hypertension treatment, high blood pressure medication

Medical Authority Signals

Recommendations include:

• Adding MD/cardiologist credentials to title/bio

• Citing PubMed studies (with PMIDs)

• Referencing guidelines (ACC/AHA/ESC)

• Medical schema markup

Integration with Other Skills

Pre-Publish Workflow

1. Write content with cardiology-newsletter-writer
2. Research with quick-topic-researcher (PMIDs)
3. Check with viral-content-predictor (engagement score)
4. Audit with content-seo-optimizer (SEO score) ← This skill
5. Refine based on recommendations
6. Publish

Post-Publish Workflow

1. Publish content
2. Wait 2-4 weeks for indexing
3. Audit with content-seo-optimizer
4. Implement P0/P1 recommendations
5. Re-audit in 4 weeks

Technical Architecture

Tools Used

Tool Purpose Fallback

Firecrawl MCP Page scraping WebFetch

Perplexity MCP SERP research WebSearch

Claude Analysis & report

Dependencies

Optional - for CLI mode with Firecrawl

pip install firecrawl-py

For Google ADK version (advanced)

pip install google-adk pydantic>=2.7.0

API Keys

Key Purpose Required?

FIRECRAWL_API_KEY Page scraping Optional (use WebFetch fallback)

GOOGLE_API_KEY SERP research Already have

PERPLEXITY_API_KEY Alternative SERP Already have

Comparison with Paid Tools

Feature This Skill Ahrefs ($99/mo) Semrush ($119/mo)

Page audit ✅ ✅ ✅

SERP analysis ✅ ✅ ✅

Keyword suggestions ✅ ✅ ✅

Competitor analysis ✅ ✅ ✅

Medical context ✅ ❌ ❌

Integrated with your content system ✅ ❌ ❌

Cost $0 $99/mo $119/mo

Example Session

User: Audit SEO for https://drshailesh.com/statin-myths

Claude:

I'll perform a comprehensive SEO audit using the 3-agent pipeline.

Agent 1: Page Auditor [Fetches page, extracts structure, identifies keywords]

Agent 2: SERP Analyst [Researches "statin myths", analyzes top 10 competitors]

Agent 3: Optimization Advisor [Synthesizes findings into prioritized report]

SEO Audit Report

[Full report as shown above]

Quick Wins You Can Do Right Now:

• Add meta description (copy from report)

• Add [2026] to title

• Change H1 to "7 Statin Myths..."

Would you like me to help implement any of these changes?

This skill turns your great content into discoverable content.