borghei/Claude-Skills / marketing/seo-audit
seo-audit
VerifiedTechnical SEO auditing covering crawlability, indexation, Core Web Vitals, on-page optimization, and competitive gaps, with an 85-point checklist and remediation plans. Use when auditing technical SEO or diagnosing indexation issues.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.5 KB |
| references/audit-checklist.md | markdown | 10.2 KB |
| references/diagnostics-and-analysis.md | markdown | 6.6 KB |
| references/remediation-and-migration.md | markdown | 5.2 KB |
| scripts/content_scorer.py | script | 13.1 KB |
| scripts/redirect_checker.py | script | 9.9 KB |
| scripts/sitemap_analyzer.py | script | 13.4 KB |
SKILL.md
View on GitHub---
name: seo-audit
description: >
Technical SEO auditing covering crawlability, indexation, Core Web Vitals,
on-page optimization, and competitive gaps, with an 85-point checklist and
remediation plans. Use when auditing technical SEO or diagnosing indexation
issues.
license: MIT + Commons Clause
metadata:
version: 1.1.0
author: borghei
category: marketing-growth
domain: seo
updated: 2026-06-15
tags:
- seo
- audit
- technical-seo
- core-web-vitals
- indexation
- crawl-analysis
---
# SEO Audit
Production-grade SEO audit framework with an 85-point checklist across 8 dimensions, severity-weighted scoring, automated diagnostic workflows, and prioritized remediation plans. Covers technical SEO, on-page optimization, content quality, competitive positioning, and migration readiness.
## Core Capabilities
- **85-point checklist across 8 dimensions** — crawlability, indexation, Core Web Vitals, on-page, content quality, infrastructure, off-page, analytics
- **Severity-weighted scoring** — Critical/High/Medium/Low multipliers roll up to an A–F health grade
- **Diagnostic deep dives** — CWV optimization stacks, indexation gap analysis, traffic-drop decision tree, cannibalization & intent matching, E-E-A-T and AI-content detection
- **Competitive gap analysis** — your site vs. 3 competitors across technical and content dimensions
- **Prioritized remediation** — P0–P4 priority framework, fix-list template, and migration checklists
## When to Use
Pick the operating mode that matches the situation:
- **Full Site Audit** — comprehensive audit across all 8 dimensions; use for initial assessment or annual reviews.
- **Focused Audit** — single-dimension deep dive when the problem area is already identified (e.g., failing Core Web Vitals, indexation issues).
- **Pre-Migration Audit** — for planned URL changes, platform switches, or redesigns; establishes baseline and redirect mapping.
- **Traffic Drop Diagnosis** — emergency diagnostic when organic traffic drops; follows the traffic-drop decision tree to isolate cause.
## Clarify First
Before auditing, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.
- **Audit mode:** full site, single-dimension focused, pre-migration, or traffic-drop diagnosis — sets scope and which of the 8 dimensions to run.
- **Site URL + available data:** GSC, analytics, and crawl exports on hand — determines what can be verified vs. assumed in the findings.
- **Primary symptom or goal:** e.g. ranking drop, indexation gap, failing Core Web Vitals — focuses the diagnostic deep-dives and remediation priority.
- **Competitor set:** the 3 sites to benchmark against — drives the competitive gap analysis.
Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.
## Quick Start
```bash
# Check redirect chains and status codes
python scripts/redirect_checker.py --url https://example.com/old-page --json
# Analyze XML sitemap for errors
python scripts/sitemap_analyzer.py --sitemap https://example.com/sitemap.xml
# Score content quality for SEO
python scripts/content_scorer.py article.md --json
```
## References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- **[references/audit-checklist.md](references/audit-checklist.md)** — initial scoping questions, the full 85-point checklist across all 8 dimensions, and the severity-weighted scoring formula. Read when starting an audit or scoring results.
- **[references/diagnostics-and-analysis.md](references/diagnostics-and-analysis.md)** — Core Web Vitals optimization stacks, indexation gap analysis, traffic-drop decision tree, cannibalization/intent scoring, AI-content & E-E-A-T detection, competitive gap framework. Read when diagnosing a specific problem area.
- **[references/remediation-and-migration.md](references/remediation-and-migration.md)** — migration checklist (pre/during/post), P0–P4 remediation framework and plan template, output artifacts, troubleshooting table, and success criteria. Read when turning findings into an action plan.
## Scope & Limitations
**In scope:** technical SEO across all 8 audit dimensions, severity-weighted scoring with prioritized remediation, traffic-drop diagnosis, competitive gap analysis, pre/post-migration checklists, AI content quality detection.
**Out of scope:** content creation or rewriting (use Content Creator), structured data implementation (use Schema Markup), site architecture redesign (use Site Architecture), link building execution, paid search audits, server/CDN provisioning.
**Known limitations:** field CWV data requires sufficient traffic for CrUX; off-page signals need third-party tools (Ahrefs, SEMrush); AI Overview impact on CTR varies by query type; Google's algorithm changes 500–600 times/year, so findings are point-in-time.
## Integration Points
- **AI SEO** — run after audit to optimize for AI search citation alongside traditional findings.
- **Schema Markup** — use when audit reveals missing or broken structured data opportunities.
- **Site Architecture** — use when audit uncovers structural issues requiring architectural redesign.
- **Content Humanizer** — use when audit flags AI content detection signals on key pages.
- **Content Strategy / programmatic-seo** — use when audit reveals content gaps or keyword-gap clusters addressable at scale.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |