Technical SEO Checker
SEO & GEO Skills Library ยท 20 skills for SEO + GEO ยท Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills
Research ยท keyword-research ยท competitor-analysis ยท serp-analysis ยท content-gap-analysis
Build ยท seo-content-writer ยท geo-content-optimizer ยท meta-tags-optimizer ยท schema-markup-generator
Optimize ยท on-page-seo-auditor ยท technical-seo-checker ยท internal-linking-optimizer ยท content-refresher
Monitor ยท rank-tracker ยท backlink-analyzer ยท performance-reporter ยท alert-manager
Cross-cutting ยท content-quality-auditor ยท domain-authority-auditor ยท entity-optimizer ยท memory-management
This skill performs comprehensive technical SEO audits to identify issues that may prevent search engines from properly crawling, indexing, and ranking your site.
When to Use This Skill
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
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]
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
- ## Performance Analysis
- ### Core Web Vitals
- | Metric | Mobile | Desktop | Target | Status |
- |--------|--------|---------|--------|--------|
- | LCP (Largest Contentful Paint) | [X]s | [X]s | <2.5s | โ
/โ ๏ธ/โ |
- | FID (First Input Delay) | [X]ms | [X]ms | <100ms | โ
/โ ๏ธ/โ |
- | CLS (Cumulative Layout Shift) | [X] | [X] | <0.1 | โ
/โ ๏ธ/โ |
- | INP (Interaction to Next Paint) | [X]ms | [X]ms | <200ms | โ
/โ ๏ธ/โ |
- ### Additional Performance Metrics
- | Metric | Value | Status |
- |--------|-------|--------|
- | Time to First Byte (TTFB) | [X]ms | โ
/โ ๏ธ/โ |
- | First Contentful Paint (FCP) | [X]s | โ
/โ ๏ธ/โ |
- | Speed Index | [X] | โ
/โ ๏ธ/โ |
- | Total Blocking Time | [X]ms | โ
/โ ๏ธ/โ |
- | Page Size | [X]MB | โ
/โ ๏ธ/โ |
- | Requests | [X] | โ
/โ ๏ธ/โ |
- ### Performance Issues
- **LCP Issues**:
- [Issue]: [Impact] - [Solution]
- [Issue]: [Impact] - [Solution]
- **CLS Issues**:
- [Issue]: [Impact] - [Solution]
- **Resource Loading**:
- | Resource Type | Count | Size | Issues |
- |---------------|-------|------|--------|
- | Images | [X] | [X]MB | [notes] |
- | JavaScript | [X] | [X]MB | [notes] |
- | CSS | [X] | [X]KB | [notes] |
- | Fonts | [X] | [X]KB | [notes] |
- ### Optimization Recommendations
- **High Impact**:
- 1. [Recommendation] - Est. improvement: [X]s
- 2. [Recommendation] - Est. improvement: [X]s
- **Medium Impact**:
- 1. [Recommendation]
- 2. [Recommendation]
- **Performance Score**: [X]/10
- Audit Mobile-Friendliness
- ## Mobile Optimization Analysis
- ### Mobile-Friendly Test
- | Check | Status | Notes |
- |-------|--------|-------|
- | Mobile-friendly overall | โ
/โ | [notes] |
- | Viewport configured | โ
/โ | [viewport tag] |
- | Text readable | โ
/โ ๏ธ/โ | Font size: [X]px |
- | Tap targets sized | โ
/โ ๏ธ/โ | [notes] |
- | Content fits viewport | โ
/โ | [notes] |
- | No horizontal scroll | โ
/โ | [notes] |
- ### Responsive Design Check
- | Element | Desktop | Mobile | Issues |
- |---------|---------|--------|--------|
- | Navigation | [status] | [status] | [notes] |
- | Images | [status] | [status] | [notes] |
- | Forms | [status] | [status] | [notes] |
- | Tables | [status] | [status] | [notes] |
- | Videos | [status] | [status] | [notes] |
- ### Mobile-First Indexing
- | Check | Status | Notes |
- |-------|--------|-------|
- | Mobile version has all content | โ
/โ ๏ธ/โ | [notes] |
- | Mobile has same structured data | โ
/โ ๏ธ/โ | [notes] |
- | Mobile has same meta tags | โ
/โ ๏ธ/โ | [notes] |
- | Mobile images have alt text | โ
/โ ๏ธ/โ | [notes] |
- **Mobile Score**: [X]/10
- Audit Security & HTTPS
- ## Security Analysis
- ### HTTPS Status
- | Check | Status | Notes |
- |-------|--------|-------|
- | SSL certificate valid | โ
/โ | Expires: [date] |
- | HTTPS enforced | โ
/โ | [redirects properly?] |
- | Mixed content | โ
/โ ๏ธ/โ | [X] issues |
- | HSTS enabled | โ
/โ ๏ธ | [notes] |
- | Certificate chain | โ
/โ ๏ธ/โ | [notes] |
- ### Security Headers
- | Header | Present | Value | Recommended |
- |--------|---------|-------|-------------|
- | Content-Security-Policy | โ
/โ | [value] | [recommendation] |
- | X-Frame-Options | โ
/โ | [value] | DENY or SAMEORIGIN |
- | X-Content-Type-Options | โ
/โ | [value] | nosniff |
- | X-XSS-Protection | โ
/โ | [value] | 1; mode=block |
- | Referrer-Policy | โ
/โ | [value] | [recommendation] |
- **Security Score**: [X]/10
- Audit URL Structure
- ## URL Structure Analysis
- ### URL Pattern Review
- | Check | Status | Notes |
- |-------|--------|-------|
- | HTTPS URLs | โ
/โ ๏ธ/โ | [X]% HTTPS |
- | Lowercase URLs | โ
/โ ๏ธ/โ | [notes] |
- | No special characters | โ
/โ ๏ธ/โ | [notes] |
- | Readable/descriptive | โ
/โ ๏ธ/โ | [notes] |
- | Appropriate length | โ
/โ ๏ธ/โ | Avg: [X] chars |
- | Keywords in URLs | โ
/โ ๏ธ/โ | [notes] |
- | Consistent structure | โ
/โ ๏ธ/โ | [notes] |
- ### URL Issues Found
- | Issue Type | Count | Examples |
- |------------|-------|----------|
- | Dynamic parameters | [X] | [URLs] |
- | Session IDs in URLs | [X] | [URLs] |
- | Uppercase characters | [X] | [URLs] |
- | Special characters | [X] | [URLs] |
- | Very long URLs (>100) | [X] | [URLs] |
- ### Redirect Analysis
- | Check | Status | Notes |
- |-------|--------|-------|
- | Redirect chains | [X] found | [max chain length] |
- | Redirect loops | [X] found | [URLs] |
- | 302 โ 301 needed | [X] found | [URLs] |
- | Broken redirects | [X] found | [URLs] |
- **URL Score**: [X]/10
- Audit Structured Data
- CORE-EEAT alignment: Schema markup quality maps to O05 (Schema Markup) in the CORE-EEAT benchmark. See content-quality-auditor for full content quality audit.
- ## Structured Data Analysis
- ### Schema Markup Found
- | Schema Type | Pages | Valid | Errors |
- |-------------|-------|-------|--------|
- | [Type 1] | [X] | โ
/โ | [errors] |
- | [Type 2] | [X] | โ
/โ | [errors] |
- ### Validation Results
- **Errors**:
- [Error 1]: [affected pages] - [solution]
- [Error 2]: [affected pages] - [solution]
- **Warnings**:
- [Warning 1]: [notes]
- ### Missing Schema Opportunities
- | Page Type | Current Schema | Recommended |
- |-----------|----------------|-------------|
- | Blog posts | [current] | Article + FAQ |
- | Products | [current] | Product + Review |
- | Homepage | [current] | Organization |
- **Structured Data Score**: [X]/10
- Audit International SEO (if applicable)
- ## International SEO Analysis
- ### Hreflang Implementation
- | Check | Status | Notes |
- |-------|--------|-------|
- | Hreflang tags present | โ
/โ | [notes] |
- | Self-referencing | โ
/โ ๏ธ/โ | [notes] |
- | Return tags present | โ
/โ ๏ธ/โ | [notes] |
- | Valid language codes | โ
/โ ๏ธ/โ | [notes] |
- | x-default tag | โ
/โ ๏ธ | [notes] |
- ### Language/Region Targeting
- | Language | URL | Hreflang | Status |
- |----------|-----|----------|--------|
- | [en-US] | [URL] | [tag] | โ
/โ ๏ธ/โ |
- | [es-ES] | [URL] | [tag] | โ
/โ ๏ธ/โ |
- **International Score**: [X]/10
- Generate Technical Audit Summary
- # Technical SEO Audit Report
- **Domain**: [domain]
- **Audit Date**: [date]
- **Pages Analyzed**: [X]
- ## Overall Technical Health: [X]/100
- Score Breakdown:
- โโโโโโโโโโ Crawlability: 8/10
- โโโโโโโโโโ Indexability: 7/10
- โโโโโโโโโโ Performance: 5/10
- โโโโโโโโโโ Mobile: 8/10
- โโโโโโโโโโ Security: 9/10
- โโโโโโโโโโ URL Structure: 6/10
- โโโโโโโโโโ Structured Data: 5/10
- ## Critical Issues (Fix Immediately)
- 1. **[Issue]**: [Impact]
- - Affected: [pages/scope]
- - Solution: [specific fix]
- - Priority: ๐ด Critical
- 2. **[Issue]**: [Impact]
- - Affected: [pages/scope]
- - Solution: [specific fix]
- - Priority: ๐ด Critical
- ## High Priority Issues
- 1. **[Issue]**: [Solution]
- 2. **[Issue]**: [Solution]
- ## Medium Priority Issues
- 1. **[Issue]**: [Solution]
- 2. **[Issue]**: [Solution]
- ## Quick Wins
- These can be fixed quickly for immediate improvement:
- 1. [Quick fix 1]
- 2. [Quick fix 2]
- 3. [Quick fix 3]
- ## Implementation Roadmap
- ### Week 1: Critical Fixes
- [ ] [Task 1]
- [ ] [Task 2]
- ### Week 2-3: High Priority
- [ ] [Task 1]
- [ ] [Task 2]
- ### Week 4+: Optimization
- [ ] [Task 1]
- [ ] [Task 2]
- ## Monitoring Recommendations
- Set up alerts for:
- Core Web Vitals drops
- Crawl error spikes
- Index coverage changes
- Security issues
Input Validation
Site URL or domain clearly specified
Access to technical data (robots.txt, sitemap, or crawl results)
Performance metrics available (via ~~page speed tool or screenshots)
Output Validation
Every recommendation cites specific data points (not generic advice)
All issues include affected URLs or page counts
Performance metrics include actual numbers with units (seconds, KB, etc.)
Source of each data point clearly stated (~~web crawler data, ~~page speed tool, user-provided, or estimated)
Example
- User: "Check the technical SEO of cloudhosting.com"
- Output:
- # Technical SEO Audit Report
- **Domain**: cloudhosting.com
- **Audit Date**: 2024-09-15
- **Pages Analyzed**: 312
- ## Crawlability Analysis
- ### Robots.txt Review
- **URL**: cloudhosting.com/robots.txt
- **Status**: Found
- | Check | Status | Notes |
- |-------|--------|-------|
- | File exists | โ
| 200 response |
- | Valid syntax | โ ๏ธ | Wildcard pattern `Disallow: /*?` too aggressive โ blocks faceted pages |
- | Sitemap declared | โ | No Sitemap directive in robots.txt |
- | Important pages blocked | โ ๏ธ | /pricing/ blocked by `Disallow: /pricing` rule |
- | Assets blocked | โ
| CSS/JS accessible |
- **Issues Found**:
- Sitemap URL not declared in robots.txt
- `/pricing/` inadvertently blocked โ high-value commercial page
- ### XML Sitemap Review
- **Sitemap URL**: cloudhosting.com/sitemap.xml
- **Status**: Found (not referenced in robots.txt)
- | Check | Status | Notes |
- |-------|--------|-------|
- | Sitemap exists | โ
| Valid XML, 287 URLs |
- | Only indexable URLs | โ | 23 noindex URLs included |
- | Includes lastmod | โ ๏ธ | All dates set to 2023-01-01 โ not accurate |
- **Crawlability Score**: 5/10
- ## Performance Analysis
- ### Core Web Vitals
- | Metric | Mobile | Desktop | Target | Status |
- |--------|--------|---------|--------|--------|
- | LCP (Largest Contentful Paint) | 4.8s | 2.1s | <2.5s | โ Mobile / โ
Desktop |
- | FID (First Input Delay) | 45ms | 12ms | <100ms | โ
/ โ
|
- | CLS (Cumulative Layout Shift) | 0.24 | 0.08 | <0.1 | โ Mobile / โ
Desktop |
- | INP (Interaction to Next Paint) | 380ms | 140ms | <200ms | โ Mobile / โ
Desktop |
- ### Additional Performance Metrics
- | Metric | Value | Status |
- |--------|-------|--------|
- | Time to First Byte (TTFB) | 1,240ms | โ |
- | Page Size | 3.8MB | โ |
- | Requests | 94 | โ ๏ธ |
- **LCP Issues**:
- Uncompressed hero image (2.4MB PNG): Convert to WebP, est. save 1.9MB
- No CDN detected: TTFB 1,240ms from origin server
- **CLS Issues**:
- Ad banner at top of page injects without reserved height (0.18 shift contribution)
- **Performance Score**: 3/10
- ## Security Analysis
- ### HTTPS Status
- | Check | Status | Notes |
- |-------|--------|-------|
- | SSL certificate valid | โ
| Expires: 2025-03-22 |
- | HTTPS enforced | โ ๏ธ | http://cloudhosting.com returns 200 instead of 301 redirect |
- | Mixed content | โ | 7 images loaded over HTTP on /features/ page |
- | HSTS enabled | โ | Header not present |
- **Security Score**: 5/10
- ## Structured Data Analysis
- ### Schema Markup Found
- | Schema Type | Pages | Valid | Errors |
- |-------------|-------|-------|--------|
- | Organization | 1 (homepage) | โ
| None |
- | Article | 0 | โ | Missing on 48 blog posts |
- | Product | 0 | โ | Missing on 5 plan pages |
- | FAQ | 0 | โ | Missing on 12 pages with FAQ content |
- **Structured Data Score**: 3/10
- ## Overall Technical Health: 42/100
- Score Breakdown:
- โโโโโโโโโโ Crawlability: 5/10
- โโโโโโโโโโ Indexability: 6/10
- โโโโโโโโโโ Performance: 3/10
- โโโโโโโโโโ Mobile: 6/10
- โโโโโโโโโโ Security: 5/10
- โโโโโโโโโโ URL Structure: 6/10
- โโโโโโโโโโ Structured Data: 3/10
- ## Priority Issues
- ### ๐ด Critical (Fix Immediately)
- 1. **Mobile LCP 4.8s (target <2.5s)** โ Compress hero image to WebP (est. save 1.9MB) and implement a CDN to reduce TTFB from 1,240ms to <400ms.
- ### ๐ก Important (Fix Soon)
- 2. **HTTP not redirecting to HTTPS** โ Add 301 redirect from http:// to https:// and enable HSTS header. 7 mixed-content images on /features/ need URL updates.
- ### ๐ข Minor (Optimize)
- 3. **No Article/FAQ schema on blog posts** โ Add Article schema to 48 blog posts and FAQ schema to 12 FAQ pages for rich result eligibility.
Technical SEO Checklist
- ### Crawlability
- [ ] robots.txt is valid and not blocking important content
- [ ] XML sitemap exists and is submitted to ~~search console
- [ ] No crawl errors in ~~search console
- [ ] No redirect chains or loops
- ### Indexability
- [ ] Important pages are indexable
- [ ] Canonical tags are correct
- [ ] No duplicate content issues
- [ ] Pagination is handled correctly
- ### Performance
- [ ] Core Web Vitals pass
- [ ] Page speed under 3 seconds
- [ ] Images are optimized
- [ ] JS/CSS are minified
- ### Mobile
- [ ] Mobile-friendly test passes
- [ ] Viewport is configured
- [ ] Touch elements are properly sized
- ### Security
- [ ] HTTPS is enforced
- [ ] SSL certificate is valid
- [ ] No mixed content
- [ ] Security headers present
- ### Structure
- [ ] URLs are clean and descriptive
- [ ] Site architecture is logical
- [ ] Internal linking is strong
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
Issue Classification
SeverityImpact DescriptionExamplesResponse TimeCriticalPrevents indexation or causes site-wide issuesRobots.txt blocking site, noindex on key pages, site-wide 500 errorsSame dayHighSignificantly impacts rankings or user experienceSlow page speed, missing hreflang, duplicate content, redirect chainsWithin 1 weekMediumAffects specific pages or has moderate impactMissing schema, suboptimal canonicals, thin content pagesWithin 1 monthLowMinor optimization opportunitiesImage compression, minor CLS issues, non-essential schema missingNext quarter
Technical Debt Prioritization Matrix
FactorWeightAssessmentPages affected30%Site-wide > Section > Single pageRevenue impact25%Revenue pages > Blog > Utility pagesFix difficulty20%Config change < Template change < Code rewriteCompetitive impact15%Competitors passing you > parity > you aheadCrawl budget waste10%High waste > Moderate > Minimal
LCP (Largest Contentful Paint) Optimization
Root CauseDetectionFixLarge hero imagePageSpeed InsightsServe WebP, resize to container, add loading="lazy"Render-blocking CSS/JSDevTools CoverageDefer non-critical, inline critical CSSSlow server responseTTFB >800msCDN, server-side caching, upgrade hostingThird-party scriptsDevTools NetworkDefer/async, use facade pattern
CLS (Cumulative Layout Shift) Optimization
Root CauseDetectionFixImages without dimensionsDevToolsAdd explicit width/height attributesAds/embeds without reserved spaceVisual inspectionSet min-height on containersWeb fonts causing FOUTDevToolsfont-display: swap + preload fontsDynamic content injectionVisual inspectionReserve space with CSS
INP (Interaction to Next Paint) Optimization
Root CauseDetectionFixLong JavaScript tasksDevTools PerformanceBreak into smaller tasks, use requestIdleCallbackHeavy event handlersDevToolsDebounce/throttle, use passive listenersMain thread blockingDevToolsWeb workers for heavy computation
Reference Materials
robots.txt Reference - Syntax guide, templates, common configurations
HTTP Status Codes - SEO impact of each status code, redirect best practices
Related Skills
on-page-seo-auditor โ On-page SEO audit
schema-markup-generator โ Fix schema issues
performance-reporter โ Monitor improvements
internal-linking-optimizer โ Fix link issues
alert-manager โ Set up alerts for technical issues found
content-quality-auditor โ Full 80-item CORE-EEAT audit