SEO Technical and Marketing - Operational Skill
This skill contains actionable, production-ready systems for traditional search engine optimization:
- Technical SEO auditing (Core Web Vitals, crawlability, structured data, mobile optimization)
- SEO marketing strategy (keyword research, content planning, competitive analysis, brand building)
- Operational workflows (cross-team collaboration, stakeholder alignment, SEO OKRs)
- Total Search Optimization (Google, YouTube, Reddit, TikTok, forums, social SEO)
Structure: Technical fundamentals first -> Marketing strategy -> Operational execution -> Total Search Optimization.
For AI search optimization (ChatGPT, Perplexity, Gemini, AI Overviews, GEO): Use marketing-ai-search-optimization instead.
2026 Operating Assumptions (Evergreen)
- Prioritize usefulness and intent satisfaction; technical SEO cannot compensate for weak content.
- E-E-A-T matters most when claims can impact money, health, safety, or major decisions; for all niches, show real experience and verifiable proof where possible.
- Mobile-first is the default: performance, UX, and rendering on mobile are the primary gate.
- Crawl/indexation wins come from discoverability (internal links, sitemaps) and removing low-value crawl traps.
- Core Web Vitals are a weak signal but a strong tiebreaker; fix regressions and obvious failures.
- Structured data is for eligibility and rich results, not a ranking boost; use it to improve extraction and display.
- SERPs are multi-surface (web, video, local, forums, social); measure channel-by-channel, not only rankings.
Primary sources live in data/sources.json. For time-sensitive changes (core updates, reporting changes), use official sources first (Google Search Central / Search Status Dashboard); if your environment supports web search, refresh against current updates before giving definitive advice.
Key Thresholds (2026)
| Metric |
Target |
Impact |
| LCP |
< 2.5s |
Mobile-first indexing threshold |
| INP |
< 200ms |
Replaced FID; user engagement signal |
| CLS |
< 0.1 |
Layout stability; ranking factor |
| TTFB |
< 600ms |
Crawl rate: slow servers often reduce pages crawled/day |
| Mobile score |
> 90 |
Required for competitive rankings |
When NOT to Use
Quick Reference
| Task |
Resource/Template |
Location |
When to Use |
| Auditing |
|
|
|
| Full Technical Audit |
10-Point Checklist |
assets/audits/full-technical-audit.md |
Comprehensive site-wide audit |
| Quick Audit |
Abbreviated Checklist |
assets/audits/quick-audit-checklist.md |
Fast issue identification |
| Priority Matrix |
Impact vs Effort |
assets/priority/impact-effort-matrix.md |
Prioritize audit findings |
| Core Web Vitals |
|
|
|
| CWV Deep Dive |
CWV Guide |
references/core-web-vitals-guide.md |
LCP, INP, CLS optimization |
| CWV Report |
Report Template |
assets/cwv/core-web-vitals-report.md |
Document CWV findings |
| Crawlability |
|
|
|
| Indexation Issues |
Crawlability Guide |
references/crawlability-indexing.md |
Robots.txt, sitemaps, GSC issues |
| Indexation Acceleration |
Fast Indexing Guide |
references/crawlability-indexing.md#indexation-acceleration |
New/large sites, internal linking, E-E-A-T |
| Performance |
|
|
|
| Site Speed |
Speed Guide |
references/site-speed-optimization.md |
TTFB, render-blocking, images |
| Technical Setup |
|
|
|
| Mobile Optimization |
Mobile Guide |
references/mobile-seo-guide.md |
Responsive, viewport, mobile-first |
| Structured Data |
Schema Guide |
references/structured-data-guide.md |
JSON-LD, rich snippets |
| Schema Report |
Validation Template |
assets/schema/schema-validation-report.md |
Document schema findings |
| Security/HTTPS |
Security Guide |
references/security-https-guide.md |
HTTPS, HSTS, headers |
| Architecture |
|
|
|
| Internal Linking |
Link Strategy |
references/internal-linking-strategy.md |
Link equity, orphan pages |
| Duplicate Content |
Canonical Guide |
references/duplicate-content-handling.md |
Canonicals, pagination |
| International SEO |
Hreflang Guide |
references/internationalization-hreflang.md |
Multi-language/region sites |
| Link Building |
|
|
|
| Link Acquisition |
Link Building Guide |
references/link-building-strategy.md |
Backlinks, digital PR, HARO |
| Local SEO |
|
|
|
| Google Business Profile |
Local SEO Guide |
references/local-seo-guide.md |
GBP, citations, reviews, local pack |
10-Point Audit Framework
Every technical SEO audit follows this systematic checklist:
| # |
Area |
Key Metrics |
Weight |
| 1 |
Crawlability |
robots.txt status, sitemap coverage, crawl budget |
High |
| 2 |
Core Web Vitals |
LCP <2.5s, INP <200ms, CLS <0.1 |
High |
| 3 |
Site Speed |
TTFB <800ms, FCP <1.8s, Speed Index |
High |
| 4 |
Mobile |
Mobile-friendly score, viewport, touch targets |
High |
| 5 |
Security |
HTTPS, mixed content, HSTS, headers |
Medium |
| 6 |
Structured Data |
Schema validity, rich snippet eligibility |
Medium |
| 7 |
On-Page |
Meta tags, heading hierarchy, keyword signals |
Medium |
| 8 |
Architecture |
Internal links, URL structure, canonicals |
High |
| 9 |
Duplicate Content |
Canonical implementation, pagination |
Medium |
| 10 |
Internationalization |
Hreflang (if applicable), geo-targeting |
Low |
Scoring: Rate each area 0-10, calculate weighted average for overall Technical Health Score.
Decision Trees
### Audit Type Selection
Full site audit needed
-> Use assets/audits/full-technical-audit.md
Quick issue check
-> Use assets/audits/quick-audit-checklist.md
CWV-only deep dive
-> Use assets/cwv/core-web-vitals-report.md
Schema validation only
-> Use assets/schema/schema-validation-report.md
### Core Web Vitals Failing
LCP >2.5s
-> Preload LCP element, optimize images, add CDN
-> See references/core-web-vitals-guide.md
INP >200ms
-> Reduce JavaScript, optimize event handlers
-> See references/core-web-vitals-guide.md
CLS >0.1
-> Add dimensions to images/ads, avoid layout shifts
-> See references/core-web-vitals-guide.md
### Indexation Issues
Pages not indexed
-> Check robots.txt blocking
-> Verify sitemap inclusion
-> Check canonical tags
-> See references/crawlability-indexing.md
Crawl budget problems
-> Remove low-value pages from crawl
-> Fix redirect chains
-> Optimize pagination
-> See references/crawlability-indexing.md
New/large site needs fast indexation
-> Internal linking (#1 accelerator)
-> Manual GSC submission (10-20 priority pages)
-> Real content updates (not fake lastmod)
-> Brand mentions > backlinks (early stage)
-> See references/crawlability-indexing.md#indexation-acceleration
### Mobile Issues
Mobile-unfriendly
-> Check viewport meta tag
-> Verify responsive CSS
-> Test touch target sizes
-> See references/mobile-seo-guide.md
### Link Building Issues
Need more backlinks
-> Create linkable assets (research, tools)
-> Set up HARO/Featured.com
-> Broken link building outreach
-> See references/link-building-strategy.md
Low domain authority
-> Focus on DA 50+ targets
-> Digital PR campaigns
-> Competitor backlink analysis
-> See references/link-building-strategy.md
### Local SEO Issues
Not showing in local pack
-> Optimize Google Business Profile
-> Build local citations (NAP consistency)
-> Generate more reviews
-> See references/local-seo-guide.md
GBP not verified
-> Complete verification process
-> Ensure NAP matches website
-> See references/local-seo-guide.md
### Security Issues
Mixed content warnings
-> Update all HTTP resources to HTTPS
-> See references/security-https-guide.md
SSL/TLS issues
-> Run SSL Labs test
-> See references/security-https-guide.md
GSC Issue Triage (Strict Output)
Use this format when diagnosing Google Search Console indexation and canonicalization statuses.
If missing context blocks a safe recommendation, ask only the minimum clarifying questions (example: "Should these URLs be indexed?").
For each issue:
- Issue:
- Severity: Critical / Moderate / Informational
- What Google Is Detecting:
- Why This Happens:
- Is This Against Google Rules? (Yes/No + Explanation):
- Safe Fix (Step-by-Step):
- Expected SEO Benefit:
- What NOT to Do (Important):
Navigation
Core Resources
- references/core-web-vitals-guide.md - LCP, INP, CLS thresholds and optimization
- references/crawlability-indexing.md - Robots.txt, sitemaps, GSC, indexation
- references/site-speed-optimization.md - TTFB, render-blocking, image optimization
- references/mobile-seo-guide.md - Mobile-first indexing, responsive design
- references/structured-data-guide.md - Schema.org, JSON-LD, rich snippets
- references/security-https-guide.md - HTTPS, HSTS, security headers
- references/internal-linking-strategy.md - Link architecture, orphan pages
- references/duplicate-content-handling.md - Canonicals, pagination, parameters
- references/internationalization-hreflang.md - Hreflang, geo-targeting
Marketing & Operations
- references/seo-marketing-strategy.md - Keyword research, content planning, competitive analysis, brand building
- references/seo-operational-workflows.md - Cross-team collaboration, OKRs, stakeholder communication
- references/total-search-optimization.md - YouTube, Reddit, TikTok, LinkedIn, AI platforms
Link Building & Local SEO
- references/link-building-strategy.md - Backlink acquisition, digital PR, HARO, broken link building
- references/local-seo-guide.md - Google Business Profile, citations, reviews, local pack ranking
Templates
Audits
- assets/audits/full-technical-audit.md - Complete 10-point audit checklist
- assets/audits/quick-audit-checklist.md - Fast abbreviated audit
Core Web Vitals
- assets/cwv/core-web-vitals-report.md - CWV-specific audit report
Structured Data
- assets/schema/schema-validation-report.md - Schema audit report
Prioritization
- assets/priority/impact-effort-matrix.md - Issue prioritization matrix
Trend Awareness Protocol
IMPORTANT: When users ask recommendation questions about SEO, refresh against current updates before giving definitive guidance. If your environment supports web search, use it. If not, rely on official sources in data/sources.json and ask the minimum clarifying question about timeframe/market (example: "Is this for the US market, and do you care about changes in the last 30/90 days?").
Trigger Conditions
- "What's the best approach for [Core Web Vitals/site speed/crawlability]?"
- "What should I focus on for SEO in 2026?"
- "What's the latest Google algorithm update?"
- "Current best practices for [structured data/mobile SEO/indexation]?"
- "Is [SEO technique] still relevant in 2026?"
- "How has Google Search changed recently?"
- "What Core Web Vitals thresholds should I target?"
Required Searches
- Search:
site:developers.google.com search updates
- Search:
Google Search Status Dashboard
- Search:
Core Web Vitals thresholds INP
- Search:
Search Console new features
What to Report
After searching, provide:
- Current landscape: What SEO factors matter most NOW (not 6 months ago)
- Emerging trends: New ranking signals or Google features
- Deprecated/declining: Techniques that no longer work or hurt rankings
- Recommendation: Based on fresh data and recent algorithm updates
Example Topics (verify with fresh search)
- Core Web Vitals updates (INP replacing FID, thresholds)
- Google algorithm updates (helpful content, spam updates)
- Structured data new types and requirements
- Mobile-first indexing changes
- AI Overviews impact on traditional search
- New Search Console features
SEO Marketing Strategy (January 2026)
Keyword research, content planning, competitive analysis, and brand building.
Key areas covered:
- Keyword research framework (seed discovery, expansion, intent classification, prioritization)
- Content planning by intent (informational, commercial, transactional, navigational)
- Competitive analysis workflow (monthly audits, intelligence signals)
- Brand building tactics (brand and entity signals often correlate with durable performance; validate with current updates)
- E-E-A-T content strategy (Experience, Expertise, Authoritativeness, Trust)
See full guide: references/seo-marketing-strategy.md
SEO Operational Workflows (2026)
Cross-team collaboration, OKRs, and stakeholder communication.
Key areas covered:
- SEO as strategic quarterback (not isolated channel)
- Cross-team collaboration framework (Product, Engineering, Content, Paid, PR, Social)
- Pre-launch and post-deployment checklists
- SEO OKRs aligned to revenue (not vanity metrics)
- Stakeholder-specific reporting and communication
See full guide: references/seo-operational-workflows.md
Total Search Optimization (2026)
Multi-platform visibility beyond Google.
Platforms covered:
- YouTube SEO (video optimization, ranking factors)
- Reddit SEO (forum results increasingly appear for "best", "vs", and review-intent queries)
- Social SEO (LinkedIn B2B, TikTok B2C, X/Twitter)
- AI platforms (ChatGPT, Perplexity, Gemini) - for deep coverage, use
marketing-ai-search-optimization
- Unified content distribution strategy
See full guide: references/total-search-optimization.md
Related Skills
Marketing & SEO
Technical Implementation
Quality & Performance
Key Differentiators
Audit Output Format:
- Critical Issues - Fix immediately (high impact)
- Important Optimizations - Fix soon (medium impact)
- Recommended Enhancements - Nice to have
Each finding includes:
- What's wrong and why it matters
- Step-by-step fix instructions
- Expected outcome
- Validation method
External Resources
See data/sources.json for primary sources across:
- Google Search Central, web.dev, and Chrome developer docs (CWV, Lighthouse, CrUX)
- Bing Webmaster Guidelines and diagnostic tooling
- Crawl/index/render fundamentals (robots, sitemaps, canonicals, JS SEO)
- Structured data eligibility and validation tooling
- SEO marketing strategy (Backlinko, Search Engine Journal, Sitebulb, Content Whale)
- Cross-team collaboration and operational workflows
- Total Search Optimization (YouTube, Reddit, TikTok, LinkedIn)
- Optional automation references (Search Console API, CrUX API, Lighthouse CI)
Getting Started
Quick audit (15 minutes):
- Run PageSpeed Insights on key pages
- Check robots.txt and sitemap.xml accessibility
- Validate structured data with Rich Results Test
- Review GSC Coverage report for indexation issues
- Use assets/audits/quick-audit-checklist.md
Full audit (2-4 hours):
- Use assets/audits/full-technical-audit.md
- Work through all 10 audit areas systematically
- Score each area 0-10
- Prioritize findings with assets/priority/impact-effort-matrix.md
- Document fixes with validation steps
Ongoing monitoring:
- Set up GSC alerts for indexation issues
- Monitor Core Web Vitals in CrUX
- Schedule quarterly audits
- Track improvements against baseline
SEO Testing & Monitoring
| Signal |
Frequency |
Alert Threshold |
| Indexation (GSC) |
Daily |
>5% drop |
| CWV scores (CrUX) |
Daily |
Any metric fails |
| Crawl errors |
Daily |
Any new 4xx/5xx |
| Schema validity |
Weekly |
Any errors |
Do: Lighthouse CI in pipeline, GSC API monitoring, CrUX field data, baseline before optimization
Avoid: Testing on fast dev machines only, ignoring field data, multiple simultaneous changes
Success Criteria
A successful technical SEO audit delivers a prioritized list of issues with clear fix instructions and validation methods that measurably improve search visibility and Core Web Vitals scores.
SEO Business Metrics
| Metric |
Formula |
Benchmark |
| SEO ROI |
(Organic Revenue - SEO Cost) / SEO Cost * 100 |
>300% |
| Organic CAC |
Total SEO Cost / Organic Conversions |
B2B: <$100, B2C: <$30 |
| Pipeline Influence |
Organic-Sourced Pipeline / Total Pipeline |
>30% |
See full guide: references/seo-business-metrics.md - Attribution models, OKRs, stakeholder reporting
Tools & Collaboration
Crawl tools: Screaming Frog, Sitebulb, Semrush, Ahrefs, ContentKing, Lumar
Cross-team: Product (early planning, redirects), Engineering (Lighthouse CI, CWV), Design (images, CLS)
Anti-Patterns
| Anti-Pattern (AVOID) |
Better Practice (DO) |
| Audit without action |
Assign owners, set deadlines |
| Fix everything at once |
Batch by priority, deploy incrementally |
| Ignore mobile |
Test mobile-first (often the majority of traffic) |
| Trust lab data only |
Use CrUX (field data) as truth |
| One-time audit |
Continuous monitoring, quarterly deep audits |
| Chase vanity metrics (rankings) |
Track revenue, conversions, pipeline |
| Optimize pages in isolation |
Build topical authority clusters |
| Ignore AI Overviews |
Optimize for citation in AI results |
International Markets
This skill uses Google-centric defaults. For international SEO:
If you're using a router-based setup, mention country/region/search engine explicitly so the router can bring in marketing-geo-localization when needed.
SEO Mistakes (High Risk)
High risk (can cause ranking loss or manual actions): keyword stuffing, link spam/toxic backlink patterns, hidden text/cloaking, doorway pages, deceptive structured data, scaled low-value content
Common suppressors: weak E-E-A-T signals, poor internal linking, failing CWV, mobile-unfriendly UX, stale content, wrong canonicals
Technical crawl/index blockers: accidental noindex, redirect chains >2 hops, broken links, missing sitemap, blocking critical JS/CSS for rendering
Recovery: GSC Manual Actions -> Coverage report -> Traffic analysis -> Site audit -> Fix by severity -> Reconsideration (manual only) -> Expect weeks to months
1---2name: marketing-seo-complete3description: Complete SEO skill for technical audits (Core Web Vitals, site speed, crawlability/indexation, robots/sitemaps/canonicals, structured data, mobile, security, internal linking), SEO marketing strategy (keyword research, content planning, competitive analysis, E-E-A-T), operational workflows (cross-team collaboration, OKRs), link building, local SEO, international SEO (hreflang), and multi-platform SEO (Google, YouTube, Reddit, social). Updated for January 2026.4---5
6# SEO Technical and Marketing - Operational Skill
7
8This skill contains **actionable, production-ready systems** for **traditional search engine optimization**:
9
10- **Technical SEO auditing** (Core Web Vitals, crawlability, structured data, mobile optimization)
11- **SEO marketing strategy** (keyword research, content planning, competitive analysis, brand building)
12- **Operational workflows** (cross-team collaboration, stakeholder alignment, SEO OKRs)
13- **Total Search Optimization** (Google, YouTube, Reddit, TikTok, forums, social SEO)
14
15**Structure**: Technical fundamentals first -> Marketing strategy -> Operational execution -> Total Search Optimization.
16
17**For AI search optimization** (ChatGPT, Perplexity, Gemini, AI Overviews, GEO): Use [marketing-ai-search-optimization](../marketing-ai-search-optimization/SKILL.md) instead.
18
19---
20
21## 2026 Operating Assumptions (Evergreen)
22
23- Prioritize usefulness and intent satisfaction; technical SEO cannot compensate for weak content.
24- E-E-A-T matters most when claims can impact money, health, safety, or major decisions; for all niches, show real experience and verifiable proof where possible.
25- Mobile-first is the default: performance, UX, and rendering on mobile are the primary gate.
26- Crawl/indexation wins come from discoverability (internal links, sitemaps) and removing low-value crawl traps.
27- Core Web Vitals are a weak signal but a strong tiebreaker; fix regressions and obvious failures.
28- Structured data is for eligibility and rich results, not a ranking boost; use it to improve extraction and display.
29- SERPs are multi-surface (web, video, local, forums, social); measure channel-by-channel, not only rankings.
30
31Primary sources live in `data/sources.json`. For time-sensitive changes (core updates, reporting changes), use official sources first (Google Search Central / Search Status Dashboard); if your environment supports web search, refresh against current updates before giving definitive advice.
32
33### Key Thresholds (2026)
34
35| Metric | Target | Impact |
36|--------|--------|--------|
37| LCP | < 2.5s | Mobile-first indexing threshold |
38| INP | < 200ms | Replaced FID; user engagement signal |
39| CLS | < 0.1 | Layout stability; ranking factor |
40| TTFB | < 600ms | Crawl rate: slow servers often reduce pages crawled/day |
41| Mobile score | > 90 | Required for competitive rankings |
42
43---
44
45## When NOT to Use
46
47- **Pure AI platform optimization** (ChatGPT, Perplexity, Gemini visibility) -> Use [marketing-ai-search-optimization](../marketing-ai-search-optimization/SKILL.md)
48- **Paid search campaigns** (Google Ads, Bing Ads) -> Use [marketing-paid-advertising](../marketing-paid-advertising/SKILL.md)
49- **Social media strategy** (non-SEO focused) -> Use [marketing-social-media](../marketing-social-media/SKILL.md)
50- **Content creation process** (writing, editing, publishing) -> Use [marketing-content-strategy](../marketing-content-strategy/SKILL.md)
51- **Email marketing** -> Use [marketing-email-automation](../marketing-email-automation/SKILL.md)
52
53---
54
55## Quick Reference
56
57| Task | Resource/Template | Location | When to Use |
58|------|------------------|----------|-------------|
59| **Auditing** | | | |
60| Full Technical Audit | 10-Point Checklist | `assets/audits/full-technical-audit.md` | Comprehensive site-wide audit |
61| Quick Audit | Abbreviated Checklist | `assets/audits/quick-audit-checklist.md` | Fast issue identification |
62| Priority Matrix | Impact vs Effort | `assets/priority/impact-effort-matrix.md` | Prioritize audit findings |
63| **Core Web Vitals** | | | |
64| CWV Deep Dive | CWV Guide | `references/core-web-vitals-guide.md` | LCP, INP, CLS optimization |
65| CWV Report | Report Template | `assets/cwv/core-web-vitals-report.md` | Document CWV findings |
66| **Crawlability** | | | |
67| Indexation Issues | Crawlability Guide | `references/crawlability-indexing.md` | Robots.txt, sitemaps, GSC issues |
68| Indexation Acceleration | Fast Indexing Guide | `references/crawlability-indexing.md#indexation-acceleration` | New/large sites, internal linking, E-E-A-T |
69| **Performance** | | | |
70| Site Speed | Speed Guide | `references/site-speed-optimization.md` | TTFB, render-blocking, images |
71| **Technical Setup** | | | |
72| Mobile Optimization | Mobile Guide | `references/mobile-seo-guide.md` | Responsive, viewport, mobile-first |
73| Structured Data | Schema Guide | `references/structured-data-guide.md` | JSON-LD, rich snippets |
74| Schema Report | Validation Template | `assets/schema/schema-validation-report.md` | Document schema findings |
75| Security/HTTPS | Security Guide | `references/security-https-guide.md` | HTTPS, HSTS, headers |
76| **Architecture** | | | |
77| Internal Linking | Link Strategy | `references/internal-linking-strategy.md` | Link equity, orphan pages |
78| Duplicate Content | Canonical Guide | `references/duplicate-content-handling.md` | Canonicals, pagination |
79| International SEO | Hreflang Guide | `references/internationalization-hreflang.md` | Multi-language/region sites |
80| **Link Building** | | | |
81| Link Acquisition | Link Building Guide | `references/link-building-strategy.md` | Backlinks, digital PR, HARO |
82| **Local SEO** | | | |
83| Google Business Profile | Local SEO Guide | `references/local-seo-guide.md` | GBP, citations, reviews, local pack |
84
85---
86
87## 10-Point Audit Framework
88
89Every technical SEO audit follows this systematic checklist:
90
91| # | Area | Key Metrics | Weight |
92|---|------|-------------|--------|
93| 1 | **Crawlability** | robots.txt status, sitemap coverage, crawl budget | High |
94| 2 | **Core Web Vitals** | LCP <2.5s, INP <200ms, CLS <0.1 | High |
95| 3 | **Site Speed** | TTFB <800ms, FCP <1.8s, Speed Index | High |
96| 4 | **Mobile** | Mobile-friendly score, viewport, touch targets | High |
97| 5 | **Security** | HTTPS, mixed content, HSTS, headers | Medium |
98| 6 | **Structured Data** | Schema validity, rich snippet eligibility | Medium |
99| 7 | **On-Page** | Meta tags, heading hierarchy, keyword signals | Medium |
100| 8 | **Architecture** | Internal links, URL structure, canonicals | High |
101| 9 | **Duplicate Content** | Canonical implementation, pagination | Medium |
102| 10 | **Internationalization** | Hreflang (if applicable), geo-targeting | Low |
103
104**Scoring**: Rate each area 0-10, calculate weighted average for overall Technical Health Score.
105
106---
107
108## Decision Trees
109
110```text
111### Audit Type Selection
112Full site audit needed
113 -> Use assets/audits/full-technical-audit.md
114Quick issue check
115 -> Use assets/audits/quick-audit-checklist.md
116CWV-only deep dive
117 -> Use assets/cwv/core-web-vitals-report.md
118Schema validation only
119 -> Use assets/schema/schema-validation-report.md
120
121### Core Web Vitals Failing
122LCP >2.5s
123 -> Preload LCP element, optimize images, add CDN
124 -> See references/core-web-vitals-guide.md
125INP >200ms
126 -> Reduce JavaScript, optimize event handlers
127 -> See references/core-web-vitals-guide.md
128CLS >0.1
129 -> Add dimensions to images/ads, avoid layout shifts
130 -> See references/core-web-vitals-guide.md
131
132### Indexation Issues
133Pages not indexed
134 -> Check robots.txt blocking
135 -> Verify sitemap inclusion
136 -> Check canonical tags
137 -> See references/crawlability-indexing.md
138Crawl budget problems
139 -> Remove low-value pages from crawl
140 -> Fix redirect chains
141 -> Optimize pagination
142 -> See references/crawlability-indexing.md
143New/large site needs fast indexation
144 -> Internal linking (#1 accelerator)
145 -> Manual GSC submission (10-20 priority pages)
146 -> Real content updates (not fake lastmod)
147 -> Brand mentions > backlinks (early stage)
148 -> See references/crawlability-indexing.md#indexation-acceleration
149
150### Mobile Issues
151Mobile-unfriendly
152 -> Check viewport meta tag
153 -> Verify responsive CSS
154 -> Test touch target sizes
155 -> See references/mobile-seo-guide.md
156
157### Link Building Issues
158Need more backlinks
159 -> Create linkable assets (research, tools)
160 -> Set up HARO/Featured.com
161 -> Broken link building outreach
162 -> See references/link-building-strategy.md
163Low domain authority
164 -> Focus on DA 50+ targets
165 -> Digital PR campaigns
166 -> Competitor backlink analysis
167 -> See references/link-building-strategy.md
168
169### Local SEO Issues
170Not showing in local pack
171 -> Optimize Google Business Profile
172 -> Build local citations (NAP consistency)
173 -> Generate more reviews
174 -> See references/local-seo-guide.md
175GBP not verified
176 -> Complete verification process
177 -> Ensure NAP matches website
178 -> See references/local-seo-guide.md
179
180### Security Issues
181Mixed content warnings
182 -> Update all HTTP resources to HTTPS
183 -> See references/security-https-guide.md
184SSL/TLS issues
185 -> Run SSL Labs test
186 -> See references/security-https-guide.md
187```
188
189---
190
191## GSC Issue Triage (Strict Output)
192
193Use this format when diagnosing Google Search Console indexation and canonicalization statuses.
194
195If missing context blocks a safe recommendation, ask only the minimum clarifying questions (example: "Should these URLs be indexed?").
196
197For each issue:
198
199- **Issue:**
200- **Severity:** Critical / Moderate / Informational
201- **What Google Is Detecting:**
202- **Why This Happens:**
203- **Is This Against Google Rules? (Yes/No + Explanation):**
204- **Safe Fix (Step-by-Step):**
205- **Expected SEO Benefit:**
206- **What NOT to Do (Important):**
207
208---
209
210## Navigation
211
212### Core Resources
213
214- [references/core-web-vitals-guide.md](references/core-web-vitals-guide.md) - LCP, INP, CLS thresholds and optimization
215- [references/crawlability-indexing.md](references/crawlability-indexing.md) - Robots.txt, sitemaps, GSC, indexation
216- [references/site-speed-optimization.md](references/site-speed-optimization.md) - TTFB, render-blocking, image optimization
217- [references/mobile-seo-guide.md](references/mobile-seo-guide.md) - Mobile-first indexing, responsive design
218- [references/structured-data-guide.md](references/structured-data-guide.md) - Schema.org, JSON-LD, rich snippets
219- [references/security-https-guide.md](references/security-https-guide.md) - HTTPS, HSTS, security headers
220- [references/internal-linking-strategy.md](references/internal-linking-strategy.md) - Link architecture, orphan pages
221- [references/duplicate-content-handling.md](references/duplicate-content-handling.md) - Canonicals, pagination, parameters
222- [references/internationalization-hreflang.md](references/internationalization-hreflang.md) - Hreflang, geo-targeting
223
224### Marketing & Operations
225
226- [references/seo-marketing-strategy.md](references/seo-marketing-strategy.md) - Keyword research, content planning, competitive analysis, brand building
227- [references/seo-operational-workflows.md](references/seo-operational-workflows.md) - Cross-team collaboration, OKRs, stakeholder communication
228- [references/total-search-optimization.md](references/total-search-optimization.md) - YouTube, Reddit, TikTok, LinkedIn, AI platforms
229
230### Link Building & Local SEO
231
232- [references/link-building-strategy.md](references/link-building-strategy.md) - Backlink acquisition, digital PR, HARO, broken link building
233- [references/local-seo-guide.md](references/local-seo-guide.md) - Google Business Profile, citations, reviews, local pack ranking
234
235### Templates
236
237#### Audits
238- [assets/audits/full-technical-audit.md](assets/audits/full-technical-audit.md) - Complete 10-point audit checklist
239- [assets/audits/quick-audit-checklist.md](assets/audits/quick-audit-checklist.md) - Fast abbreviated audit
240
241#### Core Web Vitals
242- [assets/cwv/core-web-vitals-report.md](assets/cwv/core-web-vitals-report.md) - CWV-specific audit report
243
244#### Structured Data
245- [assets/schema/schema-validation-report.md](assets/schema/schema-validation-report.md) - Schema audit report
246
247#### Prioritization
248- [assets/priority/impact-effort-matrix.md](assets/priority/impact-effort-matrix.md) - Issue prioritization matrix
249
250---
251
252## Trend Awareness Protocol
253
254IMPORTANT: When users ask recommendation questions about SEO, refresh against current updates before giving definitive guidance. If your environment supports web search, use it. If not, rely on official sources in `data/sources.json` and ask the minimum clarifying question about timeframe/market (example: "Is this for the US market, and do you care about changes in the last 30/90 days?").
255
256### Trigger Conditions
257
258- "What's the best approach for [Core Web Vitals/site speed/crawlability]?"
259- "What should I focus on for SEO in 2026?"
260- "What's the latest Google algorithm update?"
261- "Current best practices for [structured data/mobile SEO/indexation]?"
262- "Is [SEO technique] still relevant in 2026?"
263- "How has Google Search changed recently?"
264- "What Core Web Vitals thresholds should I target?"
265
266### Required Searches
267
2681. Search: `site:developers.google.com search updates`
2692. Search: `Google Search Status Dashboard`
2703. Search: `Core Web Vitals thresholds INP`
2714. Search: `Search Console new features`
272
273### What to Report
274
275After searching, provide:
276
277- **Current landscape**: What SEO factors matter most NOW (not 6 months ago)
278- **Emerging trends**: New ranking signals or Google features
279- **Deprecated/declining**: Techniques that no longer work or hurt rankings
280- **Recommendation**: Based on fresh data and recent algorithm updates
281
282### Example Topics (verify with fresh search)
283
284- Core Web Vitals updates (INP replacing FID, thresholds)
285- Google algorithm updates (helpful content, spam updates)
286- Structured data new types and requirements
287- Mobile-first indexing changes
288- AI Overviews impact on traditional search
289- New Search Console features
290
291---
292
293## SEO Marketing Strategy (January 2026)
294
295Keyword research, content planning, competitive analysis, and brand building.
296
297**Key areas covered:**
298- Keyword research framework (seed discovery, expansion, intent classification, prioritization)
299- Content planning by intent (informational, commercial, transactional, navigational)
300- Competitive analysis workflow (monthly audits, intelligence signals)
301- Brand building tactics (brand and entity signals often correlate with durable performance; validate with current updates)
302- E-E-A-T content strategy (Experience, Expertise, Authoritativeness, Trust)
303
304**See full guide**: [references/seo-marketing-strategy.md](references/seo-marketing-strategy.md)
305
306---
307
308## SEO Operational Workflows (2026)
309
310Cross-team collaboration, OKRs, and stakeholder communication.
311
312**Key areas covered:**
313- SEO as strategic quarterback (not isolated channel)
314- Cross-team collaboration framework (Product, Engineering, Content, Paid, PR, Social)
315- Pre-launch and post-deployment checklists
316- SEO OKRs aligned to revenue (not vanity metrics)
317- Stakeholder-specific reporting and communication
318
319**See full guide**: [references/seo-operational-workflows.md](references/seo-operational-workflows.md)
320
321---
322
323## Total Search Optimization (2026)
324
325Multi-platform visibility beyond Google.
326
327**Platforms covered:**
328- YouTube SEO (video optimization, ranking factors)
329- Reddit SEO (forum results increasingly appear for "best", "vs", and review-intent queries)
330- Social SEO (LinkedIn B2B, TikTok B2C, X/Twitter)
331- AI platforms (ChatGPT, Perplexity, Gemini) - for deep coverage, use `marketing-ai-search-optimization`
332- Unified content distribution strategy
333
334**See full guide**: [references/total-search-optimization.md](references/total-search-optimization.md)
335
336---
337
338## Related Skills
339
340**Marketing & SEO**
341
342- [../marketing-ai-search-optimization/SKILL.md](../marketing-ai-search-optimization/SKILL.md) - Search visibility beyond classic SERPs (complements technical SEO)
343- [../marketing-social-media/SKILL.md](../marketing-social-media/SKILL.md) - Social media marketing and content distribution
344
345**Technical Implementation**
346
347- [../software-frontend/SKILL.md](../software-frontend/SKILL.md) - Frontend performance optimization, SSR
348- [../software-backend/SKILL.md](../software-backend/SKILL.md) - Server-side optimization, API performance
349- [../software-security-appsec/SKILL.md](../software-security-appsec/SKILL.md) - Security hardening, HTTPS implementation
350
351**Quality & Performance**
352
353- [../qa-observability/SKILL.md](../qa-observability/SKILL.md) - Performance monitoring, observability
354- [../ops-devops-platform/SKILL.md](../ops-devops-platform/SKILL.md) - CDN setup, infrastructure optimization
355
356---
357
358## Key Differentiators
359
360**Audit Output Format:**
361- **Critical Issues** - Fix immediately (high impact)
362- **Important Optimizations** - Fix soon (medium impact)
363- **Recommended Enhancements** - Nice to have
364
365**Each finding includes:**
366- What's wrong and why it matters
367- Step-by-step fix instructions
368- Expected outcome
369- Validation method
370
371---
372
373## External Resources
374
375See [data/sources.json](data/sources.json) for primary sources across:
376
377- Google Search Central, web.dev, and Chrome developer docs (CWV, Lighthouse, CrUX)
378- Bing Webmaster Guidelines and diagnostic tooling
379- Crawl/index/render fundamentals (robots, sitemaps, canonicals, JS SEO)
380- Structured data eligibility and validation tooling
381- SEO marketing strategy (Backlinko, Search Engine Journal, Sitebulb, Content Whale)
382- Cross-team collaboration and operational workflows
383- Total Search Optimization (YouTube, Reddit, TikTok, LinkedIn)
384- Optional automation references (Search Console API, CrUX API, Lighthouse CI)
385
386---
387
388## Getting Started
389
390**Quick audit (15 minutes):**
3911. Run PageSpeed Insights on key pages
3922. Check robots.txt and sitemap.xml accessibility
3933. Validate structured data with Rich Results Test
3944. Review GSC Coverage report for indexation issues
3955. Use [assets/audits/quick-audit-checklist.md](assets/audits/quick-audit-checklist.md)
396
397**Full audit (2-4 hours):**
3981. Use [assets/audits/full-technical-audit.md](assets/audits/full-technical-audit.md)
3992. Work through all 10 audit areas systematically
4003. Score each area 0-10
4014. Prioritize findings with [assets/priority/impact-effort-matrix.md](assets/priority/impact-effort-matrix.md)
4025. Document fixes with validation steps
403
404**Ongoing monitoring:**
4051. Set up GSC alerts for indexation issues
4062. Monitor Core Web Vitals in CrUX
4073. Schedule quarterly audits
4084. Track improvements against baseline
409
410---
411
412## SEO Testing & Monitoring
413
414| Signal | Frequency | Alert Threshold |
415|--------|-----------|-----------------|
416| Indexation (GSC) | Daily | >5% drop |
417| CWV scores (CrUX) | Daily | Any metric fails |
418| Crawl errors | Daily | Any new 4xx/5xx |
419| Schema validity | Weekly | Any errors |
420
421**Do**: Lighthouse CI in pipeline, GSC API monitoring, CrUX field data, baseline before optimization
422
423**Avoid**: Testing on fast dev machines only, ignoring field data, multiple simultaneous changes
424
425---
426
427## Success Criteria
428
429> A successful technical SEO audit delivers a prioritized list of issues with clear fix instructions and validation methods that measurably improve search visibility and Core Web Vitals scores.
430
431---
432
433## SEO Business Metrics
434
435| Metric | Formula | Benchmark |
436|--------|---------|-----------|
437| **SEO ROI** | (Organic Revenue - SEO Cost) / SEO Cost * 100 | >300% |
438| **Organic CAC** | Total SEO Cost / Organic Conversions | B2B: <$100, B2C: <$30 |
439| **Pipeline Influence** | Organic-Sourced Pipeline / Total Pipeline | >30% |
440
441**See full guide**: [references/seo-business-metrics.md](references/seo-business-metrics.md) - Attribution models, OKRs, stakeholder reporting
442
443---
444
445## Tools & Collaboration
446
447**Crawl tools**: Screaming Frog, Sitebulb, Semrush, Ahrefs, ContentKing, Lumar
448
449**Cross-team**: Product (early planning, redirects), Engineering (Lighthouse CI, CWV), Design (images, CLS)
450
451---
452
453## Anti-Patterns
454
455| Anti-Pattern (AVOID) | Better Practice (DO) |
456|-----------------|-----------|
457| Audit without action | Assign owners, set deadlines |
458| Fix everything at once | Batch by priority, deploy incrementally |
459| Ignore mobile | Test mobile-first (often the majority of traffic) |
460| Trust lab data only | Use CrUX (field data) as truth |
461| One-time audit | Continuous monitoring, quarterly deep audits |
462| Chase vanity metrics (rankings) | Track revenue, conversions, pipeline |
463| Optimize pages in isolation | Build topical authority clusters |
464| Ignore AI Overviews | Optimize for citation in AI results |
465
466---
467
468## International Markets
469
470This skill uses Google-centric defaults. For international SEO:
471
472| Need | See Skill |
473|------|-----------|
474| Non-Google search (Baidu, Yandex, Naver) | [marketing-geo-localization](../marketing-geo-localization/SKILL.md) |
475| Hreflang and multi-region strategy | [marketing-geo-localization](../marketing-geo-localization/SKILL.md) |
476| Regional SERP features | [marketing-geo-localization](../marketing-geo-localization/SKILL.md) |
477| CJK/RTL language optimization | [marketing-geo-localization](../marketing-geo-localization/SKILL.md) |
478
479If you're using a router-based setup, mention country/region/search engine explicitly so the router can bring in [marketing-geo-localization](../marketing-geo-localization/SKILL.md) when needed.
480
481---
482
483## SEO Mistakes (High Risk)
484
485High risk (can cause ranking loss or manual actions): keyword stuffing, link spam/toxic backlink patterns, hidden text/cloaking, doorway pages, deceptive structured data, scaled low-value content
486
487Common suppressors: weak E-E-A-T signals, poor internal linking, failing CWV, mobile-unfriendly UX, stale content, wrong canonicals
488
489Technical crawl/index blockers: accidental noindex, redirect chains >2 hops, broken links, missing sitemap, blocking critical JS/CSS for rendering
490
491Recovery: GSC Manual Actions -> Coverage report -> Traffic analysis -> Site audit -> Fix by severity -> Reconsideration (manual only) -> Expect weeks to months