Agent skill

SEO Audit

by AgriciDaniel in AgriciDaniel/codex-seo

Full website SEO audit with parallel subagent delegation. An agent skill from AgriciDaniel/codex-seo.

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add AgriciDaniel/codex-seo --skill seo-audit -a claude-code

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

GitHub CLI
$ gh skill install AgriciDaniel/codex-seo 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/AgriciDaniel/codex-seo.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
799
Used in
2 other repos
Token cost
~1.9k tokens
SKILL.md length
820 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Full website SEO audit with parallel subagent delegation. An agent skill from AgriciDaniel/codex-seo.

  • Works in 6 steps: Fetch homepage: use… → Detect business type: analyze homepage… → Crawl site: follow internal links up to… → …
  • User says audit
  • SKILL.md covers Shared Data Cache, Process, Crawl Configuration and Output Files, plus 7 more sections
  • Calls python

What it does

SEO Audit is an agent skill from AgriciDaniel/codex-seo. Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to up to 15 specialists (8 always + 7 conditional), generates health score. Use when user says audit, full SEO check, SEO best-practice review, analyze my site, website health check, or find SEO issues.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Marketing & SEO, covering SEO audit, Subagents and Customer success. The repository describes itself as: Codex-first SEO skill suite. 26 workflows, 24 TOML agents, DataForSEO/Gemini/Google/Firecrawl integrations, GEO/AEO, CWV, schema, backlinks, local/maps, and deterministic reports. The licence is MIT.

When your agent uses it

  • User says audit
  • SEO best-practice review
  • Analyze my site
  • Website health check

Example prompts

  • “/seo-audit”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Fetch homepage: use scripts/fetch_page.py to retrieve HTML
  2. Detect business type: analyze homepage signals per seo orchestrator
  3. Crawl site: follow internal links up to 500 pages, respect robots.txt
  4. Delegate to subagents (if available, otherwise run inline sequentially)
  5. Score -- aggregate into SEO Health Score (0-100)
  6. Report -- generate prioritized action plan

What it can do on your machine

Read from SKILL.md and the folder at commit 9a644f6. 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:

    • 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.9k tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 820 words of instructions outside code blocks.

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

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 AgriciDaniel/codex-seo at commit 9a644f6, republished under its MIT licence (© AgriciDaniel). 820 words, ~1,873 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
seo-audit
description
Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to up to 15 specialists (8 always + 7 conditional), generates health score. Use when user says audit, full SEO check, SEO best-practice review, analyze my site, website health check, or find SEO issues.
user-invokable
true
argument-hint
[url]
license
MIT
metadata.author
AgriciDaniel
metadata.version
1.9.6
metadata.category
seo

Full Website SEO Audit

Shared Data Cache

Step 0 -- Check shared data cache:

Before gathering, check .seo-cache/ for reusable context from related SEO skills. Reference: ../seo/references/shared-data-cache.md for schemas and dependency map.

Check these cache files when present:

  • .seo-cache/site-meta.json for domain, business type, industry, and crawl context

  • .seo-cache/audit-scores.json for prior full-audit priorities

  • .seo-cache/pages/{url-slug}/page-analysis.json for page-level context when a URL is provided

  • If found: parse and use clearly valid fields (note "Using cached [X] from [date]")

  • If missing, corrupt, or irrelevant: continue with fresh evidence

  • If the user says "refresh" or "re-run": ignore cache reads and overwrite on write

