Agent skill

Technical SEO Audit

by thatrebeccarae in thatrebeccarae/claude-marketing

Deep technical SEO auditing covering crawlability, indexation, Core Web Vitals, site architecture, canonicalization, structured data validation, and performance optimization.

MITAuto-check passedMarketing & SEO

Install Technical SEO Audit

skills CLI
$ npx skills add thatrebeccarae/claude-marketing --skill technical-seo-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thatrebeccarae/claude-marketing technical-seo-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/technical-seo-audit .claude/skills/technical-seo-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
technical-seo-audit
GitHub stars
161
Token cost
~2.1k tokens
SKILL.md length
836 words
Files
4
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Deep technical SEO auditing covering crawlability, indexation, Core Web Vitals, site architecture, canonicalization, structured data validation, and performance optimization.

  • Works in 7 steps: Crawlability & Indexation → Site Architecture & Internal Linking → Core Web Vitals & Performance → …
  • The user asks about technical SEO
  • SKILL.md covers Install, Audit Framework, Audit Report Structure and Common Tools & Commands, plus 2 more sections
  • Calls curl, openssl and git; reaches googleapis.com

What it does

Technical SEO Audit is an agent skill from thatrebeccarae/claude-marketing. 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.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `EXAMPLES.md` and `REFERENCE.md`).

It sits in Marketing & SEO, covering Technical SEO, Web performance and On-page SEO. The repository describes itself as: A full marketing department for Claude Code. Skill packs for Klaviyo, Shopify, GA4, Looker Studio, paid media, and more. Audit, optimize, and report using natural language. The licence is MIT.

When your agent uses it

  • The user asks about technical SEO
  • Indexation problems
  • Core Web Vitals
  • Site architecture optimization

Example prompts

  • “/technical-seo-audit”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Crawlability & Indexation
  2. Site Architecture & Internal Linking
  3. Core Web Vitals & Performance
  4. On-Page Technical Elements
  5. HTTPS & Security
  6. International & Multi-Language (if applicable)
  7. Mobile Optimization

What it can do on your machine

Read from SKILL.md and the folder at commit a8a63ec. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • openssl
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • googleapis.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Technical SEO Audit loads about 2.1k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 836 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from thatrebeccarae/claude-marketing at commit a8a63ec, republished under its MIT licence (© thatrebeccarae). 836 words, ~2,148 tokens.

Download SKILL.mdSave it as .claude/skills/technical-seo-audit/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
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
metadata.category
seo
metadata.domain
technical-seo
metadata.updated
2026-03-18
metadata.tested
2026-03-18
metadata.tested_with
Claude Code v2.1

Technical SEO Audit

Deep technical SEO analysis: crawlability, indexation, Core Web Vitals, site architecture, and performance.

Install

bash
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)
  • 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
Show full SKILL.md (346 more words)Show less
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
SeverityDefinitionResponse Time
CriticalBlocking crawling, indexation, or renderingImmediate
HighSignificantly impacting rankings or UXWithin 1 week
MediumImpacting performance or best practicesWithin 1 month
LowMinor optimizations or future-proofingBacklog
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

bash
# 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

MetricGoodNeeds WorkPoor
LCP<2.5s2.5-4.0s>4.0s
INP<200ms200-500ms>500ms
CLS<0.10.1-0.25>0.25
TTFB<800ms800ms-1.8s>1.8s
Page size<1.5MB1.5-3MB>3MB
Requests<5050-100>100
Crawl depth<=3 clicks4-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

© thatrebeccarae, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/technical-seo-audit of thatrebeccarae/claude-marketing.

  • SKILL.md
  • EXAMPLES.md
  • LICENSE
  • REFERENCE.md

Open the folder on GitHubat commit a8a63ec

Compare with similar skills

Technical SEO Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Technical SEO Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Technical SEO Audit this skillthatrebeccarae/claude-marketing161—~2.1kAutomated safety check: PassMIT
SEO Auditunifapi-agent/agents589—~3.4kAutomated safety check: PassMIT
SEOaffaan-m/ECC276k2 repos~1.1kAutomated safety check: PassMIT
Persian SEOTronIsHere/vibefarsiui212—~1.7kAutomated safety check: WarnMIT
Business Website Setupsickn33/agentic-awesome-skills47k1 repos~6.2kAutomated safety check: PassMIT
SEO Auditfjrevoredo/mini-diarium309—~4kAutomated safety check: PassMIT

