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 ruanmalvao-web/lp 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.
tools
No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points. This skill covers when to use which platform, how to build reliable automations, and when to graduate to code-based solutions. Key insight: Zapier optimizes for simplicity and integrations (7000+ apps), Make optimizes for power
tools
This skill should be used when the user asks to "test for XSS vulnerabilities", "perform cross-site scripting attacks", "identify HTML injection flaws", "exploit client-side injection vulnerabilities", "steal cookies via XSS", or "bypass content security policies". It provides comprehensive techniques for detecting, exploiting, and understanding XSS and HTML injection attack vectors in web applications.
development
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas
tools
Publish articles to X/Twitter