Agent skill

SEO Audit

by borghei in borghei/Claude-Skills

Technical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans.

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add borghei/Claude-Skills --skill seo-audit -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing/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
881
Token cost
~1.4k tokens
SKILL.md length
558 words
Files
7 (incl. scripts, references)
Skills in repo
349
Repo updated
First seen
Licence
MIT

At a glance

Technical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans.

  • Auditing technical SEO
  • SKILL.md covers Core Capabilities, When to Use, Clarify First and Quick Start, plus 3 more sections
  • Runs Python scripts from its folder; calls python
  • Diagnosing indexation issues

What it does

SEO Audit is an agent skill from borghei/Claude-Skills. Technical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans. Use when auditing technical SEO or diagnosing indexation issues.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/audit-checklist.md`, `references/diagnostics-and-analysis.md` and `references/remediation-and-migration.md`).

It sits in Marketing & SEO, covering Technical SEO, SEO audit and Web performance. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Auditing technical SEO
  • Diagnosing indexation issues

Example prompts

  • “/seo-audit”

Requirements

  • Python 3

What it can do on your machine

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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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 1.4k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 558 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 558 words, ~1,368 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
seo-audit
description
Technical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans. Use when auditing technical SEO or diagnosing indexation issues.
license
MIT + Commons Clause
metadata.version
1.1.0
metadata.author
borghei
metadata.category
marketing-growth
metadata.updated
2026-06-15
metadata.tags
seo, audit, technical-seo, core-web-vitals, indexation, crawl-analysis

SEO Audit

Production-grade SEO audit framework with an 85-point checklist across 8 dimensions, severity-weighted scoring, automated diagnostic workflows, and prioritized remediation plans. Covers technical SEO, on-page optimization, content quality, competitive positioning, and migration readiness.

Core Capabilities

  • 85-point checklist across 8 dimensions — crawlability, indexation, Core Web Vitals, on-page, content quality, infrastructure, off-page, analytics
  • Severity-weighted scoring — Critical/High/Medium/Low multipliers roll up to an A–F health grade
  • Diagnostic deep dives — CWV optimization stacks, indexation gap analysis, traffic-drop decision tree, cannibalization & intent matching, E-E-A-T and AI-content detection
  • Competitive gap analysis — your site vs. 3 competitors across technical and content dimensions
  • Prioritized remediation — P0–P4 priority framework, fix-list template, and migration checklists

When to Use

Pick the operating mode that matches the situation:

  • Full Site Audit — comprehensive audit across all 8 dimensions; use for initial assessment or annual reviews.
  • Focused Audit — single-dimension deep dive when the problem area is already identified (e.g., failing Core Web Vitals, indexation issues).
  • Pre-Migration Audit — for planned URL changes, platform switches, or redesigns; establishes baseline and redirect mapping.
  • Traffic Drop Diagnosis — emergency diagnostic when organic traffic drops; follows the traffic-drop decision tree to isolate cause.

Clarify First

Before auditing, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Audit mode — full site, single-dimension focused, pre-migration, or traffic-drop diagnosis — sets scope and which of the 8 dimensions to run
  • Site URL + available data — GSC, analytics, and crawl exports on hand — determines what can be verified vs. assumed in the findings
  • Primary symptom or goal — e.g. ranking drop, indexation gap, failing Core Web Vitals — focuses the diagnostic deep-dives and remediation priority
  • Competitor set — the 3 sites to benchmark against — drives the competitive gap analysis

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

bash
# Check redirect chains and status codes
python scripts/redirect_checker.py --url https://example.com/old-page --json

# Analyze XML sitemap for errors
python scripts/sitemap_analyzer.py --sitemap https://example.com/sitemap.xml

# Score content quality for SEO
python scripts/content_scorer.py article.md --json
Show full SKILL.md (253 more words)Show less

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/audit-checklist.md — initial scoping questions, the full 85-point checklist across all 8 dimensions, and the severity-weighted scoring formula. Read when starting an audit or scoring results.
  • references/diagnostics-and-analysis.md — Core Web Vitals optimization stacks, indexation gap analysis, traffic-drop decision tree, cannibalization/intent scoring, AI-content & E-E-A-T detection, competitive gap framework. Read when diagnosing a specific problem area.
  • references/remediation-and-migration.md — migration checklist (pre/during/post), P0–P4 remediation framework and plan template, output artifacts, troubleshooting table, and success criteria. Read when turning findings into an action plan.

Scope & Limitations

In scope: technical SEO across all 8 audit dimensions, severity-weighted scoring with prioritized remediation, traffic-drop diagnosis, competitive gap analysis, pre/post-migration checklists, AI content quality detection.

Out of scope: content creation or rewriting (use Content Creator), structured data implementation (use Schema Markup), site architecture redesign (use Site Architecture), link building execution, paid search audits, server/CDN provisioning.

Known limitations: field CWV data requires sufficient traffic for CrUX; off-page signals need third-party tools (Ahrefs, SEMrush); AI Overview impact on CTR varies by query type; Google's algorithm changes 500–600 times/year, so findings are point-in-time.

Integration Points

  • AI SEO — run after audit to optimize for AI search citation alongside traditional findings.
  • Schema Markup — use when audit reveals missing or broken structured data opportunities.
  • Site Architecture — use when audit uncovers structural issues requiring architectural redesign.
  • Content Humanizer — use when audit flags AI content detection signals on key pages.
  • Content Strategy / programmatic-seo — use when audit reveals content gaps or keyword-gap clusters addressable at scale.

© borghei, 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 6 other files (scripts, references) in marketing/seo-audit of borghei/Claude-Skills.

  • SKILL.md
  • references/audit-checklist.md
  • references/diagnostics-and-analysis.md
  • references/remediation-and-migration.md
  • scripts/content_scorer.py
  • scripts/redirect_checker.py
  • scripts/sitemap_analyzer.py

Open the folder on GitHubat commit 4a698e8

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 skillborghei/Claude-Skills881—~1.4kAutomated safety check: PassMIT
Google SEO APIsAgriciDaniel/claude-seo18k1 repos~4.2kAutomated safety check: PassMIT
SEOAgriciDaniel/seo-os1342 repos~3.5kAutomated safety check: PassMIT
SEO Audit with Search Consolenowork-studio/notfair-plugin3.9k1 repos~15kAutomated safety check: WarnMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
SEOAgriciDaniel/codex-seo791—~3.7kAutomated safety check: PassMIT

Similar skills

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    18k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • SEO

    AgriciDaniel/seo-os

    Comprehensive SEO analysis for any website or business type.

    134 GitHub starsUsed in 2 repos~3.5k tokens
    Marketing & SEOAuto-check passed
  • SEO Audit with Search Console

    nowork-studio/notfair-plugin

    Runs a full SEO audit that combines Google Search Console, URL Inspection, PageSpeed Insights and a technical crawl, then ranks quick wins and a 30-day plan.

    3.9k GitHub starsUsed in 1 repo~15k tokens
    Marketing & SEOAuto-check: warnings
  • SEO Coach

    akseolabs-seo/seo-coach

    Beginner-first SEO coaching for people who want to learn by doing one safe, verifiable step at a time.

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

    AgriciDaniel/codex-seo

    Comprehensive SEO analysis for any website, page, business, or topic.

    791 GitHub stars~3.7k tokensUpdated 26 days ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    unifapi-agent/agents

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

    587 GitHub stars~3.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from borghei/Claude-Skills

All 349 skills in this repo
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    881 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    881 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    881 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    881 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    881 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Brainstorm Okrs

    borghei/Claude-Skills

    OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.

    881 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

Technical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans. SEO Audit is an agent skill from borghei/Claude-Skills. Technical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans.

When should I use SEO Audit?

SEO Audit fits situations like: auditing technical SEO; diagnosing indexation issues.

How do I install SEO Audit in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill seo-audit -a claude-code`. Or copy the skill folder (marketing/seo-audit in borghei/Claude-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 borghei/Claude-Skills --skill seo-audit -a codex`. Or copy the skill folder (marketing/seo-audit in borghei/Claude-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 borghei/Claude-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?

Going by SKILL.md and its folder, SEO Audit needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does SEO Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does SEO Audit use?

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

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.6k tokens, read only when the agent opens those files.

What are the alternatives to SEO Audit?

Skills that share tags, products or a category with SEO Audit: Google SEO APIs (AgriciDaniel/claude-seo, 18k stars), SEO (AgriciDaniel/seo-os, 134 stars), SEO Audit with Search Console (nowork-studio/notfair-plugin, 3.9k stars) and SEO Coach (akseolabs-seo/seo-coach, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 881 GitHub stars. The repository holds 349 skills in this directory. The repository was last updated on October 7, 2026.

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