Similar skills

  • SEO Audit

    unifapi-agent/agents

    When the user wants to audit, review, or diagnose SEO issues on their site.

    589 GitHub stars~3.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • SEO

    affaan-m/ECC

    Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy.

    276k GitHub starsUsed in 2 repos~1.1k tokens
    Marketing & SEOAuto-check passed
  • Persian SEO

    TronIsHere/vibefarsiui

    Technical and on-page SEO for Persian (Farsi) websites: lang and hreflang for fa-IR, RTL-safe metadata, Persian titles and descriptions, slug and URL strategy for Persian content, ZWNJ and keyword…

    212 GitHub stars~1.7k tokensUpdated today
    Marketing & SEOAuto-check: warnings
  • Business Website Setup

    sickn33/agentic-awesome-skills

    Website page register: URL, title, meta description, search intent, NAP block, schema type, canonical, indexability and Core Web Vitals target.

    47k GitHub starsUsed in 1 repo~6.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Audit

    fjrevoredo/mini-diarium

    Applies to the static marketing site under website/ only. An agent skill from fjrevoredo/mini-diarium.

    309 GitHub stars~4k tokensUpdated today
    Marketing & SEOAuto-check passed
  • SEO Validate

    softspark/ai-toolkit

    SEO validator: meta/OG, Schema.org, hreflang, Core Web Vitals, crawlability.

    179 GitHub stars~3.9k tokensUpdated 2 days ago
    Marketing & SEOAuto-check: notes

More from thatrebeccarae/claude-marketing

All 55 skills in this repo
  • Google Analytics

    thatrebeccarae/claude-marketing

    Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements.

    161 GitHub starsUsed in 3 repos~1.3k tokens
    Auto-check: notes
  • Content Creator

    thatrebeccarae/claude-marketing

    Comprehensive content marketing toolkit with brand voice analysis, SEO optimization scripts, content frameworks, social media strategy, and content calendar planning.

    161 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Klaviyo Analyst

    thatrebeccarae/claude-marketing

    Klaviyo marketing operations and analyst expertise. An agent skill from thatrebeccarae/claude-marketing.

    161 GitHub stars~5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Klaviyo Developer

    thatrebeccarae/claude-marketing

    Klaviyo API and developer integration expertise. An agent skill from thatrebeccarae/claude-marketing.

    161 GitHub stars~4.9k tokensUpdated 4 mo ago
    Auto-check: notes
  • Looker Studio

    thatrebeccarae/claude-marketing

    Looker Studio (formerly Google Data Studio) expertise. An agent skill from thatrebeccarae/claude-marketing.

    161 GitHub stars~3.6k tokensUpdated 4 mo ago
    Auto-check: notes
  • Shopify

    thatrebeccarae/claude-marketing

    Shopify e-commerce platform marketing expertise. An agent skill from thatrebeccarae/claude-marketing.

    161 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check: notes

Categories

Questions about Technical SEO Audit

What does Technical SEO Audit do?

Deep technical SEO auditing covering crawlability, indexation, Core Web Vitals, site architecture, canonicalization, structured data validation, and performance optimization. Technical SEO Audit is an agent skill from thatrebeccarae/claude-marketing. Deep technical SEO auditing covering crawlability, indexation, Core Web Vitals, site architecture, canonicalization, structured data validation, and performance optimization.

When should I use Technical SEO Audit?

Technical SEO Audit fits situations like: the user asks about technical SEO; indexation problems; core Web Vitals; site architecture optimization.

How do I install Technical SEO Audit in Claude Code?

Run `npx skills add thatrebeccarae/claude-marketing --skill technical-seo-audit -a claude-code`. Or copy the skill folder (skills/technical-seo-audit in thatrebeccarae/claude-marketing) into .claude/skills/technical-seo-audit in your project. Claude Code loads it when a task matches its description.

How do I install Technical SEO Audit in Codex?

Run `npx skills add thatrebeccarae/claude-marketing --skill technical-seo-audit -a codex`. Or copy the skill folder (skills/technical-seo-audit in thatrebeccarae/claude-marketing) into .agents/skills/technical-seo-audit in your project. Codex loads it when a task matches its description.

Can I use Technical SEO Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thatrebeccarae/claude-marketing --skill technical-seo-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/technical-seo-audit, .gemini/skills/technical-seo-audit, .github/skills/technical-seo-audit and .opencode/skills/technical-seo-audit in your project.

What does Technical SEO Audit need to run?

Going by SKILL.md and its folder, Technical SEO Audit needs the command-line tools its instructions call (curl, openssl and git).

Does Technical SEO Audit access the network?

SKILL.md names 1 domain. In commands or code: googleapis.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Technical SEO Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Technical SEO Audit use?

Technical SEO Audit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Technical SEO Audit use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Technical SEO Audit?

Skills that share tags, products or a category with Technical SEO Audit: SEO Audit (unifapi-agent/agents, 589 stars), SEO (affaan-m/ECC, 276k stars), Persian SEO (TronIsHere/vibefarsiui, 212 stars) and Business Website Setup (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Technical SEO Audit?

thatrebeccarae (a GitHub user) maintains it in thatrebeccarae/claude-marketing, which has 161 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on May 14, 2026.

Source: thatrebeccarae/claude-marketing on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.