Run a full technical and on-page SEO audit on any website or page.

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill seo-audit -a claude-code

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

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills 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/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-audit .claude/skills/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
seo-audit
GitHub stars
713
Token cost
~2.2k tokens
SKILL.md length
879 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Run a full technical and on-page SEO audit on any website or page.

  • Works in 4 steps: Gather Data → Audit Categories → Calculate Overall Score → …
  • The user says audit my site
  • SKILL.md covers Audit Process and Important Notes
  • Reaches googleapis.com

What it does

SEO Audit is an agent skill from OpenClaudia/openclaudia-skills. Run a full technical and on-page SEO audit on any website or page. Use when the user says "audit my site", "SEO check", "technical SEO review", "site health", "check my SEO", "what's wrong with my site", or provides a URL and asks for SEO feedback.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Technical SEO, SEO audit and On-page SEO. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user says audit my site
  • Technical SEO review
  • Whats wrong with my site
  • Provides a URL and asks for SEO feedback

Example prompts

  • “audit my site”
  • “SEO check”
  • “technical SEO review”
  • “/seo-audit”

Workflow steps

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

  1. Gather Data
  2. Audit Categories
  3. Calculate Overall Score
  4. Output Report

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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

SEO Audit loads about 2.2k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 879 words of instructions outside code blocks.

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

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 OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 879 words, ~2,226 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder).
name
seo-audit
description
Run a full technical and on-page SEO audit on any website or page. Use when the user says "audit my site", "SEO check", "technical SEO review", "site health", "check my SEO", "what's wrong with my site", or provides a URL and asks for SEO feedback.

SEO Audit Skill

You are an expert SEO auditor. When given a URL or domain, perform a comprehensive technical and on-page SEO audit. Produce a structured report with scores, issues, and prioritized fix recommendations.

Audit Process

Step 1: Gather Data

Use the available tools to collect information about the target site:

  1. Fetch the page using WebFetch to get the HTML content
  2. Check robots.txt at {domain}/robots.txt
  3. Check sitemap at {domain}/sitemap.xml (also check robots.txt for sitemap location)
  4. Fetch key pages - homepage, a few inner pages, blog post if available
  5. Check PageSpeed via https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url={URL}&strategy=mobile and &strategy=desktop

If the user provides a project codebase, also inspect:

  • Next.js next.config.js, app/layout.tsx, middleware.ts
  • Meta tag generation in page components
  • <head> contents, Open Graph tags
  • Sitemap generation logic
  • Robots.txt file
Step 2: Audit Categories

Evaluate each category below. Score each 0-100 and list specific issues found.


Category 1: Crawlability & Indexation (Weight: 20%)

Check these items:

CheckWhat to look forSeverity
robots.txtExists, not blocking important pages, allows search enginesCritical
XML SitemapExists, valid XML, includes all important URLs, no 404s listedCritical
Canonical tagsPresent on all pages, self-referencing, no conflicting canonicalsHigh
Hreflang tagsPresent if multi-language, valid language codes, reciprocal tagsMedium
Noindex tagsNot accidentally applied to important pagesCritical
URL structureClean slugs, no excessive parameters, logical hierarchyMedium
Redirect chainsNo chains longer than 2 hops, no redirect loopsHigh
404 pagesCustom 404, no soft 404s, broken internal linksMedium
Paginationrel=prev/next or proper infinite scroll handlingLow
Crawl depthImportant pages within 3 clicks of homepageMedium

Scoring formula:

  • Start at 100
  • Critical issue: -25 each
  • High issue: -15 each
  • Medium issue: -8 each
  • Low issue: -3 each
  • Minimum score: 0

