Agent-Skills.md

Agent Skills: Content SEO Optimizer

Three-agent SEO audit pipeline. Scrapes your content → analyzes SERP competitors → generates prioritized optimization report with P0/P1/P2 recommendations. Use BEFORE and AFTER publishing to maximize organic reach.

UncategorizedID: drshailesh88/integrated_content_OS/content-seo-optimizer
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/drshailesh88/integrated_content_OS/tree/HEAD/skills/cardiology/content-seo-optimizer

Skill Files

Browse the full folder contents for content-seo-optimizer.

Download Skill

Loading file tree…

skills/cardiology/content-seo-optimizer/SKILL.md

Skill Metadata

Name
content-seo-optimizer
Description
"Three-agent SEO audit pipeline. Scrapes your content → analyzes SERP competitors → generates prioritized optimization report with P0/P1/P2 recommendations. Use BEFORE and AFTER publishing to maximize organic reach."

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:

  1. Fetch the video page
  2. Analyze title, description, tags
  3. Research competing videos
  4. 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

| Rank | Title | Word Count | Format |
|------|-------|------------|--------|
| 1 | "5 Statin Myths That Could Kill You" | 2,400 | Listicle |
| 2 | "The Truth About Statins: What You Need to Know" | 1,800 | Guide |
| 3 | "Statin Myths and Facts - Harvard Health" | 2,100 | FAQ |
| 4 | "7 Common Statin Myths Exposed" | 1,900 | Listicle |
| 5 | "Statins: Benefits, Risks, and Myths" | 2,500 | Comprehensive |

### 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)

| Action | Rationale | Impact | Effort |
|--------|-----------|--------|--------|
| Add meta description | Missing entirely - major SEO gap | High | Low |
| Restructure as listicle (7 myths) | Top 4 competitors use this format | High | Medium |
| Add year to title [2026] | Freshness signal, higher CTR | Medium | Low |

### P1 - Important (Do This Month)

| Action | Rationale | Impact | Effort |
|--------|-----------|--------|--------|
| Expand to 2,000+ words | Below competitor average by 900 | High | Medium |
| Add FAQ schema | Capture People Also Ask | Medium | Low |
| Add 5+ internal links | Low link density hurting authority | Medium | Low |
| Include patient stories | Differentiation + engagement | Medium | Medium |

### P2 - Nice to Have

| Action | Rationale | Impact | Effort |
|--------|-----------|--------|--------|
| Add video embed | Mixed media boosts dwell time | Low | Low |
| Create infographic | Shareable, backlink potential | Medium | High |
| Hindi/Hinglish version | Capture India market gap | Medium | High |

---

## 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

| Metric | Current | Target | Timeline |
|--------|---------|--------|----------|
| Google ranking (primary KW) | 100+ | Top 20 | 4 weeks |
| Organic traffic | 0/month | 200/month | 8 weeks |
| CTR from search | N/A | 5%+ | 4 weeks |
| Avg. time on page | Unknown | 3+ min | 4 weeks |

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:

  1. Add meta description (copy from report)
  2. Add [2026] to title
  3. 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.