Technical SEO Audit
Deep technical SEO analysis: crawlability, indexation, Core Web Vitals, site architecture, and performance.
Install
git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/technical-seo-audit ~/.claude/skills/
How this differs from seo-content-writer: The seo-content-writer skill focuses on content optimization — keywords, readability, meta tags, heading structure. This skill audits the technical foundation — can search engines crawl, render, and index your site correctly?
Audit Framework
Phase 1: Crawlability & Indexation
robots.txt Analysis
- Verify file exists at
/robots.txt
- Check for unintentional blocks (
Disallow: / on production)
- Validate sitemap reference
- Review AI crawler directives (GPTBot, ClaudeBot, PerplexityBot)
XML Sitemap Audit
- Validate sitemap format (XML schema compliance)
- Check for 404, 301, or 5xx URLs in sitemap
- Verify lastmod dates are accurate (not all the same date)
- Confirm sitemap is referenced in robots.txt
- Check sitemap size (under 50MB / 50,000 URLs per file)
- For large sites: verify sitemap index file structure
Indexation Health
- Compare indexed pages (site:domain.com) vs expected pages
- Identify index bloat (thin, duplicate, or low-value pages indexed)
- Check for noindex tags on important pages
- Review Google Search Console coverage report patterns
- Identify orphan pages (in sitemap but no internal links)
Crawl Budget Optimization
- Identify crawl traps (infinite pagination, calendar URLs, faceted navigation)
- Check crawl depth (critical pages should be within 3 clicks)
- Review log files for crawler behavior patterns
- Identify wasted crawl budget on low-value URLs
Phase 2: Site Architecture & Internal Linking
URL Structure
- Consistent URL patterns (lowercase, hyphens, no trailing slashes OR consistent trailing slashes)
- Logical hierarchy reflecting content taxonomy
- No URL parameters where clean URLs are possible
- Proper handling of pagination (rel=next/prev or load-more)
Internal Link Analysis
- PageRank flow: are high-authority pages linking to important content?
- Orphan page detection (pages with zero internal links)
- Broken internal links (404s)
- Anchor text distribution (relevant, varied, not over-optimized)
- Link depth audit (pages more than 3 clicks from homepage)
Navigation & Hierarchy
- Breadcrumb implementation (with BreadcrumbList schema)
- Navigation depth (flatten deep hierarchies)
- Footer link optimization
- Faceted navigation handling (noindex, canonical, or robots)
Phase 3: Core Web Vitals & Performance
Largest Contentful Paint (LCP) — Target: <2.5s
- Identify LCP element (usually hero image or H1)
- Check image optimization (format, compression, dimensions)
- Verify preload for LCP resources
- Check server response time (TTFB)
- Review render-blocking resources
Interaction to Next Paint (INP) — Target: <200ms
- Identify long tasks blocking the main thread
- Review JavaScript execution time
- Check event handler performance
- Evaluate third-party script impact
Cumulative Layout Shift (CLS) — Target: <0.1
- Check for images/embeds without dimensions
- Review dynamic content injection above the fold
- Verify font loading strategy (font-display: swap or optional)
- Check ad slot reservations
Performance Checklist
Phase 4: On-Page Technical Elements
Meta Tags
- Title tags: unique, 50-60 characters, primary keyword near start
- Meta descriptions: unique, 150-160 characters, include CTA
- Viewport meta tag present
- Charset declaration (UTF-8)
- No conflicting meta robots directives
Canonical Tags
- Every page has a canonical tag (self-referencing or pointing to canonical version)
- Canonical tags are absolute URLs (not relative)
- No canonical chains (A -> B -> C)
- Canonicals consistent with internal links, sitemaps, and hreflang
- HTTP pages canonical to HTTPS versions
Heading Hierarchy
- Single H1 per page
- Logical H1 > H2 > H3 nesting (no skipped levels)
- H1 contains primary keyword
- Headings are descriptive (not "Introduction" or "Section 1")
Structured Data
- Validate with Google Rich Results Test
- Check for errors/warnings in Search Console
- Verify required fields per schema type
- Cross-reference with aeo-geo-optimizer and schema-markup-generator skills
Phase 5: HTTPS & Security
- SSL certificate valid and not expiring soon
- All resources loaded over HTTPS (no mixed content)
- HTTP to HTTPS redirect chain (single 301, not chain)
- HSTS header present
- Security headers (X-Content-Type-Options, X-Frame-Options, CSP)
Phase 6: International & Multi-Language (if applicable)
- Hreflang implementation (correct language/region codes)
- Hreflang reciprocal links (A points to B, B points to A)
- X-default tag for fallback
- Language-specific sitemaps
- Content localization quality (not just translation)
Phase 7: Mobile Optimization
- Mobile-first indexing readiness (same content on mobile and desktop)
- Touch targets sized appropriately (48x48px minimum)
- No horizontal scrolling
- Readable font sizes without zooming (16px base minimum)
- Mobile page speed (test on 3G connection profile)
Audit Report Structure
Executive Summary
- Overall technical health score (0-100)
- Critical issues count (blocking indexation/ranking)
- High-priority issues count (impacting performance)
- Quick wins count (easy fixes, high impact)
Issue Classification
| Severity |
Definition |
Response Time |
| Critical |
Blocking crawling, indexation, or rendering |
Immediate |
| High |
Significantly impacting rankings or UX |
Within 1 week |
| Medium |
Impacting performance or best practices |
Within 1 month |
| Low |
Minor optimizations or future-proofing |
Backlog |
Per-Issue Format
**Issue:** [What is wrong]
**Impact:** [How it affects SEO performance]
**Pages Affected:** [Count or list]
**Fix:** [Specific remediation steps]
**Validation:** [How to verify the fix worked]
Common Tools & Commands
# Check robots.txt
curl -s https://example.com/robots.txt
# Check HTTP headers
curl -I https://example.com
# Check redirect chain
curl -sIL https://example.com 2>&1 | grep -E "HTTP/|Location:"
# Validate sitemap
curl -s https://example.com/sitemap.xml | head -20
# Check page speed (via PageSpeed Insights API)
curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com&strategy=mobile"
# Check DNS resolution
dig example.com +short
# Check SSL certificate
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -dates
Benchmarks
| Metric |
Good |
Needs Work |
Poor |
| LCP |
<2.5s |
2.5-4.0s |
>4.0s |
| INP |
<200ms |
200-500ms |
>500ms |
| CLS |
<0.1 |
0.1-0.25 |
>0.25 |
| TTFB |
<800ms |
800ms-1.8s |
>1.8s |
| Page size |
<1.5MB |
1.5-3MB |
>3MB |
| Requests |
<50 |
50-100 |
>100 |
| Crawl depth |
<=3 clicks |
4-5 clicks |
>5 clicks |
Integration with Other Skills
- aeo-geo-optimizer — Layer AI search optimization after technical foundation is solid
- schema-markup-generator — Generate structured data identified as missing during audit
- google-analytics — Correlate technical issues with traffic impact
- pro-report-builder — Generate professional audit deliverable from findings
1---2name: technical-seo-audit3description: Deep technical SEO auditing covering crawlability, indexation, Core Web Vitals, site architecture, canonicalization, structured data validation, and performance optimization. Use when the user asks about technical SEO, site audits, crawl issues, indexation problems, Core Web Vitals, page speed, or site architecture optimization. For content-focused SEO, see the seo-content-writer skill.4license: MIT5---67# Technical SEO Audit89Deep technical SEO analysis: crawlability, indexation, Core Web Vitals, site architecture, and performance.1011## Install1213```bash14git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/technical-seo-audit ~/.claude/skills/15```1617> **How this differs from seo-content-writer:** The seo-content-writer skill focuses on content optimization — keywords, readability, meta tags, heading structure. This skill audits the technical foundation — can search engines crawl, render, and index your site correctly?1819## Audit Framework2021### Phase 1: Crawlability & Indexation2223#### robots.txt Analysis24- Verify file exists at `/robots.txt`25- Check for unintentional blocks (`Disallow: /` on production)26- Validate sitemap reference27- Review AI crawler directives (GPTBot, ClaudeBot, PerplexityBot)2829#### XML Sitemap Audit30- Validate sitemap format (XML schema compliance)31- Check for 404, 301, or 5xx URLs in sitemap32- Verify lastmod dates are accurate (not all the same date)33- Confirm sitemap is referenced in robots.txt34- Check sitemap size (under 50MB / 50,000 URLs per file)35- For large sites: verify sitemap index file structure3637#### Indexation Health38- Compare indexed pages (site:domain.com) vs expected pages39- Identify index bloat (thin, duplicate, or low-value pages indexed)40- Check for noindex tags on important pages41- Review Google Search Console coverage report patterns42- Identify orphan pages (in sitemap but no internal links)4344#### Crawl Budget Optimization45- Identify crawl traps (infinite pagination, calendar URLs, faceted navigation)46- Check crawl depth (critical pages should be within 3 clicks)47- Review log files for crawler behavior patterns48- Identify wasted crawl budget on low-value URLs4950### Phase 2: Site Architecture & Internal Linking5152#### URL Structure53- Consistent URL patterns (lowercase, hyphens, no trailing slashes OR consistent trailing slashes)54- Logical hierarchy reflecting content taxonomy55- No URL parameters where clean URLs are possible56- Proper handling of pagination (rel=next/prev or load-more)5758#### Internal Link Analysis59- PageRank flow: are high-authority pages linking to important content?60- Orphan page detection (pages with zero internal links)61- Broken internal links (404s)62- Anchor text distribution (relevant, varied, not over-optimized)63- Link depth audit (pages more than 3 clicks from homepage)6465#### Navigation & Hierarchy66- Breadcrumb implementation (with BreadcrumbList schema)67- Navigation depth (flatten deep hierarchies)68- Footer link optimization69- Faceted navigation handling (noindex, canonical, or robots)7071### Phase 3: Core Web Vitals & Performance7273#### Largest Contentful Paint (LCP) — Target: <2.5s74- Identify LCP element (usually hero image or H1)75- Check image optimization (format, compression, dimensions)76- Verify preload for LCP resources77- Check server response time (TTFB)78- Review render-blocking resources7980#### Interaction to Next Paint (INP) — Target: <200ms81- Identify long tasks blocking the main thread82- Review JavaScript execution time83- Check event handler performance84- Evaluate third-party script impact8586#### Cumulative Layout Shift (CLS) — Target: <0.187- Check for images/embeds without dimensions88- Review dynamic content injection above the fold89- Verify font loading strategy (font-display: swap or optional)90- Check ad slot reservations9192#### Performance Checklist93- [ ] Images: WebP/AVIF format, responsive srcset, lazy loading below fold94- [ ] CSS: Critical CSS inlined, non-critical deferred95- [ ] JavaScript: Deferred or async loading, code splitting96- [ ] Fonts: Preloaded, font-display set, subset if possible97- [ ] Server: HTTP/2 or HTTP/3, compression (Brotli > gzip), CDN98- [ ] Caching: Proper cache-control headers, service worker for repeat visits99100### Phase 4: On-Page Technical Elements101102#### Meta Tags103- Title tags: unique, 50-60 characters, primary keyword near start104- Meta descriptions: unique, 150-160 characters, include CTA105- Viewport meta tag present106- Charset declaration (UTF-8)107- No conflicting meta robots directives108109#### Canonical Tags110- Every page has a canonical tag (self-referencing or pointing to canonical version)111- Canonical tags are absolute URLs (not relative)112- No canonical chains (A -> B -> C)113- Canonicals consistent with internal links, sitemaps, and hreflang114- HTTP pages canonical to HTTPS versions115116#### Heading Hierarchy117- Single H1 per page118- Logical H1 > H2 > H3 nesting (no skipped levels)119- H1 contains primary keyword120- Headings are descriptive (not "Introduction" or "Section 1")121122#### Structured Data123- Validate with Google Rich Results Test124- Check for errors/warnings in Search Console125- Verify required fields per schema type126- Cross-reference with aeo-geo-optimizer and schema-markup-generator skills127128### Phase 5: HTTPS & Security129130- SSL certificate valid and not expiring soon131- All resources loaded over HTTPS (no mixed content)132- HTTP to HTTPS redirect chain (single 301, not chain)133- HSTS header present134- Security headers (X-Content-Type-Options, X-Frame-Options, CSP)135136### Phase 6: International & Multi-Language (if applicable)137138- Hreflang implementation (correct language/region codes)139- Hreflang reciprocal links (A points to B, B points to A)140- X-default tag for fallback141- Language-specific sitemaps142- Content localization quality (not just translation)143144### Phase 7: Mobile Optimization145146- Mobile-first indexing readiness (same content on mobile and desktop)147- Touch targets sized appropriately (48x48px minimum)148- No horizontal scrolling149- Readable font sizes without zooming (16px base minimum)150- Mobile page speed (test on 3G connection profile)151152## Audit Report Structure153154### Executive Summary155- Overall technical health score (0-100)156- Critical issues count (blocking indexation/ranking)157- High-priority issues count (impacting performance)158- Quick wins count (easy fixes, high impact)159160### Issue Classification161162| Severity | Definition | Response Time |163|----------|-----------|---------------|164| Critical | Blocking crawling, indexation, or rendering | Immediate |165| High | Significantly impacting rankings or UX | Within 1 week |166| Medium | Impacting performance or best practices | Within 1 month |167| Low | Minor optimizations or future-proofing | Backlog |168169### Per-Issue Format170171```172**Issue:** [What is wrong]173**Impact:** [How it affects SEO performance]174**Pages Affected:** [Count or list]175**Fix:** [Specific remediation steps]176**Validation:** [How to verify the fix worked]177```178179## Common Tools & Commands180181```bash182# Check robots.txt183curl -s https://example.com/robots.txt184185# Check HTTP headers186curl -I https://example.com187188# Check redirect chain189curl -sIL https://example.com 2>&1 | grep -E "HTTP/|Location:"190191# Validate sitemap192curl -s https://example.com/sitemap.xml | head -20193194# Check page speed (via PageSpeed Insights API)195curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com&strategy=mobile"196197# Check DNS resolution198dig example.com +short199200# Check SSL certificate201echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -dates202```203204## Benchmarks205206| Metric | Good | Needs Work | Poor |207|--------|------|------------|------|208| LCP | <2.5s | 2.5-4.0s | >4.0s |209| INP | <200ms | 200-500ms | >500ms |210| CLS | <0.1 | 0.1-0.25 | >0.25 |211| TTFB | <800ms | 800ms-1.8s | >1.8s |212| Page size | <1.5MB | 1.5-3MB | >3MB |213| Requests | <50 | 50-100 | >100 |214| Crawl depth | <=3 clicks | 4-5 clicks | >5 clicks |215216## Integration with Other Skills217218- **aeo-geo-optimizer** — Layer AI search optimization after technical foundation is solid219- **schema-markup-generator** — Generate structured data identified as missing during audit220- **google-analytics** — Correlate technical issues with traffic impact221- **pro-report-builder** — Generate professional audit deliverable from findings