seo-audit

sickn33/antigravity-awesome-skills · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill seo-audit
0 commentsdiscussion
summary

$22

skill.md

SEO Audit

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.


Scope Gate (Ask First if Missing)

Before performing a full audit, clarify:

  1. Business Context

    • Site type (SaaS, e-commerce, blog, local, marketplace, etc.)
    • Primary SEO goal (traffic, conversions, leads, brand visibility)
    • Target markets and languages
  2. SEO Focus

    • Full site audit or specific sections/pages?
    • Technical SEO, on-page, content, or all?
    • Desktop, mobile, or both?
  3. Data Access

    • Google Search Console access?
    • Analytics access?
    • Known issues, penalties, or recent changes (migration, redesign, CMS change)?

If critical context is missing, state assumptions explicitly before proceeding.


Audit Framework (Priority Order)

  1. Crawlability & Indexation – Can search engines access and index the site?
  2. Technical Foundations – Is the site fast, stable, and accessible?
  3. On-Page Optimization – Is each page clearly optimized for its intent?
  4. Content Quality & E-E-A-T – Does the content deserve to rank?
  5. Authority & Signals – Does the site demonstrate trust and relevance?

Technical SEO Audit

Crawlability

Robots.txt

  • Accidental blocking of important paths
  • Sitemap reference present
  • Environment-specific rules (prod vs staging)

XML Sitemaps

  • Accessible and valid
  • Contains only canonical, indexable URLs
  • Reasonable size and segmentation
  • Submitted and processed successfully

Site Architecture

  • Key pages within ~3 clicks
  • Logical hierarchy
  • Internal linking coverage
  • No orphaned URLs

Crawl Efficiency (Large Sites)

  • Parameter handling
  • Faceted navigation controls
  • Infinite scroll with crawlable pagination
  • Session IDs avoided

Indexation

Coverage Analysis

  • Indexed vs expected pages
  • Excluded URLs (intentional vs accidental)

Common Indexation Issues

  • Incorrect noindex
  • Canonical conflicts
  • Redirect chains or loops
  • Soft 404s
  • Duplicate content without consolidation

Canonicalization Consistency

  • Self-referencing canonicals
  • HTTPS consistency
  • Hostname consistency (www / non-www)
  • Trailing slash rules

Performance & Core Web Vitals

Key Metrics

  • LCP < 2.5s
  • INP < 200ms
  • CLS < 0.1

Contributing Factors

  • Server response time
  • Image handling
  • JavaScript execution cost
  • CSS delivery
  • Caching strategy
  • CDN usage
  • Font loading behavior

Mobile-Friendliness

  • Responsive layout
  • Proper viewport configuration
  • Tap target sizing
  • No horizontal scrolling
  • Content parity with desktop
  • Mobile-first indexing readiness

Security & Accessibility Signals

  • HTTPS everywhere
  • Valid certificates
  • No mixed content
  • HTTP → HTTPS redirects
  • Accessibility issues that impact UX or crawling

On-Page SEO Audit

Title Tags

  • Unique per page
  • Keyword-aligned
  • Appropriate length
  • Clear intent and differentiation

Meta Descriptions

  • Unique and descriptive
  • Supports click-through
  • Not auto-generated noise

Heading Structure

  • One clear H1
  • Logical hierarchy
  • Headings reflect content structure

Content Optimization

  • Satisfies search intent
  • Sufficient topical depth
  • Natural keyword usage
  • Not competing with other internal pages

Images

  • Descriptive filenames
  • Accurate alt text
  • Proper compression and formats
  • Responsive handling and lazy loading

Internal Linking

  • Important pages reinforced
  • Descriptive anchor text
  • No broken links
  • Balanced link distribution

Content Quality & E-E-A-T

Experience & Expertise

  • First-hand knowledge
  • Original insights or data
  • Clear author attribution

Authoritativeness

  • Citations or recognition
  • Consistent topical focus

Trustworthiness

  • Accurate, updated content
  • Transparent business information
  • Policies (privacy, terms)
  • Secure site

🔢 SEO Health Index & Scoring Layer (Additive)

Purpose

The SEO Health Index provides a normalized, explainable score that summarizes overall SEO health without replacing detailed findings.

It is designed to:

  • Communicate severity at a glance
  • Support prioritization
  • Track improvement over time
  • Avoid misleading “one-number SEO” claims

Scoring Model Overview

Total Score: 0–100

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.


Category Scoring Rules

Each category is scored independently, then weighted.

Per-Category Score: 0–100

Start each category at 100 and subtract points based on issues found.

Severity Deductions

Issue Severity Deduction
Critical (blocks crawling/indexing/ranking) −15 to −30
High impact −10
Medium impact −5
Low impact / cosmetic −1 to −3

