seo-audit

SEO Audit Skill

Evidence-based SEO diagnostic skill built from Google Search Central, Ahrefs SEO checklist, and Microsoft's AEO/GEO guidance.

English | 简体中文

Reference sources:

• Google Search Central
• Ahrefs SEO + AI Search Checklist
• Microsoft AEO & GEO Guide

What's New in v1.4.1

• Classification upgraded to Title + URL + Nav
• Top-2 site-type output + confidence score (with medium/low confidence handling)
• Non-blocking low-confidence confirmation strategy (default continue)
• Article-page secondary discovery (/insights, /docs) added on top of primary content paths
• Report appendix now includes explainability fields (Top-1/Top-2, confidence, signals, fallback path)

Quick Mode Selector

The skill supports an intelligent interaction flow and can run in two modes:

Detailed guide: USAGE.md

Why This Skill Exists

Traditional SEO tools often require account setup, paid subscriptions, and heavy workflows. This skill keeps the audit process lightweight and transparent.

Value

1. No lock-in: run directly in Claude Code, no external dashboard required.
2. Practical: one command starts a full or basic audit.
3. Transparent: checklist logic is open and based on public guidance.
4. Evolving: includes report export, and continues to improve with each release.

Quick Start

Install

Copy SKILL.md and references/ into your Claude Code skills directory:

git clone https://github.com/wonfull888/seo-audit.git
cp -r seo-audit ~/.claude/skills/

Run

# Auto-detect report language (recommended)
/seo-audit https://example.com

# Force English report
/seo-audit https://example.com --en

# Force Chinese report
/seo-audit https://example.com --zh

Language selection priority:

1. Explicit flag: --en / --zh
2. Auto-detection from user input language
3. Default fallback: English

Configure PageSpeed API Key (Recommended)

Google PageSpeed Insights API includes a free quota of 25,000 requests/day.

export PAGE_SPEED_API_KEY="your_api_key_here"

If environment variable is missing, the skill will auto-try:

1. ./.env
2. ~/.claude/skills/seo-audit/.env

More details:

• API_KEY_SETUP.md
• QUOTA.md

Audit Workflow

User provides URL
    -> 1. Check environment (API key)
    -> 2. Detect report language
    -> 3. Classify site type (Title + URL)
    -> 4. Select representative pages (home + key business + article)
    -> 5. Collect data (curl + WebFetch + optional PageSpeed API)
    -> 6. Analyze 4 dimensions (92 checks)
    -> 7. Generate and save full Markdown report

Checklist Overview

Scoring Scale

Reports

• Default example report (English): assets/example-report.en.md
• Chinese example report: assets/example-report.md

Every report includes:

• Executive Summary at the beginning
• Site type and crawled URLs
• Overall and dimension scores
• P0/P1/P2 action items
• Full 92-row checklist table
• Actionable recommendations
• Standard brand footer

Default report save path:

• ~/.claude/skills/seo-audit/reports/seo-audit-report-{domain}-{timestamp}.md

File Structure

seo-audit/
|-- SKILL.md
|-- README.md
|-- README.zh-CN.md
|-- USAGE.md
|-- API_KEY_SETUP.md
|-- QUOTA.md
|-- CHANGELOG.md
|-- docs/
|   |-- en/
|   |   |-- USAGE.md
|   |   |-- API_KEY_SETUP.md
|   |   `-- QUOTA.md
|   `-- zh-CN/
|       |-- USAGE.md
|       |-- API_KEY_SETUP.md
|       `-- QUOTA.md
|-- references/
|   |-- report-template.md
|   |-- report-template.en.md
|   |-- report-template.zh-CN.md
|   |-- language-detection.md
|   `-- SEO_TERMINOLOGY_GLOSSARY.md
`-- assets/
    |-- example-report.en.md
    |-- example-report.md
    `-- example-report.zh-CN.md

License

MIT License

Acknowledgements

• Google Search Central
• Ahrefs SEO team
• Microsoft Ads and Search guidance team

SEO Audit Skill | GitHub | Developer: x.com/wonfull888