Evidence-based SEO diagnostic skill built from Google Search Central, Ahrefs SEO checklist, and Microsoft's AEO/GEO guidance.
Reference sources:
- 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)
The skill supports an intelligent interaction flow and can run in two modes:
| Capability | Full Mode (Recommended) | Basic Mode |
|---|---|---|
| Setup complexity | Requires API key | Zero setup |
| Checklist size | 92 checks | 84 checks |
| Core Web Vitals | Yes (LCP, FCP, CLS, INP) | Skipped |
| PageSpeed score | Yes (Mobile + Desktop) | Skipped |
| Best use case | Complete SEO audit | Fast content and structure review |
| Free quota | 25,000 requests/day | N/A |
Detailed guide: USAGE.md
Traditional SEO tools often require account setup, paid subscriptions, and heavy workflows. This skill keeps the audit process lightweight and transparent.
- No lock-in: run directly in Claude Code, no external dashboard required.
- Practical: one command starts a full or basic audit.
- Transparent: checklist logic is open and based on public guidance.
- Evolving: includes report export, and continues to improve with each release.
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/# 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 --zhLanguage selection priority:
- Explicit flag:
--en/--zh - Auto-detection from user input language
- Default fallback: English
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:
./.env~/.claude/skills/seo-audit/.env
More details:
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
| Dimension | Checks | Weight | Notes |
|---|---|---|---|
| Technical SEO | 29 | 32% | Crawlability, indexing, security, CWV |
| On-Page SEO | 27 | 29% | Title, metadata, structure, AI-search readiness |
| Content Quality & E-E-A-T | 33 | 36% | Content depth, trust, expertise, authority |
| Local SEO | 3 | 3% | LocalBusiness schema, map signals, NAP |
| Total | 92 | 100% |
| Grade | Score | Status |
|---|---|---|
| A | 90-100 | Excellent |
| B | 80-89 | Good |
| C | 70-79 | Average |
| D | 60-69 | Weak |
| F | <60 | Poor |
- 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
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
- Google Search Central
- Ahrefs SEO team
- Microsoft Ads and Search guidance team
SEO Audit Skill | GitHub | Developer: x.com/wonfull888