Confidence Modifier

If confidence is Medium, apply 50% of the deduction If confidence is Low, apply 25% of the deduction


Example (Category)

Crawlability & Indexation (Weight: 30)

  • Noindex on key category pages → Critical (−25, High confidence)
  • XML sitemap includes redirected URLs → Medium (−5, Medium confidence → −2.5)
  • Missing sitemap reference in robots.txt → Low (−2)

Raw score: 100 − 29.5 = 70.5 Weighted contribution: 70.5 × 0.30 = 21.15


Overall SEO Health Index

Calculation

SEO Health Index =
Σ (Category Score × Category Weight)

Rounded to nearest whole number.


Health Bands (Required)

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

Output Requirements (Scoring Section)

Include this after the Executive Summary:

SEO Health Index

  • Overall Score: XX / 100
  • Health Status: [Excellent / Good / Fair / Poor / Critical]

Category Breakdown

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

Interpretation Rules (Mandatory)

  • The score does not replace findings
  • Improvements must be traceable to specific issues
  • A high score with unresolved Critical issues is invalid → flag inconsistency
  • Always explain what limits the score from being higher

Change Tracking (Optional but Recommended)

If a previous audit exists:

  • Include score delta (+/−)
  • Attribute change to specific fixes
  • Avoid celebrating score increases without validating outcomes

Explicit Limitations (Always State)

  • Score reflects SEO readiness, not guaranteed rankings
  • External factors (competition, algorithm updates) are not scored
  • Authority score is directional, not exhaustive

Findings Classification (Required · Scoring-Aligned)

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:

    • Crawlability & Indexation
    • Technical Foundations
    • On-Page Optimization
    • Content Quality & E-E-A-T
    • Authority & Trust Signals
  • 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:

    • Critical (blocks crawling, indexation, or ranking)
    • High
    • Medium
    • Low
  • Confidence One of:

    • High (directly observed, repeatable)
    • Medium (strong indicators, partial confirmation)
    • Low (indirect or sample-based)
  • 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.


Prioritized Action Plan (Derived from Findings)

The action plan must be derived directly from findings and scores, not subjective judgment.

Group actions as follows:

  1. Critical Blockers

    • Issues with Critical severity
    • Issues that invalidate the SEO Health Index if unresolved
    • Highest negative score impact
  2. High-Impact Improvements

    • High or Medium severity issues with large cumulative score deductions
    • Issues affecting multiple pages or templates
  3. Quick Wins

    • Low or Medium severity issues
    • Easy to fix with measurable score improvement
  4. Longer-Term Opportunities

    • Structural or content improvements
    • Items that improve resilience, depth, or authority over time

For each action group:

  • Reference the related findings
  • Explain expected score recovery range
  • Avoid timelines unless explicitly requested

Tools (Evidence Sources Only)

Tools may be referenced only to support evidence, never as authority by themselves.

Acceptable uses:

  • Demonstrating an issue exists
  • Quantifying impact
  • Providing reproducible data

Examples:

  • Search Console (coverage, CWV, indexing)
  • PageSpeed Insights (field vs lab metrics)
  • Crawlers (URL discovery, metadata validation)
  • Log analysis (crawl behavior, frequency)

Rules:

  • Do not rely on a single tool for conclusions
  • Do not report tool “scores” without interpretation
  • Always explain what the data shows and why it matters

Related Skills (Non-Overlapping)

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.

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

how to use seo-audit

How to use seo-audit on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add seo-audit
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill seo-audit

The skills CLI fetches seo-audit from GitHub repository sickn33/antigravity-awesome-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/seo-audit

Reload or restart Cursor to activate seo-audit. Access the skill through slash commands (e.g., /seo-audit) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.669 reviews
  • Camila Agarwal· Dec 24, 2024

    Registry listing for seo-audit matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Isabella Yang· Dec 16, 2024

    Solid pick for teams standardizing on skills: seo-audit is focused, and the summary matches what you get after install.

  • Pratham Ware· Dec 12, 2024

    We added seo-audit from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Yuki Khan· Dec 12, 2024

    Useful defaults in seo-audit — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Camila Chawla· Dec 12, 2024

    We added seo-audit from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Evelyn Anderson· Dec 8, 2024

    Keeps context tight: seo-audit is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Diya Robinson· Dec 4, 2024

    I recommend seo-audit for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Valentina Liu· Nov 27, 2024

    seo-audit is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Diego Shah· Nov 23, 2024

    We added seo-audit from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Diego Sharma· Nov 23, 2024

    Useful defaults in seo-audit — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

showing 1-10 of 69

1 / 7