| 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
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
curl -s https://example.com/robots.txt
curl -I https://example.com
curl -sIL https://example.com 2>&1 | grep -E "HTTP/|Location:"
curl -s https://example.com/sitemap.xml | head -20
curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com&strategy=mobile"
dig example.com +short
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
