How to use the SEO Analysis Hub agent skill (seo)

What an agent skill is and what this one lets the agent do

An agent skill is a folder of instructions and supporting files that an AI agent loads when a task matches it. This one is named seo and is described as a comprehensive SEO analysis skill for any website or business type.

Once installed, the agent can run full site audits, single-page analysis, technical SEO checks covering crawlability, indexability and Core Web Vitals with INP, schema markup validation and generation, E-E-A-T content quality reviews, image optimisation, sitemap analysis, local business and map listing analysis, and checks for AI answer engines such as AI Overviews, ChatGPT and Perplexity (GEO).

• It acts as a hub that coordinates about 25 more specialised sub-skills and sub-agents.
• It detects the business type (SaaS, e-commerce, local, publisher, agency or other) and adjusts the analysis.
• The output of a full audit includes an SEO Health Score from 0 to 100 and a prioritised action plan.

Install the seo skill from the ZIP

Download the ZIP for the skill from the directory page. Then choose one of two routes depending on how you use Claude.

For Claude Code, unzip the download into your personal skills folder ~/.claude/skills/ so the skill is available in every project. To limit it to one project, unzip it into that project's .claude/skills/ folder instead. The skill folder should contain SKILL.md and the references folder.

For the Claude apps, upload the ZIP under Settings → Capabilities → Skills.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ inside your project
• Claude apps: Settings → Capabilities → Skills

Run the one-time setup and check readiness

Some features run bundled Python tools, so the skill needs an isolated Python runtime and Chromium. Run the setup command once. The skill only runs setup when you explicitly invoke it, and it does not fall back to global or user package installs.

If something is not working, run the doctor command. The skill says its output intentionally omits absolute paths and environment values, so it is safe to share when asking for help.

• Setup creates or refreshes the Python runtime and Chromium and reports core and Chromium status separately.
• Doctor checks runtime readiness without changing the system.
• If a tool reports that setup is required, run /seo setup rather than installing packages by hand.

Trigger the skill with natural requests

You can use the explicit command form /seo followed by a command and a URL. You can also ask in plain language. The skill lists trigger words including SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality and page speed.

The hub is meant for cases where the SEO area is clear but the specific workflow is not. If you know exactly what you need, the skill points you to the matching specific seo-* skill, so naming the task helps.

• Full audit: 'Audit example.com for SEO problems.' or /seo audit <url>
• Single page: /seo page <url>
• Schema: /seo schema <url> to detect, validate and generate Schema.org markup
• Technical: /seo technical <url> for a 9-category technical audit
• Content: /seo content <url> for E-E-A-T and content quality
• AI answer engines: /seo geo <url>
• Local: /seo local <url> for Google Business Profile, citations, reviews and map pack

Example requests and what to expect

A full audit delegates work to several subagents in parallel, then combines the results into one report. Audits can take a while because they involve crawling and API calls. For single commands, the skill loads the relevant sub-skill directly.

After any analysis command finishes, the skill offers to produce a PDF report using a bundled script. Google update history questions are answered from a bundled primary-source ledger rather than from memory.

• Ask: 'Check the Core Web Vitals and page speed of this product page' and the agent runs the technical and performance checks.
• Ask: 'Validate the schema on my homepage and suggest missing types.'
• Ask: 'Review my Google Business Profile and citations for my plumbing business.'
• Ask: 'Which of my articles look weakest on E-E-A-T?'

What it needs and safety notes

The skill runs scripts and uses the network. Setup installs Python packages and Chromium. Some features need Google API credentials for Search Console, PageSpeed, CrUX or GA4. Others need optional Matomo, Moz, Bing or DataForSEO credentials. The Claude Code plugin environment is needed for the launcher path that the skill uses.

Only audit sites you have permission to test, because audits can involve crawling and API calls. Optional data sources need paid or credentialed accounts, so the core analyses may be all you use.

• Required: Python runtime and Chromium, installed through /seo setup.
• Optional: Google API credentials (GSC, PageSpeed, CrUX, GA4).
• Optional: Matomo, Moz, Bing or DataForSEO credentials.
• Uses network: yes. Runs scripts: yes.
• Licence: MIT.