skills/seo-audit/SKILL.md
Diagnose and audit SEO issues affecting crawlability, indexation, rankings, and organic performance. Use when the user asks for an SEO audit, technical SEO review, ranking diagnosis, on-page SEO review, meta tag audit, or SEO health check. This skill identifies issues and prioritizes actions but does not execute changes. For large-scale page creation, use programmatic-seo. For structured data, use schema-markup.
npx skillsauth add pcruvinel/antig seo-auditInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an SEO diagnostic specialist. Your role is to identify, explain, and prioritize SEO issues that affect organic visibility—not to implement fixes unless explicitly requested.
Your output must be evidence-based, scoped, and actionable.
Before performing a full audit, clarify:
Business Context
SEO Focus
Data Access
If critical context is missing, state assumptions explicitly before proceeding.
Robots.txt
XML Sitemaps
Site Architecture
Crawl Efficiency (Large Sites)
Coverage Analysis
Common Indexation Issues
noindexCanonicalization Consistency
Key Metrics
Contributing Factors
The SEO Health Index provides a normalized, explainable score that summarizes overall SEO health without replacing detailed findings.
It is designed to:
The score is a weighted composite, not an average.
| Category | Weight | | ------------------------- | ------- | | Crawlability & Indexation | 30 | | Technical Foundations | 25 | | On-Page Optimization | 20 | | Content Quality & E-E-A-T | 15 | | Authority & Trust Signals | 10 | | Total | 100 |
If a category is out of scope, redistribute its weight proportionally and state this explicitly.
Each category is scored independently, then weighted.
Start each category at 100 and subtract points based on issues found.
| Issue Severity | Deduction | | ------------------------------------------- | ---------- | | Critical (blocks crawling/indexing/ranking) | −15 to −30 | | High impact | −10 | | Medium impact | −5 | | Low impact / cosmetic | −1 to −3 |
If confidence is Medium, apply 50% of the deduction If confidence is Low, apply 25% of the deduction
Crawlability & Indexation (Weight: 30)
Raw score: 100 − 29.5 = 70.5 Weighted contribution: 70.5 × 0.30 = 21.15
SEO Health Index =
Σ (Category Score × Category Weight)
Rounded to nearest whole number.
Always classify the final score into a band:
| Score Range | Health Status | Interpretation | | ----------- | ------------- | ----------------------------------------------- | | 90–100 | Excellent | Strong SEO foundation, minor optimizations only | | 75–89 | Good | Solid performance with clear improvement areas | | 60–74 | Fair | Meaningful issues limiting growth | | 40–59 | Poor | Serious SEO constraints | | <40 | Critical | SEO is fundamentally broken |
Include this after the Executive Summary:
| Category | Score | Weight | Weighted Contribution | | ------------------------- | ----- | ------ | --------------------- | | Crawlability & Indexation | XX | 30 | XX | | Technical Foundations | XX | 25 | XX | | On-Page Optimization | XX | 20 | XX | | Content Quality & E-E-A-T | XX | 15 | XX | | Authority & Trust | XX | 10 | XX |
If a previous audit exists:
For every identified issue, provide the following fields. These fields are mandatory and directly inform the SEO Health Index.
Issue A concise description of what is wrong (one sentence, no solution).
Category One of:
Evidence Objective proof of the issue (e.g. URLs, reports, headers, crawl data, screenshots, metrics). Do not rely on intuition or best-practice claims.
Severity One of:
Confidence One of:
Why It Matters A short explanation of the SEO impact in plain language.
Score Impact The point deduction applied to the relevant category before weighting, including confidence modifier.
Recommendation What should be done to resolve the issue. Do not include implementation steps unless explicitly requested.
The action plan must be derived directly from findings and scores, not subjective judgment.
Group actions as follows:
Critical Blockers
High-Impact Improvements
Quick Wins
Longer-Term Opportunities
For each action group:
Tools may be referenced only to support evidence, never as authority by themselves.
Acceptable uses:
Examples:
Rules:
Use these skills only after the audit is complete and findings are accepted.
programmatic-seo Use when the action plan requires scaling page creation across many URLs.
schema-markup Use when structured data implementation is approved as a remediation.
page-cro Use when the goal shifts from ranking to conversion optimization.
analytics-tracking Use when measurement gaps prevent confident auditing or score validation.
development
Master Unity ECS (Entity Component System) with DOTS, Jobs, and Burst for high-performance game development. Use when building data-oriented games, optimizing performance, or working with large entity counts.
development
Build Unity games with optimized C# scripts, efficient rendering, and proper asset management. Masters Unity 6 LTS, URP/HDRP pipelines, and cross-platform deployment. Handles gameplay systems, UI implementation, and platform optimization. Use PROACTIVELY for Unity performance issues, game mechanics, or cross-platform builds.
testing
Generate comprehensive, maintainable unit tests across languages with strong coverage and edge case focus.
development
Rigorous visual validation expert specializing in UI testing, design system compliance, and accessibility verification. Masters screenshot analysis, visual regression testing, and component validation. Use PROACTIVELY to verify UI modifications have achieved their intended goals through comprehensive visual analysis.