Process

  1. Fetch homepage: use scripts/fetch_page.py to retrieve HTML
  2. Detect business type: analyze homepage signals per seo orchestrator
  3. Crawl site: follow internal links up to 500 pages, respect robots.txt
  4. Delegate to subagents (if available, otherwise run inline sequentially):
    • seo-technical -- robots.txt, sitemaps, canonicals, Core Web Vitals, security headers
    • seo-content -- E-E-A-T, readability, thin content, AI citation readiness
    • seo-schema -- detection, validation, generation recommendations
    • seo-sitemap -- structure analysis, quality gates, missing pages
    • seo-performance -- LCP, INP, CLS measurements
    • seo-visual -- screenshots, mobile testing, above-fold analysis
    • seo-geo -- AI crawler access, llms.txt, citability, brand mention signals
    • seo-local -- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (spawn when Local Service industry detected: brick-and-mortar, SAB, or hybrid business type)
    • seo-maps -- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (spawn when Local Service detected AND DataForSEO MCP available)
    • seo-google -- CWV field data (CrUX), URL indexation (GSC), organic traffic (GA4) (spawn when Google API credentials detected via python scripts/google_auth.py --check)
    • seo-backlinks -- Backlink profile data: DA/PA, referring domains, anchor text, toxic links (spawn when Moz or Bing API credentials detected via python scripts/backlinks_auth.py --check, or always include Common Crawl domain-level metrics)
    • seo-cluster -- Semantic clustering analysis (spawn when content strategy signals detected: blog, pillar pages, topic clusters)
    • seo-sxo -- Search experience analysis: page-type mismatch, user stories, persona scoring (always include in full audits)
    • seo-drift -- Drift analysis: compare against stored baseline (spawn when drift baseline exists for the URL via python scripts/drift_history.py <url>)
    • seo-ecommerce -- Product schema, marketplace intelligence (spawn when E-commerce industry detected)
  5. Score -- aggregate into SEO Health Score (0-100)
  6. Report -- generate prioritized action plan

Crawl Configuration

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

Output Files

  • FULL-AUDIT-REPORT.md: Comprehensive findings
  • ACTION-PLAN.md: Prioritized recommendations (Critical > High > Medium > Low)
  • screenshots/: Desktop + mobile captures (if Playwright available)
  • PDF Report (recommended): Generate a professional A4 PDF using scripts/google_report.py --type full. This produces a white-cover enterprise report with TOC, executive summary, charts (Lighthouse gauges, query bars, index donut), metric cards, threshold tables, prioritized recommendations with effort estimates, and implementation roadmap. Always offer PDF generation after completing an audit.

Scoring Weights

CategoryWeight
Technical SEO22%
Content Quality23%
On-Page SEO20%
Schema / Structured Data10%
Performance (CWV)10%
AI Search Readiness10%
Images5%

Report Structure

Executive Summary
  • Overall SEO Health Score (0-100)
  • Business type detected
  • Top 5 critical issues
  • Top 5 quick wins
Technical SEO
  • Crawlability issues
  • Indexability problems
  • Security concerns
  • Core Web Vitals status
Content Quality
  • E-E-A-T assessment
  • Thin content pages
  • Duplicate content issues
  • Readability scores
Show full SKILL.md (326 more words)Show less
On-Page SEO
  • Title tag issues
  • Meta description problems
  • Heading structure
  • Internal linking gaps
Schema & Structured Data
  • Current implementation
  • Validation errors
  • Missing opportunities
Performance
  • LCP, INP, CLS scores
  • Resource optimization needs
  • Third-party script impact
Images
  • Missing alt text
  • Oversized images
  • Format recommendations
AI Search Readiness
  • Citability score
  • Structural improvements
  • Authority signals

Priority Definitions

  • Critical: Blocks indexing or causes penalties (fix immediately)
  • High: Significantly impacts rankings (fix within 1 week)
  • Medium: Optimization opportunity (fix within 1 month)
  • Low: Nice to have (backlog)

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, spawn the seo-dataforseo agent alongside existing subagents to enrich the audit with live data: real SERP positions, backlink profiles with spam scores, on-page analysis (Lighthouse), business listings, and AI visibility checks (ChatGPT scraper, LLM mentions).

Google API Integration (Optional)

If Google API credentials are configured (python scripts/google_auth.py --check), spawn the seo-google agent to enrich the audit with real Google field data: CrUX Core Web Vitals (replaces lab-only estimates), GSC URL indexation status, search performance (clicks, impressions, CTR), and GA4 organic traffic trends. The Performance (CWV) category score benefits most from field data.

Error Handling