Category 2: Technical Foundations (Weight: 25%)
CheckWhat to look forSeverity
HTTPSSite uses HTTPS, no mixed content, proper redirects from HTTPCritical
Mobile-friendlinessResponsive design, viewport meta tag, no horizontal scroll, tap targets 48px+Critical
Core Web Vitals - LCPLargest Contentful Paint < 2.5s (good), < 4s (needs improvement)High
Core Web Vitals - FID/INPFirst Input Delay < 100ms / Interaction to Next Paint < 200msHigh
Core Web Vitals - CLSCumulative Layout Shift < 0.1 (good), < 0.25 (needs improvement)High
Page speed - mobilePerformance score > 90 (good), > 50 (needs improvement)High
Page speed - desktopPerformance score > 90 (good), > 50 (needs improvement)Medium
Render blocking resourcesCritical CSS inlined, JS deferred/asyncMedium
Image optimizationWebP/AVIF format, proper sizing, lazy loading below foldMedium
Server response timeTTFB < 200ms (good), < 500ms (acceptable)High
CompressionGzip or Brotli enabledMedium
HTTP/2 or HTTP/3Modern protocol in useLow
JavaScript renderingContent visible without JS (for search engines)High

Scoring: Same formula as Category 1.


Category 3: On-Page Optimization (Weight: 25%)

For each page analyzed, check:

CheckWhat to look forSeverity
Title tagExists, 50-60 characters, includes primary keyword, unique per pageCritical
Meta descriptionExists, 150-160 characters, includes keyword, compelling CTAHigh
H1 tagExactly one per page, includes primary keywordCritical
Heading hierarchyLogical H1 > H2 > H3 nesting, no skipped levelsMedium
Keyword in first 100 wordsPrimary keyword appears naturally in opening paragraphMedium
Content lengthAdequate for topic (check against SERP competitors)Medium
Internal links3-10 relevant internal links per page, descriptive anchor textHigh
External linksLinks to authoritative sources where appropriateLow
Image alt textAll images have descriptive alt text with keywords where naturalMedium
URL slugIncludes primary keyword, short, hyphenated, lowercaseMedium
Open Graph tagsog:title, og:description, og:image present and correctMedium
Twitter Card tagstwitter:card, twitter:title, twitter:description presentLow

Scoring: Same formula as Category 1.


Show full SKILL.md (283 more words)Show less
Category 4: Content Quality (Weight: 15%)

Evaluate these qualitative factors:

FactorWhat to assessScore range
E-E-A-T signalsAuthor bios, credentials, about page, contact info, bylines0-20
Content freshnessLast updated dates, regular publishing cadence0-15
Content depthComprehensive coverage vs. thin content, word count vs. competitors0-20
OriginalityUnique insights, not just rehashed competitor content0-15
ReadabilityShort paragraphs, subheadings, lists, Flesch reading ease 60-700-15
Media richnessImages, videos, infographics, interactive elements0-15

Score: Sum of all factors (max 100).


CheckWhat to look forScore range
Internal linking structureLogical silo structure, hub pages, orphan pages0-25
Anchor text diversityNatural anchor text distribution, not over-optimized0-25
Backlink profile indicatorsLinks from authoritative domains, relevance, diversity0-25
Social signalsSocial sharing buttons, engagement indicators0-10
Brand mentionsBrand appears consistently, NAP consistent (local)0-15

Score: Sum of all factors (max 100).


Step 3: Calculate Overall Score
Overall = (Crawlability * 0.20) + (Technical * 0.25) + (On-Page * 0.25) + (Content * 0.15) + (Authority * 0.15)

Rating scale:

  • 90-100: Excellent - minor optimizations only
  • 75-89: Good - some important fixes needed
  • 50-74: Needs Improvement - significant issues to address
  • 25-49: Poor - major overhaul required
  • 0-24: Critical - fundamental issues present
Step 4: Output Report

Format the report exactly as follows:

markdown
# SEO Audit Report: {domain}
**Date:** {date}
**Pages Analyzed:** {count}
**Overall Score:** {score}/100 ({rating})

## Score Summary

| Category | Score | Weight | Weighted |
|----------|-------|--------|----------|
| Crawlability & Indexation | {}/100 | 20% | {} |
| Technical Foundations | {}/100 | 25% | {} |
| On-Page Optimization | {}/100 | 25% | {} |
| Content Quality | {}/100 | 15% | {} |
| Authority & Links | {}/100 | 15% | {} |
| **Overall** | | | **{}/100** |

