technical-seo-audit

name	technical-seo-audit
description	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.
license	MIT
origin	custom
author	Rebecca Rae Barton
author_url	https://github.com/thatrebeccarae
metadata	{"version":"1.0.0","category":"seo","domain":"technical-seo","updated":"2026-03-18T00:00:00.000Z","tested":"2026-03-18T00:00:00.000Z","tested_with":"Claude Code v2.1"}

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

• Images: WebP/AVIF format, responsive srcset, lazy loading below fold
• CSS: Critical CSS inlined, non-critical deferred
• JavaScript: Deferred or async loading, code splitting
• Fonts: Preloaded, font-display set, subset if possible
• Server: HTTP/2 or HTTP/3, compression (Brotli > gzip), CDN
• Caching: Proper cache-control headers, service worker for repeat visits

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