skills/seo-audit/SKILL.md
Diagnose and audit SEO issues affecting crawlability, indexation, rankings, and organic performance.
npx skillsauth add dexsdevelopers/site-financeiro 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.
This skill is applicable to execute the workflow or actions described in the overview.
development
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reacti...
tools
Automate Zoom meeting creation, management, recordings, webinars, and participant tracking via Rube MCP (Composio). Always search tools first for current schemas.
tools
Automate Zoho CRM tasks via Rube MCP (Composio): create/update records, search contacts, manage leads, and convert leads. Always search tools first for current schemas.
tools
Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.