Technical SEO Checker
SEO & GEO Skills Library · 20 skills for SEO + GEO · ClawHub · skills.sh
System Mode: This optimization skill follows the shared Skill Contract and State Model.
This skill performs comprehensive technical SEO audits to identify issues that may prevent search engines from properly crawling, indexing, and ranking your site.
System role: Optimization layer skill. It turns weak pages, structures, and technical issues into prioritized repair work.
When This Must Trigger
Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
Use this whenever the task needs a diagnosis or repair plan that should feed directly into remediation work, not just a one-time opinion.
- Launching a new website
- Diagnosing ranking drops
- Pre-migration SEO audits
- Regular technical health checks
- Identifying crawl and index issues
- Improving site performance
- Fixing Core Web Vitals issues
What This Skill Does
- Crawlability Audit: Checks robots.txt, sitemaps, crawl issues
- Indexability Review: Analyzes index status and blockers
- Site Speed Analysis: Evaluates Core Web Vitals and performance
- Mobile-Friendliness: Checks mobile optimization
- Security Check: Reviews HTTPS and security headers
- Structured Data Audit: Validates schema markup
- URL Structure Analysis: Reviews URL patterns and redirects
- International SEO: Checks hreflang and localization
Quick Start
Start with one of these prompts. Finish with a short handoff summary using the repository format in Skill Contract.
Full Technical Audit
Perform a technical SEO audit for [URL/domain]
Specific Issue Check
Check Core Web Vitals for [URL]
Audit crawlability and indexability for [domain]
Pre-Migration Audit
Technical SEO checklist for migrating [old domain] to [new domain]
Skill Contract
Expected output: a scored diagnosis, prioritized repair plan, and a short handoff summary ready for memory/audits/.
- Reads: the current page or site state, symptoms, prior audits, and current priorities from CLAUDE.md and the shared State Model when available.
- Writes: a user-facing audit or optimization plan plus a reusable summary that can be stored under
memory/audits/.
- Promotes: blocking defects, repeated weaknesses, and fix priorities to
memory/open-loops.md and memory/decisions.md.
- Next handoff: use the
Next Best Skill below when the repair path is clear.
Data Sources
See CONNECTORS.md for tool category placeholders.
With ~~web crawler + ~~page speed tool + ~~CDN connected:
Claude can automatically crawl the entire site structure via ~~web crawler, pull Core Web Vitals and performance metrics from ~~page speed tool, analyze caching headers from ~~CDN, and fetch mobile-friendliness data. This enables comprehensive automated technical audits.
With manual data only:
Ask the user to provide:
- Site URL(s) to audit
- PageSpeed Insights screenshots or reports
- robots.txt file content
- sitemap.xml URL or file
Proceed with the full audit using provided data. Note in the output which findings are from automated crawl vs. manual review.
Instructions
When a user requests a technical SEO audit:
Audit Crawlability
## Crawlability Analysis
### Robots.txt Review
**URL**: [domain]/robots.txt
**Status**: [Found/Not Found/Error]
**Current Content**:
[robots.txt content]
| Check | Status | Notes |
|-------|--------|-------|
| File exists | ✅/❌ | [notes] |
| Valid syntax | ✅/⚠️/❌ | [errors found] |
| Sitemap declared | ✅/❌ | [sitemap URL] |
| Important pages blocked | ✅/⚠️/❌ | [blocked paths] |
| Assets blocked | ✅/⚠️/❌ | [CSS/JS blocked?] |
| Correct user-agents | ✅/⚠️/❌ | [notes] |
**Issues Found**:
- [Issue 1]
- [Issue 2]
**Recommended robots.txt**:
User-agent: *
Allow: /
Disallow: /admin/
Disallow: /private/
Sitemap: https://example.com/sitemap.xml
---
### XML Sitemap Review
**Sitemap URL**: [URL]
**Status**: [Found/Not Found/Error]
| Check | Status | Notes |
|-------|--------|-------|
| Sitemap exists | ✅/❌ | [notes] |
| Valid XML format | ✅/⚠️/❌ | [errors] |
| In robots.txt | ✅/❌ | [notes] |
| Submitted to ~~search console | ✅/⚠️/❌ | [notes] |
| URLs count | [X] | [appropriate?] |
| Only indexable URLs | ✅/⚠️/❌ | [notes] |
| Includes priority | ✅/⚠️ | [notes] |
| Includes lastmod | ✅/⚠️ | [accurate?] |
**Issues Found**:
- [Issue 1]
---
### Crawl Budget Analysis
| Factor | Status | Impact |
|--------|--------|--------|
| Crawl errors | [X] errors | [Low/Med/High] |
| Duplicate content | [X] pages | [Low/Med/High] |
| Thin content | [X] pages | [Low/Med/High] |
| Redirect chains | [X] found | [Low/Med/High] |
| Orphan pages | [X] found | [Low/Med/High] |
**Crawlability Score**: [X]/10
Audit Indexability
## Indexability Analysis
### Index Status Overview
| Metric | Count | Notes |
|--------|-------|-------|
| Pages in sitemap | [X] | |
| Pages indexed | [X] | [source: site: search] |
| Index coverage ratio | [X]% | [good if >90%] |
### Index Blockers Check
| Blocker Type | Found | Pages Affected |
|--------------|-------|----------------|
| noindex meta tag | [X] | [list or "none"] |
| noindex X-Robots | [X] | [list or "none"] |
| Robots.txt blocked | [X] | [list or "none"] |
| Canonical to other | [X] | [list or "none"] |
| 4xx/5xx errors | [X] | [list or "none"] |
| Redirect loops | [X] | [list or "none"] |
### Canonical Tags Audit
| Check | Status | Notes |
|-------|--------|-------|
| Canonicals present | ✅/⚠️/❌ | [X]% of pages |
| Self-referencing | ✅/⚠️/❌ | [notes] |
| Consistent (HTTP/HTTPS) | ✅/⚠️/❌ | [notes] |
| Consistent (www/non-www) | ✅/⚠️/❌ | [notes] |
| No conflicting signals | ✅/⚠️/❌ | [notes] |
### Duplicate Content Issues
| Issue Type | Count | Examples |
|------------|-------|----------|
| Exact duplicates | [X] | [URLs] |
| Near duplicates | [X] | [URLs] |
| Parameter duplicates | [X] | [URLs] |
| WWW/non-WWW | [X] | [notes] |
| HTTP/HTTPS | [X] | [notes] |
**Indexability Score**: [X]/10
Audit Site Speed & Core Web Vitals — CWV metrics (LCP/FID/CLS/INP), additional performance metrics (TTFB/FCP/Speed Index/TBT), resource loading breakdown, optimization recommendations
Reference: See references/technical-audit-templates.md for the performance analysis template (Step 3).
Audit Mobile-Friendliness — Mobile-friendly test, responsive design check, mobile-first indexing verification
Reference: See references/technical-audit-templates.md for the mobile optimization template (Step 4).
Audit Security & HTTPS — SSL certificate, HTTPS enforcement, mixed content, HSTS, security headers (CSP, X-Frame-Options, etc.)
Reference: See references/technical-audit-templates.md for the security analysis template (Step 5).
Audit URL Structure — URL patterns, issues (dynamic params, session IDs, uppercase), redirect analysis (chains, loops, 302s)
Reference: See references/technical-audit-templates.md for the URL structure template (Step 6).
Audit Structured Data — Schema markup validation, missing schema opportunities. CORE-EEAT alignment: maps to O05.
Reference: See references/technical-audit-templates.md for the structured data template (Step 7).
Audit International SEO (if applicable) — Hreflang implementation, language/region targeting
Reference: See references/technical-audit-templates.md for the international SEO template (Step 8).
Generate Technical Audit Summary — Overall health score with visual breakdown, critical/high/medium issues, quick wins, implementation roadmap (weeks 1-4+), monitoring recommendations
Reference: See references/technical-audit-templates.md for the audit summary template (Step 9).
Validation Checkpoints
Input Validation
Output Validation
Example
Reference: See references/technical-audit-example.md for a full worked example (cloudhosting.com technical audit) and the comprehensive technical SEO checklist.
Tips for Success
- Prioritize by impact - Fix critical issues first
- Monitor continuously - Use ~~search console alerts
- Test changes - Verify fixes work before deploying widely
- Document everything - Track changes for troubleshooting
- Regular audits - Schedule quarterly technical reviews
Technical reference: For issue severity framework, prioritization matrix, and Core Web Vitals optimization quick reference, see references/http-status-codes.md.
Save Results
After delivering audit or optimization findings to the user, ask:
"Save these results for future sessions?"
If yes, write a dated summary to memory/audits/technical-seo-checker/YYYY-MM-DD-<topic>.md containing:
- One-line verdict or headline finding
- Top 3-5 actionable items
- Open loops or blockers
- Source data references
If any veto-level issue was found (CORE-EEAT T04, C01, R10 or CITE T03, T05, T09), also append a one-liner to memory/hot-cache.md without asking.
Reference Materials
Next Best Skill
- Primary: on-page-seo-auditor — continue from infrastructure issues into page-level remediation.
1---2name: technical-seo-checker3description: Technical SEO audit: Core Web Vitals, crawl, indexing, mobile, speed, architecture, redirects. 技术SEO/网站速度4license: Apache-2.05---6
7# Technical SEO Checker
8
9
10> **[SEO & GEO Skills Library](https://github.com/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · [ClawHub](https://clawhub.ai/u/aaron-he-zhu) · [skills.sh](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)
11> **System Mode**: This optimization skill follows the shared [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) and [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md).
12
13
14This skill performs comprehensive technical SEO audits to identify issues that may prevent search engines from properly crawling, indexing, and ranking your site.
15
16**System role**: Optimization layer skill. It turns weak pages, structures, and technical issues into prioritized repair work.
17
18## When This Must Trigger
19
20Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
21
22Use this whenever the task needs a diagnosis or repair plan that should feed directly into remediation work, not just a one-time opinion.
23
24- Launching a new website
25- Diagnosing ranking drops
26- Pre-migration SEO audits
27- Regular technical health checks
28- Identifying crawl and index issues
29- Improving site performance
30- Fixing Core Web Vitals issues
31
32## What This Skill Does
33
341. **Crawlability Audit**: Checks robots.txt, sitemaps, crawl issues
352. **Indexability Review**: Analyzes index status and blockers
363. **Site Speed Analysis**: Evaluates Core Web Vitals and performance
374. **Mobile-Friendliness**: Checks mobile optimization
385. **Security Check**: Reviews HTTPS and security headers
396. **Structured Data Audit**: Validates schema markup
407. **URL Structure Analysis**: Reviews URL patterns and redirects
418. **International SEO**: Checks hreflang and localization
42
43## Quick Start
44
45Start with one of these prompts. Finish with a short handoff summary using the repository format in [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).
46
47### Full Technical Audit
48
49```
50Perform a technical SEO audit for [URL/domain]
51```
52
53### Specific Issue Check
54
55```
56Check Core Web Vitals for [URL]
57```
58
59```
60Audit crawlability and indexability for [domain]
61```
62
63### Pre-Migration Audit
64
65```
66Technical SEO checklist for migrating [old domain] to [new domain]
67```
68
69## Skill Contract
70
71**Expected output**: a scored diagnosis, prioritized repair plan, and a short handoff summary ready for `memory/audits/`.
72
73- **Reads**: the current page or site state, symptoms, prior audits, and current priorities from [CLAUDE.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CLAUDE.md) and the shared [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md) when available.
74- **Writes**: a user-facing audit or optimization plan plus a reusable summary that can be stored under `memory/audits/`.
75- **Promotes**: blocking defects, repeated weaknesses, and fix priorities to `memory/open-loops.md` and `memory/decisions.md`.
76- **Next handoff**: use the `Next Best Skill` below when the repair path is clear.
77
78## Data Sources
79
80> See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) for tool category placeholders.
81
82**With ~~web crawler + ~~page speed tool + ~~CDN connected:**
83Claude can automatically crawl the entire site structure via ~~web crawler, pull Core Web Vitals and performance metrics from ~~page speed tool, analyze caching headers from ~~CDN, and fetch mobile-friendliness data. This enables comprehensive automated technical audits.
84
85**With manual data only:**
86Ask the user to provide:
871. Site URL(s) to audit
882. PageSpeed Insights screenshots or reports
893. robots.txt file content
904. sitemap.xml URL or file
91
92Proceed with the full audit using provided data. Note in the output which findings are from automated crawl vs. manual review.
93
94## Instructions
95
96When a user requests a technical SEO audit:
97
981. **Audit Crawlability**
99
100 ```markdown
101 ## Crawlability Analysis
102
103 ### Robots.txt Review
104
105 **URL**: [domain]/robots.txt
106 **Status**: [Found/Not Found/Error]
107
108 **Current Content**:
109 ```
110 [robots.txt content]
111 ```
112
113 | Check | Status | Notes |
114 |-------|--------|-------|
115 | File exists | ✅/❌ | [notes] |
116 | Valid syntax | ✅/⚠️/❌ | [errors found] |
117 | Sitemap declared | ✅/❌ | [sitemap URL] |
118 | Important pages blocked | ✅/⚠️/❌ | [blocked paths] |
119 | Assets blocked | ✅/⚠️/❌ | [CSS/JS blocked?] |
120 | Correct user-agents | ✅/⚠️/❌ | [notes] |
121
122 **Issues Found**:
123 - [Issue 1]
124 - [Issue 2]
125
126 **Recommended robots.txt**:
127 ```
128 User-agent: *
129 Allow: /
130 Disallow: /admin/
131 Disallow: /private/
132
133 Sitemap: https://example.com/sitemap.xml
134 ```
135
136 ---
137
138 ### XML Sitemap Review
139
140 **Sitemap URL**: [URL]
141 **Status**: [Found/Not Found/Error]
142
143 | Check | Status | Notes |
144 |-------|--------|-------|
145 | Sitemap exists | ✅/❌ | [notes] |
146 | Valid XML format | ✅/⚠️/❌ | [errors] |
147 | In robots.txt | ✅/❌ | [notes] |
148 | Submitted to ~~search console | ✅/⚠️/❌ | [notes] |
149 | URLs count | [X] | [appropriate?] |
150 | Only indexable URLs | ✅/⚠️/❌ | [notes] |
151 | Includes priority | ✅/⚠️ | [notes] |
152 | Includes lastmod | ✅/⚠️ | [accurate?] |
153
154 **Issues Found**:
155 - [Issue 1]
156
157 ---
158
159 ### Crawl Budget Analysis
160
161 | Factor | Status | Impact |
162 |--------|--------|--------|
163 | Crawl errors | [X] errors | [Low/Med/High] |
164 | Duplicate content | [X] pages | [Low/Med/High] |
165 | Thin content | [X] pages | [Low/Med/High] |
166 | Redirect chains | [X] found | [Low/Med/High] |
167 | Orphan pages | [X] found | [Low/Med/High] |
168
169 **Crawlability Score**: [X]/10
170 ```
171
1722. **Audit Indexability**
173
174 ```markdown
175 ## Indexability Analysis
176
177 ### Index Status Overview
178
179 | Metric | Count | Notes |
180 |--------|-------|-------|
181 | Pages in sitemap | [X] | |
182 | Pages indexed | [X] | [source: site: search] |
183 | Index coverage ratio | [X]% | [good if >90%] |
184
185 ### Index Blockers Check
186
187 | Blocker Type | Found | Pages Affected |
188 |--------------|-------|----------------|
189 | noindex meta tag | [X] | [list or "none"] |
190 | noindex X-Robots | [X] | [list or "none"] |
191 | Robots.txt blocked | [X] | [list or "none"] |
192 | Canonical to other | [X] | [list or "none"] |
193 | 4xx/5xx errors | [X] | [list or "none"] |
194 | Redirect loops | [X] | [list or "none"] |
195
196 ### Canonical Tags Audit
197
198 | Check | Status | Notes |
199 |-------|--------|-------|
200 | Canonicals present | ✅/⚠️/❌ | [X]% of pages |
201 | Self-referencing | ✅/⚠️/❌ | [notes] |
202 | Consistent (HTTP/HTTPS) | ✅/⚠️/❌ | [notes] |
203 | Consistent (www/non-www) | ✅/⚠️/❌ | [notes] |
204 | No conflicting signals | ✅/⚠️/❌ | [notes] |
205
206 ### Duplicate Content Issues
207
208 | Issue Type | Count | Examples |
209 |------------|-------|----------|
210 | Exact duplicates | [X] | [URLs] |
211 | Near duplicates | [X] | [URLs] |
212 | Parameter duplicates | [X] | [URLs] |
213 | WWW/non-WWW | [X] | [notes] |
214 | HTTP/HTTPS | [X] | [notes] |
215
216 **Indexability Score**: [X]/10
217 ```
218
2193. **Audit Site Speed & Core Web Vitals** — CWV metrics (LCP/FID/CLS/INP), additional performance metrics (TTFB/FCP/Speed Index/TBT), resource loading breakdown, optimization recommendations
220
221 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the performance analysis template (Step 3).
222
2234. **Audit Mobile-Friendliness** — Mobile-friendly test, responsive design check, mobile-first indexing verification
224
225 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the mobile optimization template (Step 4).
226
2275. **Audit Security & HTTPS** — SSL certificate, HTTPS enforcement, mixed content, HSTS, security headers (CSP, X-Frame-Options, etc.)
228
229 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the security analysis template (Step 5).
230
2316. **Audit URL Structure** — URL patterns, issues (dynamic params, session IDs, uppercase), redirect analysis (chains, loops, 302s)
232
233 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the URL structure template (Step 6).
234
2357. **Audit Structured Data** — Schema markup validation, missing schema opportunities. CORE-EEAT alignment: maps to O05.
236
237 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the structured data template (Step 7).
238
2398. **Audit International SEO (if applicable)** — Hreflang implementation, language/region targeting
240
241 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the international SEO template (Step 8).
242
2439. **Generate Technical Audit Summary** — Overall health score with visual breakdown, critical/high/medium issues, quick wins, implementation roadmap (weeks 1-4+), monitoring recommendations
244
245 > **Reference**: See [references/technical-audit-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) for the audit summary template (Step 9).
246
247## Validation Checkpoints
248
249### Input Validation
250- [ ] Site URL or domain clearly specified
251- [ ] Access to technical data (robots.txt, sitemap, or crawl results)
252- [ ] Performance metrics available (via ~~page speed tool or screenshots)
253
254### Output Validation
255- [ ] Every recommendation cites specific data points (not generic advice)
256- [ ] All issues include affected URLs or page counts
257- [ ] Performance metrics include actual numbers with units (seconds, KB, etc.)
258- [ ] Source of each data point clearly stated (~~web crawler data, ~~page speed tool, user-provided, or estimated)
259
260## Example
261
262> **Reference**: See [references/technical-audit-example.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-example.md) for a full worked example (cloudhosting.com technical audit) and the comprehensive technical SEO checklist.
263
264## Tips for Success
265
2661. **Prioritize by impact** - Fix critical issues first
2672. **Monitor continuously** - Use ~~search console alerts
2683. **Test changes** - Verify fixes work before deploying widely
2694. **Document everything** - Track changes for troubleshooting
2705. **Regular audits** - Schedule quarterly technical reviews
271
272> **Technical reference**: For issue severity framework, prioritization matrix, and Core Web Vitals optimization quick reference, see [references/http-status-codes.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/http-status-codes.md).
273
274
275### Save Results
276
277After delivering audit or optimization findings to the user, ask:
278
279> "Save these results for future sessions?"
280
281If yes, write a dated summary to `memory/audits/technical-seo-checker/YYYY-MM-DD-<topic>.md` containing:
282- One-line verdict or headline finding
283- Top 3-5 actionable items
284- Open loops or blockers
285- Source data references
286
287If any veto-level issue was found (CORE-EEAT T04, C01, R10 or CITE T03, T05, T09), also append a one-liner to `memory/hot-cache.md` without asking.
288
289## Reference Materials
290
291- [robots.txt Reference](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/robots-txt-reference.md) — Syntax guide, templates, common configurations
292- [HTTP Status Codes](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/http-status-codes.md) — SEO impact of each status code, redirect best practices
293- [Technical Audit Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-templates.md) — Detailed output templates for steps 3-9 (CWV, mobile, security, URL structure, structured data, international, audit summary)
294- [Technical Audit Example & Checklist](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/references/technical-audit-example.md) — Full worked example and comprehensive technical SEO checklist
295
296## Next Best Skill
297
298- **Primary**: [on-page-seo-auditor](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/on-page-seo-auditor/SKILL.md) — continue from infrastructure issues into page-level remediation.