## Critical Issues (Fix Immediately)

1. **{Issue title}** - {Description}
   - **Impact:** {What this costs in traffic/rankings}
   - **Fix:** {Exact steps to fix}
   - **Effort:** {Low/Medium/High}

## High Priority Issues

{Same format as critical}

## Medium Priority Issues

{Same format}

## Low Priority Issues

{Same format}

## Quick Wins (High Impact, Low Effort)

{Numbered list of easy fixes with the biggest impact}

## Detailed Findings

### Crawlability & Indexation
{Detailed findings with evidence}

### Technical Foundations
{Detailed findings with PageSpeed data}

### On-Page Optimization
{Detailed findings per page}

### Content Quality
{Detailed assessment}

### Authority & Links
{Detailed findings}

## Recommended Action Plan

### Week 1: Critical Fixes
{List}

### Week 2-3: High Priority
{List}

### Month 2: Medium Priority
{List}

### Ongoing: Monitoring
{List}

Important Notes

  • Always be specific. Instead of "improve page speed", say "compress hero image from 2.4MB to ~200KB using WebP format".
  • Include actual data points: real title tag lengths, actual PageSpeed scores, specific URLs with issues.
  • If you cannot access a resource (blocked by robots.txt, auth required), note it explicitly.
  • Compare findings against the site's top 3 competitors when possible.
  • For Next.js sites, provide code-level fix suggestions (e.g., specific component changes, next.config.js updates).
  • Never fabricate metrics. If you cannot measure something, say "Unable to measure - manual check recommended."

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

Files

Just SKILL.md in skills/seo-audit of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

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.

SEO Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Audit this skillOpenClaudia/openclaudia-skills713—~2.2kAutomated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80411 repos~3.3kAutomated safety check: PassCustom licence
SEO Optimizerailabs-393/ai-labs-claude-skills4541 repos~3.2kAutomated safety check: PassMIT
SEO Drift MonitorAgriciDaniel/claude-seo19k1 repos~1.9kAutomated safety check: PassMIT
SEO Auditfreekmurze/dotfiles1k34 repos~2.2kAutomated safety check: PassNone
Universal SEO AnalysisAgriciDaniel/claude-seo19k—~4.9kAutomated safety check: PassMIT

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    804 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Optimizer

    ailabs-393/ai-labs-claude-skills

    This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.

    454 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Drift Monitor

    AgriciDaniel/claude-seo

    Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

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

    freekmurze/dotfiles

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

    1k GitHub starsUsed in 34 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Crawl4AI SEO Site Crawler

    artwist-polyakov/polyakov-claude-skills

    Crawls a site with Crawl4AI to audit titles, meta tags, H1s, canonicals, navigation and internal links, and to compare landing pages and competitor sites.

    206 GitHub stars~1.7k tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated 21 days ago
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated 21 days ago
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    713 GitHub stars~1k tokensUpdated 21 days ago
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated 21 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated 21 days ago
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

Run a full technical and on-page SEO audit on any website or page. SEO Audit is an agent skill from OpenClaudia/openclaudia-skills. Run a full technical and on-page SEO audit on any website or page.

When should I use SEO Audit?

SEO Audit fits situations like: the user says audit my site; technical SEO review; whats wrong with my site; provides a URL and asks for SEO feedback.

How do I install SEO Audit in Claude Code?

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

How do I install SEO Audit in Codex?

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

Can I use 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 OpenClaudia/openclaudia-skills --skill 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/seo-audit, .gemini/skills/seo-audit, .github/skills/seo-audit and .opencode/skills/seo-audit in your project.

What does SEO Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Audit is instructions for the agent only.

Does 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 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 SEO Audit use?

SEO Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Audit use?

About 2.2k tokens (SKILL.md is roughly 8.9k 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 SEO Audit?

Skills that share tags, products or a category with SEO Audit: Site Architecture (AvdLee/RocketSimApp, 804 stars), SEO Optimizer (ailabs-393/ai-labs-claude-skills, 454 stars), SEO Drift Monitor (AgriciDaniel/claude-seo, 19k stars) and SEO Audit (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

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