Skip to content
Get packs

Guide · Agent skill

How to use the Full-Site SEO Audit agent skill (seo-audit)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The seo-audit skill lets an AI agent run a full SEO audit of a website and return a scored, prioritized report. It is aimed at site owners, marketers, agencies and developers who want a broad first-pass review of an entire site rather than one page. After this guide you will know what the skill does, how to install it, how to ask for an audit in plain language, and what to check before you run it.

Full-Site SEO AuditAgriciDaniel/claude-seo · MIT

Quick start

  1. 1Download and unzip. Download the seo-audit ZIP from this page and unzip it to get SKILL.md and LICENSE.txt.
  2. 2Place the skill folder. Move the folder to ~/.claude/skills/ for personal use or to .claude/skills/ inside your project. Or upload it in the Claude apps under Settings, Capabilities, Skills.
  3. 3Check the plugin environment. Confirm the claude-seo scripts are available at ${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo, since the skill depends on them.
  4. 4Ask for a site-wide audit. Request a full SEO audit with the site's URL, for example asking for a scored report and an action plan.
  5. 5Review the outputs. Open FULL-AUDIT-REPORT.md and ACTION-PLAN.md in the {domain}-audit/ folder and start with Critical items.
  6. 6Optionally generate a PDF. Ask the agent to create the PDF report from the audit data if you need a client-ready document.

What is an agent skill and what does seo-audit do?

An agent skill is a folder containing a SKILL.md file that tells an AI agent how to perform a specific task. Once installed, the agent can use that instruction set when a request matches it. The seo-audit skill is part of the larger claude-seo toolkit by AgriciDaniel and is released under the MIT licence.

When installed, the agent renders the homepage, follows internal links across up to 500 pages while respecting robots.txt, and checks technical health, content quality, on-page elements, structured data, performance, images and AI search readiness. It then produces an SEO Health Score out of 100, writes markdown reports and an action plan ranked from Critical to Low, and can offer a PDF report.

  • Full-site crawl: up to 500 pages, 5 concurrent requests, 1 second delay between requests
  • Scoring weights: Technical SEO 22%, Content Quality 23%, On-Page SEO 20%, Schema 10%, Performance (CWV) 10%, AI Search Readiness 10%, Images 5%
  • Priority levels: Critical (fix immediately), High (within 1 week), Medium (within 1 month), Low (backlog)

How do you install the seo-audit skill?

Download the ZIP for this skill from our page and unzip it. For a personal setup, place the folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder. Alternatively, in the Claude apps, open Settings, go to Capabilities, and upload the skill under Skills.

The ZIP contains LICENSE.txt and SKILL.md. The skill's scripts call ${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo, which comes from the wider plugin environment, so check that environment is available before expecting script-based steps to work.

  • Personal install: ~/.claude/skills/
  • Project install: .claude/skills/ inside your project
  • App install: Settings, then Capabilities, then Skills, then upload

How do you trigger the audit with a natural request?

You do not need a special command. Describe a site-wide job in plain language and include the site's URL. The skill's description tells the agent to use it only for site-wide checks, so phrase requests around the whole site.

If you only want one URL, ask for a single-page check instead, because the skill itself says to use seo-page for one URL. For a technical-only review, the source points to seo-technical.

  • Run a full SEO audit of https://example.com and give me a scored report.
  • Audit my whole website for SEO problems and rank the fixes by priority.
  • Prepare a client-ready SEO audit with an action plan for example.com.
  • Check the technical SEO health of every page on my site, up to 500 pages.

What does the agent produce?

The audit writes its outputs into a folder named after the domain, such as {domain}-audit/. The main files are a comprehensive findings report, a prioritized action plan and a structured data file that the report generator uses. Per-category findings and screenshots are saved in subfolders when Playwright is available.

The full report covers an executive summary, technical SEO, content quality, on-page SEO, schema, performance, images and AI search readiness. The source states that a PDF report is recommended and that the agent should offer it after an audit.

  • {domain}-audit/FULL-AUDIT-REPORT.md: comprehensive findings
  • {domain}-audit/ACTION-PLAN.md: prioritized recommendations
  • {domain}-audit/audit-data.json: structured audit envelope
  • {domain}-audit/findings/*.md: per-category findings
  • {domain}-audit/screenshots/: desktop and mobile captures, if Playwright is available
  • PDF report: optional A4 report generated from the audit data

What does the skill need to run?

The core skill needs the Claude Code plugin environment that provides the Python scripts at ${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo. Several extras are optional and only run when their data or credentials are set up. Playwright enables screenshots and rendering. Google API credentials enable the seo-google sub-audit, Matomo credentials enable seo-matomo, Moz or Bing API credentials add backlink data, and the DataForSEO MCP adds local map rankings.

Sub-checks are conditional. The source says optional sub-checks run only when matching data or credentials are configured, so a bare install gives you the core audit.

  • Required: Claude Code plugin environment with the claude-seo scripts
  • Optional: Playwright for screenshots and rendering
  • Optional: Google API credentials (seo-google)
  • Optional: Matomo credentials (seo-matomo)
  • Optional: Moz or Bing API credentials (backlink data)
  • Optional: DataForSEO MCP (local map rankings)

What should you know about scripts and network access?

This skill runs scripts and uses the network. It renders pages and sends many automated requests to the site you audit: up to 500 pages with up to 5 running at once. Only audit sites you own or have permission to crawl, since this load may burden servers.

The crawl respects robots.txt and sets a 30-second timeout per page, and it follows redirects up to 3 hops. Credentials for optional integrations should be set up deliberately, and you should only enable the sub-audits you need.

  • Only crawl sites you own or have permission to crawl
  • Expect many requests: up to 500 pages, 5 concurrent
  • Crawling respects robots.txt
  • Optional credentials are only used when you configure them

Tips for getting a useful audit

Treat the score as a heuristic guide, not a ranking promise. The crawl can miss content behind logins or heavy JavaScript, so note any sections the agent could not reach. Start with the Critical and High items in the action plan, then re-run the audit after fixes to compare.

If you run the audit repeatedly, the source mentions a drift analysis that compares against a stored baseline when one exists for the URL. Keep the output folders so you can compare changes.

  • Start with Critical and High items before anything else
  • Check which sections were blocked by logins or JavaScript
  • Keep previous {domain}-audit/ folders to compare progress
  • Offer the PDF report for clients or stakeholders

What people use it for

  • A site owner runs a first-pass review of a whole website and gets a prioritized to-do list.
  • An agency prepares a client audit with a scored summary and an action plan ranked by priority.
  • A developer gets a structured list of technical SEO issues such as crawlability, canonicals and security headers to fix.
  • A team re-runs the audit after fixes to compare findings against the earlier output folder.

Frequently asked questions

How do I install the seo-audit skill?

Download the ZIP from this page and unzip it. Put the folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder, or upload it in the Claude apps under Settings, Capabilities, Skills.

Is the seo-audit skill free?

The skill is released under the MIT licence, as stated in its LICENSE.txt and SKILL.md. Optional integrations such as Google, Matomo, Moz, Bing or DataForSEO need their own credentials and accounts.

What does the seo-audit skill require?

It requires the Claude Code plugin environment that provides the claude-seo Python scripts. Playwright, Google API, Matomo, Moz or Bing and DataForSEO MCP are optional and only enable extra checks.

How many pages does the audit crawl?

The crawl configuration sets a maximum of 500 pages, with 5 concurrent requests and a 1 second delay between requests. It respects robots.txt.

Should I use seo-audit or seo-page?

Use seo-audit for a site-wide check. The skill says to use seo-page when you only need one URL, and seo-technical for a technical-only review.

Are the SEO Health Scores accurate?

The scores are heuristic. The crawl can miss content behind logins or heavy JavaScript, and the skill does not guarantee any ranking outcome.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use seo-audit if you want a broad, prioritized first-pass review of a site you own or are allowed to crawl, and you are comfortable with an agent running scripts and many requests. Pick seo-page for a single URL, seo-technical for a technical-only check, or a dedicated paid crawler if you need guaranteed coverage of JavaScript-heavy or login-protected content.

Download the skill

Find exactly what
you're looking for