borghei/seo-specialist
> SEO covering technical SEO, content optimization, link building, keyword research, and search analytics. Use when auditing technical SEO, researching keywords, optimizing on-page elements, or analyzing organic search performance.
npx skills add https://github.com/borghei/Claude-Skills --skill seo-specialist
The agent operates as a senior SEO specialist, delivering technical audits, keyword strategies, on-page optimization, link building plans, and performance analysis for organic search growth.
Before starting, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Crawlability:
Performance (Core Web Vitals):
| Metric | Good | Needs Improvement | Poor |
|--------|------|-------------------|------|
| LCP (Largest Contentful Paint) | < 2.5s | 2.5s - 4s | > 4s |
| FID (First Input Delay) | < 100ms | 100 - 300ms | > 300ms |
| CLS (Cumulative Layout Shift) | < 0.1 | 0.1 - 0.25 | > 0.25 |
Structure:
| Metric | Good | Moderate | Difficult |
|--------|------|----------|-----------|
| Volume | 1000+ | 100-1000 | < 100 |
| Difficulty | < 30 | 30-60 | > 60 |
| CPC (commercial signal) | > $5 | $1-5 | < $1 |
| Intent | Signal Words | Content Type |
|--------|-------------|-------------|
| Informational | "how to", "what is", "guide" | Blog posts, tutorials |
| Navigational | Brand names, product names | Homepage, product pages |
| Commercial | "best", "reviews", "vs" | Comparison pages, reviews |
| Transactional | "buy", "discount", "pricing" | Product pages, landing pages |
Title Tag: primary keyword front-loaded, 50-60 characters, compelling for CTR
Meta Description: includes keyword, clear value prop, CTA, 150-160 characters
Headings: H1 contains primary keyword, H2s contain secondary keywords, logical hierarchy
Content: keyword in first 100 words, natural density, related terms (LSI), comprehensive coverage
Images: descriptive filenames, keyword-rich alt text, compressed, lazy-loaded
<!-- Title: 58 chars, keyword front-loaded -->
<title>Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%</title>
<!-- Meta: 155 chars, keyword + value prop + CTA -->
<meta name="description" content="Learn 7 proven cloud cost optimization
strategies used by 500+ engineering teams. Reduce AWS spend by 40% without
sacrificing performance. Free checklist inside.">
<!-- Schema markup for article -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%",
"author": {"@type": "Person", "name": "Jane Chen"},
"datePublished": "2026-02-15",
"publisher": {
"@type": "Organization",
"name": "CloudOps Weekly"
}
}
</script>
<h1>Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%</h1>
<p>Cloud cost optimization is the #1 priority for engineering leaders in 2026...</p>
<h2>1. Right-Size EC2 Instances Using Usage Data</h2>
<h3>How to Identify Oversized Instances</h3>
<h2>FAQ</h2>
<h3>What is cloud cost optimization?</h3>
<h3>How much can cloud optimization save?</h3>
| Factor | High Quality | Low Quality |
|--------|-------------|-------------|
| Domain Authority | 50+ | < 20 |
| Relevance | Same industry | Unrelated |
| Traffic | Active site | Dead site |
| Link Type | Editorial | Paid/Spam |
| Anchor Text | Natural variation | Exact match spam |
SEO Performance - March 2026
Organic Traffic: 125,432 (+12% MoM)
Rankings: Top 3: 45 | Top 10: 234
Conversions: 542 (+15% MoM)
Top Growing Keywords
1. "cloud cost optimization" - #8 -> #3 (+5)
2. "aws billing alerts" - #15 -> #7 (+8)
3. "kubernetes autoscaling" - New -> #12
Technical Health
Core Web Vitals: Pass | Index: 1,234 pages | Crawl Errors: 3
# Site audit
python scripts/site_audit.py --url https://example.com --output audit.html
# Keyword research
python scripts/keyword_research.py --seed "cloud computing" --output keywords.csv
# Rank tracker
python scripts/rank_tracker.py --keywords keywords.csv --domain example.com
# Backlink analyzer
python scripts/backlink_analyzer.py --domain example.com --output links.csv
references/technical_seo.md - Technical SEO guidereferences/keyword_research.md - Keyword research methodsreferences/link_building.md - Link building playbookreferences/algorithm_updates.md - Google update history| Problem | Likely Cause | Fix |
|---------|-------------|-----|
| Rankings dropped after Google core update | E-E-A-T signals insufficient or content quality below new thresholds | Audit content against December 2025 / March 2026 core update criteria — add experience signals, author credentials, original data |
| High impressions but low CTR | Title tags and meta descriptions not compelling enough for the SERP | Rewrite titles with numbers, power words, and clear value props; test meta descriptions with hooks |
| FID replaced by INP — pages now failing CWV | INP measures all interactions, not just first — JS-heavy pages fail | Break long JS tasks, defer third-party scripts, audit event handlers; 43% of sites still fail INP in 2026 |
| Indexed pages declining in Search Console | Google tightening quality bar — deindexing thin or duplicate content | Consolidate thin pages, add unique content, improve E-E-A-T signals on remaining pages |
| AI Overviews stealing clicks from position 1 | Google AI Overviews now appear in 50%+ of queries, reducing organic CTR by ~42% | Optimize for AI citation (extractable content blocks), add FAQ schema, target queries less likely to trigger AI Overviews |
| Keyword cannibalization across blog and product pages | Multiple pages competing for same keyword with conflicting intent | Map one primary keyword per page, consolidate or redirect competing pages, differentiate intent |
In scope:
Out of scope:
Known limitations:
# Analyze keyword list for search intent and difficulty
python scripts/keyword_analyzer.py --keywords keywords.csv --json
# Simulate SERP appearance for a page
python scripts/serp_simulator.py --title "Cloud Cost Optimization Guide" --description "Learn 7 proven strategies..." --url "/guides/cloud-cost" --json
# Score content for on-page SEO quality
python scripts/content_scorer.py article.md --keyword "cloud cost optimization" --json
Take borghei/seo-specialist from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.