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.
Clarify First
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.
Workflow
- Run technical audit - Check crawlability (robots.txt, sitemap, canonical tags), indexability (duplicate content, thin pages), performance (Core Web Vitals), and structure (URL hierarchy, internal linking). Checkpoint: zero critical crawl errors in Search Console.
- Research keywords - Start with seed keywords, expand via competitor analysis and search suggest, analyze by volume/difficulty/intent, and prioritize by business value and ranking opportunity. Checkpoint: each target keyword has a mapped content asset.
- Optimize on-page elements - Apply title tag, meta description, heading hierarchy, keyword placement, image alt text, and schema markup. Checkpoint: primary keyword appears in H1, first 100 words, and title tag.
- Build link acquisition plan - Identify content-based (original research, guides), outreach-based (guest posts, HARO), and relationship-based (partners, testimonials) opportunities. Checkpoint: target links have DA 50+ and topical relevance.
- Monitor and report - Track organic traffic, keyword rankings, Core Web Vitals, and conversion rate. Review weekly; report monthly. Checkpoint: dashboard covers visibility, engagement, and conversions.
Technical SEO Audit Checklist
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:
Keyword Research Process
- Seed - Brainstorm topics, analyze competitors, mine customer interviews
- Expand - Use Ahrefs/SEMrush, Google Suggest, People Also Ask, related searches
- Analyze - Score by search volume, keyword difficulty, search intent, SERP features
- Prioritize - Rank by business value x ranking opportunity
Keyword Metrics Guide
| Metric |
Good |
Moderate |
Difficult |
| Volume |
1000+ |
100-1000 |
< 100 |
| Difficulty |
< 30 |
30-60 |
> 60 |
| CPC (commercial signal) |
> $5 |
$1-5 |
< $1 |
Search Intent Classification
| 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 |
On-Page Optimization Checklist
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
Example: Optimized Page Structure
<!-- 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>
Link Quality Assessment
| 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 Dashboard
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
Scripts
# 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
Reference Materials
references/technical_seo.md - Technical SEO guide
references/keyword_research.md - Keyword research methods
references/link_building.md - Link building playbook
references/algorithm_updates.md - Google update history
Troubleshooting
| 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 |
Success Criteria
- Organic traffic growth: 10%+ month-over-month organic traffic growth sustained over 6 months
- Top 10 rankings: 50%+ of target keywords ranking in top 10 positions within 6 months
- Core Web Vitals: All three metrics passing (LCP < 2.5s, INP < 200ms, CLS < 0.1) at 75th percentile — only 47-55% of sites achieve this in 2026
- CTR performance: Position 1 achieving 25%+ CTR, position 3 achieving 10%+ CTR (2026 benchmarks)
- Conversion from organic: Organic traffic converting at 2%+ for B2B, 2.5%+ for e-commerce (industry benchmarks)
- Indexation health: 95%+ of target pages indexed with zero critical crawl errors
- E-E-A-T compliance: Author bylines, credentials, and experience signals on 100% of content pages
Scope & Limitations
In scope:
- Technical SEO auditing (crawlability, indexation, Core Web Vitals, site structure)
- Keyword research, intent classification, and prioritization
- On-page optimization (title tags, meta descriptions, headings, content, schema)
- Link building strategy and opportunity identification
- Organic search performance monitoring and reporting
- Algorithm update impact assessment and recovery planning
Out of scope:
- Paid search / Google Ads management
- Social media marketing and optimization
- Content writing and production (use Content Production skill)
- AI-specific search optimization (use AI SEO skill)
- Website development or code deployment
- Brand strategy and positioning
Known limitations:
- Keyword difficulty scores vary significantly across tools — no single source of truth
- Google algorithm changes 500-600 times per year; strategies require continuous adaptation
- AI Overviews are reducing organic CTR — position 1 no longer guarantees high click volume
- Backlink analysis requires third-party tools (Ahrefs, SEMrush, Moz) for comprehensive data
- INP optimization often requires developer involvement for JavaScript refactoring
Integration Points
- SEO Audit — Use for comprehensive 85-point site audits when detailed diagnostic is needed.
- AI SEO — Use alongside traditional SEO for AI search citation optimization.
- Schema Markup — Use for structured data implementation after on-page optimization.
- Site Architecture — Use when structural issues (deep nesting, orphan pages) block ranking progress.
- Content Strategy — Use for topic selection and editorial calendar planning before SEO optimization.
- Content Humanizer — Use when content flagged as AI-generated needs authenticity improvement.
Scripts
# 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
1---2name: seo-specialist-33description: 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.4license: MIT + Commons Clause5---6# SEO Specialist
7
8The 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.
9
10## Clarify First
11
12Before starting, confirm these inputs. If any is unknown or vague, ASK — do not assume:
13
14- [ ] **Deliverable** — technical audit, keyword research, on-page optimization, link plan, or performance report — selects which workflow runs
15- [ ] **Domain & seed topics/keywords** — the site and the terms you want to rank for — drives keyword research and prioritization
16- [ ] **Business goal** — the conversion or revenue outcome behind ranking — sets prioritization by business value × ranking opportunity
17
18Stop 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.
19
20## Workflow
21
221. **Run technical audit** - Check crawlability (robots.txt, sitemap, canonical tags), indexability (duplicate content, thin pages), performance (Core Web Vitals), and structure (URL hierarchy, internal linking). Checkpoint: zero critical crawl errors in Search Console.
232. **Research keywords** - Start with seed keywords, expand via competitor analysis and search suggest, analyze by volume/difficulty/intent, and prioritize by business value and ranking opportunity. Checkpoint: each target keyword has a mapped content asset.
243. **Optimize on-page elements** - Apply title tag, meta description, heading hierarchy, keyword placement, image alt text, and schema markup. Checkpoint: primary keyword appears in H1, first 100 words, and title tag.
254. **Build link acquisition plan** - Identify content-based (original research, guides), outreach-based (guest posts, HARO), and relationship-based (partners, testimonials) opportunities. Checkpoint: target links have DA 50+ and topical relevance.
265. **Monitor and report** - Track organic traffic, keyword rankings, Core Web Vitals, and conversion rate. Review weekly; report monthly. Checkpoint: dashboard covers visibility, engagement, and conversions.
27
28## Technical SEO Audit Checklist
29
30**Crawlability:**
31- [ ] Robots.txt properly configured
32- [ ] XML sitemap submitted and current
33- [ ] No critical crawl errors in Search Console
34- [ ] Canonical tags on all indexable pages
35- [ ] Noindex/nofollow used correctly
36
37**Performance (Core Web Vitals):**
38
39| Metric | Good | Needs Improvement | Poor |
40|--------|------|-------------------|------|
41| LCP (Largest Contentful Paint) | < 2.5s | 2.5s - 4s | > 4s |
42| FID (First Input Delay) | < 100ms | 100 - 300ms | > 300ms |
43| CLS (Cumulative Layout Shift) | < 0.1 | 0.1 - 0.25 | > 0.25 |
44
45**Structure:**
46- [ ] Clean, descriptive URL slugs
47- [ ] Proper heading hierarchy (single H1, logical H2/H3)
48- [ ] Internal linking between related content
49- [ ] Breadcrumbs implemented
50
51## Keyword Research Process
52
531. **Seed** - Brainstorm topics, analyze competitors, mine customer interviews
542. **Expand** - Use Ahrefs/SEMrush, Google Suggest, People Also Ask, related searches
553. **Analyze** - Score by search volume, keyword difficulty, search intent, SERP features
564. **Prioritize** - Rank by business value x ranking opportunity
57
58### Keyword Metrics Guide
59
60| Metric | Good | Moderate | Difficult |
61|--------|------|----------|-----------|
62| Volume | 1000+ | 100-1000 | < 100 |
63| Difficulty | < 30 | 30-60 | > 60 |
64| CPC (commercial signal) | > $5 | $1-5 | < $1 |
65
66### Search Intent Classification
67
68| Intent | Signal Words | Content Type |
69|--------|-------------|-------------|
70| Informational | "how to", "what is", "guide" | Blog posts, tutorials |
71| Navigational | Brand names, product names | Homepage, product pages |
72| Commercial | "best", "reviews", "vs" | Comparison pages, reviews |
73| Transactional | "buy", "discount", "pricing" | Product pages, landing pages |
74
75## On-Page Optimization Checklist
76
77**Title Tag:** primary keyword front-loaded, 50-60 characters, compelling for CTR
78**Meta Description:** includes keyword, clear value prop, CTA, 150-160 characters
79**Headings:** H1 contains primary keyword, H2s contain secondary keywords, logical hierarchy
80**Content:** keyword in first 100 words, natural density, related terms (LSI), comprehensive coverage
81**Images:** descriptive filenames, keyword-rich alt text, compressed, lazy-loaded
82
83## Example: Optimized Page Structure
84
85```html
86<!-- Title: 58 chars, keyword front-loaded -->
87<title>Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%</title>
88
89<!-- Meta: 155 chars, keyword + value prop + CTA -->
90<meta name="description" content="Learn 7 proven cloud cost optimization
91strategies used by 500+ engineering teams. Reduce AWS spend by 40% without
92sacrificing performance. Free checklist inside.">
93
94<!-- Schema markup for article -->
95<script type="application/ld+json">
96{
97 "@context": "https://schema.org",
98 "@type": "Article",
99 "headline": "Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%",
100 "author": {"@type": "Person", "name": "Jane Chen"},
101 "datePublished": "2026-02-15",
102 "publisher": {
103 "@type": "Organization",
104 "name": "CloudOps Weekly"
105 }
106}
107</script>
108
109<h1>Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%</h1>
110<p>Cloud cost optimization is the #1 priority for engineering leaders in 2026...</p>
111
112<h2>1. Right-Size EC2 Instances Using Usage Data</h2>
113<h3>How to Identify Oversized Instances</h3>
114
115<h2>FAQ</h2>
116<h3>What is cloud cost optimization?</h3>
117<h3>How much can cloud optimization save?</h3>
118```
119
120## Link Quality Assessment
121
122| Factor | High Quality | Low Quality |
123|--------|-------------|-------------|
124| Domain Authority | 50+ | < 20 |
125| Relevance | Same industry | Unrelated |
126| Traffic | Active site | Dead site |
127| Link Type | Editorial | Paid/Spam |
128| Anchor Text | Natural variation | Exact match spam |
129
130## SEO Performance Dashboard
131
132```
133SEO Performance - March 2026
134 Organic Traffic: 125,432 (+12% MoM)
135 Rankings: Top 3: 45 | Top 10: 234
136 Conversions: 542 (+15% MoM)
137
138 Top Growing Keywords
139 1. "cloud cost optimization" - #8 -> #3 (+5)
140 2. "aws billing alerts" - #15 -> #7 (+8)
141 3. "kubernetes autoscaling" - New -> #12
142
143 Technical Health
144 Core Web Vitals: Pass | Index: 1,234 pages | Crawl Errors: 3
145```
146
147## Scripts
148
149```bash
150# Site audit
151python scripts/site_audit.py --url https://example.com --output audit.html
152
153# Keyword research
154python scripts/keyword_research.py --seed "cloud computing" --output keywords.csv
155
156# Rank tracker
157python scripts/rank_tracker.py --keywords keywords.csv --domain example.com
158
159# Backlink analyzer
160python scripts/backlink_analyzer.py --domain example.com --output links.csv
161```
162
163## Reference Materials
164
165- `references/technical_seo.md` - Technical SEO guide
166- `references/keyword_research.md` - Keyword research methods
167- `references/link_building.md` - Link building playbook
168- `references/algorithm_updates.md` - Google update history
169
170---
171
172## Troubleshooting
173
174| Problem | Likely Cause | Fix |
175|---------|-------------|-----|
176| 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 |
177| 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 |
178| 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 |
179| 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 |
180| 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 |
181| 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 |
182
183---
184
185## Success Criteria
186
187- **Organic traffic growth**: 10%+ month-over-month organic traffic growth sustained over 6 months
188- **Top 10 rankings**: 50%+ of target keywords ranking in top 10 positions within 6 months
189- **Core Web Vitals**: All three metrics passing (LCP < 2.5s, INP < 200ms, CLS < 0.1) at 75th percentile — only 47-55% of sites achieve this in 2026
190- **CTR performance**: Position 1 achieving 25%+ CTR, position 3 achieving 10%+ CTR (2026 benchmarks)
191- **Conversion from organic**: Organic traffic converting at 2%+ for B2B, 2.5%+ for e-commerce (industry benchmarks)
192- **Indexation health**: 95%+ of target pages indexed with zero critical crawl errors
193- **E-E-A-T compliance**: Author bylines, credentials, and experience signals on 100% of content pages
194
195---
196
197## Scope & Limitations
198
199**In scope:**
200- Technical SEO auditing (crawlability, indexation, Core Web Vitals, site structure)
201- Keyword research, intent classification, and prioritization
202- On-page optimization (title tags, meta descriptions, headings, content, schema)
203- Link building strategy and opportunity identification
204- Organic search performance monitoring and reporting
205- Algorithm update impact assessment and recovery planning
206
207**Out of scope:**
208- Paid search / Google Ads management
209- Social media marketing and optimization
210- Content writing and production (use Content Production skill)
211- AI-specific search optimization (use AI SEO skill)
212- Website development or code deployment
213- Brand strategy and positioning
214
215**Known limitations:**
216- Keyword difficulty scores vary significantly across tools — no single source of truth
217- Google algorithm changes 500-600 times per year; strategies require continuous adaptation
218- AI Overviews are reducing organic CTR — position 1 no longer guarantees high click volume
219- Backlink analysis requires third-party tools (Ahrefs, SEMrush, Moz) for comprehensive data
220- INP optimization often requires developer involvement for JavaScript refactoring
221
222---
223
224## Integration Points
225
226- **SEO Audit** — Use for comprehensive 85-point site audits when detailed diagnostic is needed.
227- **AI SEO** — Use alongside traditional SEO for AI search citation optimization.
228- **Schema Markup** — Use for structured data implementation after on-page optimization.
229- **Site Architecture** — Use when structural issues (deep nesting, orphan pages) block ranking progress.
230- **Content Strategy** — Use for topic selection and editorial calendar planning before SEO optimization.
231- **Content Humanizer** — Use when content flagged as AI-generated needs authenticity improvement.
232
233---
234
235## Scripts
236
237```bash
238# Analyze keyword list for search intent and difficulty
239python scripts/keyword_analyzer.py --keywords keywords.csv --json
240
241# Simulate SERP appearance for a page
242python scripts/serp_simulator.py --title "Cloud Cost Optimization Guide" --description "Learn 7 proven strategies..." --url "/guides/cloud-cost" --json
243
244# Score content for on-page SEO quality
245python scripts/content_scorer.py article.md --keyword "cloud cost optimization" --json
246```