ScenarioAction
URL unreachable (DNS failure, connection refused)Report the error clearly. Do not guess site content. Suggest the user verify the URL and try again.
robots.txt blocks crawlingReport which paths are blocked. Analyze only accessible pages and note the limitation in the report.
Rate limiting (429 responses)Back off and reduce concurrent requests. Report partial results with a note on which sections could not be completed.
Timeout on large sites (500+ pages)Cap the crawl at the timeout limit. Report findings for pages crawled and estimate total site scope.

Write to shared data cache

After completing all work, write a concise JSON summary to .seo-cache/ when the workflow produced durable findings. Use the schemas and naming rules in ../seo/references/shared-data-cache.md; include at least cache_type, analyzed_at, source URL/domain, key findings, issues, recommendations, and tool limitations. Add .seo-cache/ to .gitignore if it is missing.

© AgriciDaniel, 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 1 other file in skills/seo-audit of AgriciDaniel/codex-seo.

  • SKILL.md
  • LICENSE.txt

Open the folder on GitHubat commit 9a644f6

Used in 3 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AgriciDaniel/codex-seo, which our catalogue first saw on October 7, 2026.

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 skillAgriciDaniel/codex-seo7992 repos~1.9kAutomated safety check: PassMIT
SEO Auditandrew-yangy/gru-ai155—~731Automated safety check: PassMIT
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
SEO and GEO Auditdageno-agents/seo-geo-audit176—~2kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
Universal SEO AnalysisAgriciDaniel/claude-seo19k—~4.9kAutomated safety check: PassMIT

Similar skills

  • SEO Audit

    andrew-yangy/gru-ai

    Full website SEO audit with parallel subagent delegation. An agent skill from andrew-yangy/gru-ai.

    155 GitHub stars~731 tokensUpdated 7 mo ago
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • SEO and GEO Audit

    dageno-agents/seo-geo-audit

    Runs one prioritized audit that combines technical SEO, content quality, trust signals, entity clarity and AI search readiness for a page, site or domain.

    176 GitHub stars~2k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • 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
  • 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
  • Geo Audit

    zubair-trabzada/geo-seo-claude

    Full website GEO+SEO audit with parallel subagent delegation.

    11k GitHub stars~3.1k tokensUpdated today
    Marketing & SEOAuto-check: notes

More from AgriciDaniel/codex-seo

All 18 skills in this repo
  • SEO Google

    AgriciDaniel/codex-seo

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic.

    799 GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed
  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed
  • SEO Ecommerce

    AgriciDaniel/codex-seo

    E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps.

    799 GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • SEO Sxo

    AgriciDaniel/codex-seo

    Search Experience Optimization: reads Google SERPs backwards to detect page-type mismatches, derives user stories from search intent signals, and scores pages from multiple persona perspectives.

    799 GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • SEO Page

    AgriciDaniel/codex-seo

    Deep single-page SEO analysis covering on-page elements, content quality, technical meta tags, schema, images, and performance.

    799 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • SEO Schema

    AgriciDaniel/codex-seo

    Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

Full website SEO audit with parallel subagent delegation. An agent skill from AgriciDaniel/codex-seo. SEO Audit is an agent skill from AgriciDaniel/codex-seo. Full website SEO audit with parallel subagent delegation.

When should I use SEO Audit?

SEO Audit fits situations like: user says audit; SEO best-practice review; analyze my site; website health check.

How do I install SEO Audit in Claude Code?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-audit -a claude-code`. Or copy the skill folder (skills/seo-audit in AgriciDaniel/codex-seo) 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 AgriciDaniel/codex-seo --skill seo-audit -a codex`. Or copy the skill folder (skills/seo-audit in AgriciDaniel/codex-seo) 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 AgriciDaniel/codex-seo --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 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. Review the folder before installing.

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.9k tokens (SKILL.md is roughly 7.5k 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: SEO Audit (andrew-yangy/gru-ai, 155 stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars), SEO and GEO Audit (dageno-agents/seo-geo-audit, 176 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?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/codex-seo, which has 799 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 11, 2026.

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