Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/sickn33/agentic-awesome-skills --skill seo-audit- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads seo-audit automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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:
-
Business Context
- Site type (SaaS, e-commerce, blog, local, marketplace, etc.)
- Primary SEO goal (traffic, conversions, leads, brand visibility)
- Target markets and languages
-
SEO Focus
- Full site audit or specific sections/pages?
- Technical SEO, on-page, content, or all?
- Desktop, mobile, or both?
-
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)
- Crawlability & Indexation – Can search engines access and index the site?
- Technical Foundations – Is the site fast, stable, and accessible?
- On-Page Optimization – Is each page clearly optimized for its intent?
- Content Quality & E-E-A-T – Does the content deserve to rank?
- 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 at or below 2.5s
- INP at or below 200ms
- CLS at or below 0.1
Evaluate field data at the 75th percentile with the relevant device population. Keep lab diagnostics distinct from observed field performance; see Google’s Core Web Vitals guidance.
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 optional SEO Health Index is a subjective audit rubric, not a validated search-engine metric. It can organize findings only when its weights, scope and deductions are disclosed. Do not invent points for unavailable data or imply an effect on rankings.
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 |
Mark uninspected categories as unknown. If presenting a scoped score, name its scope and do not compare it with an earlier full-site score.
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
Keep confidence separate from severity. An uncertain critical finding needs verification; reducing its numerical deduction does not make the site safer to index.
Example (Category)
Crawlability & Indexation (Weight: 30)
- Noindex on key category pages → Critical (−25, High confidence)
- XML sitemap includes redirected URLs → Medium (−5, Medium confidence; verify separately)
- Missing sitemap reference in robots.txt → Low (−2)
Raw score: 100 − 32 = 68 Weighted contribution: 68 × 0.30 = 20.4
Overall SEO Health Index
Calculation
SEO Health Index =
Σ (Category Score × Category Weight)
Rounded to nearest whole number.
Illustrative bands (optional)
If a rubric is requested, label its bands as internal planning labels rather than measured SEO performance:
| 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)
If a score is requested, include this after the evidence-based findings:
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 Optional rubric deduction, with confidence reported separately; omit when no score is requested.
-
Recommendation What should be done to resolve the issue. Do not include implementation steps unless explicitly requested.
Prioritized Action Plan (Derived from Findings)
Derive the action plan from observed findings, affected URLs and product importance. A subjective score must not override crawl/indexation evidence.
Group actions as follows:
-
Critical Blockers
- Issues with Critical severity
- Issues that invalidate the SEO Health Index if unresolved
- Highest negative score impact
-
High-Impact Improvements
- High or Medium severity issues with large cumulative score deductions
- Issues affecting multiple pages or templates
-
Quick Wins
- Low or Medium severity issues
- Easy to fix with a verifiable user or crawlability benefit
-
Longer-Term Opportunities
- Structural or content improvements
- Items that improve resilience, depth, or authority over time
For each action group:
- Reference the related findings
- Define the observable verification after remediation
- Avoid timelines unless explicitly requested
Evidence sources
Use Search Console for reported indexing and field data, crawlers for sampled URL behavior, and logs for observed requests. Record dates, scope and missing coverage. Cross-check material claims against the actual page; tool scores are not authority.
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
Use for a specific indexing/crawlability issue, a migration check or a scoped organic-performance audit. Start from the declared production URLs and available Search Console/crawl evidence; local source changes do not prove live deployment or indexing.
Worked example
Input: a legacy URL redirects to a new catalog. Fetch the legacy URL and every redirect hop, inspect final status/canonical/robots directives, and compare the destination with sitemap/internal links. Expected: a finite redirect chain to the intended indexable URL, with no conflicting canonical. Then check Search Console separately; a correct HTTP response does not prove that Google selected or indexed it.
Limitations
- Rankings and traffic depend on demand, competition and search-engine processing; technical corrections do not guarantee recovery.
- A sampled crawl cannot establish that every URL or rendered state is correct.
- Canonical tags are signals, and sitemap inclusion is not proof of indexation.
- Lab performance, field percentiles and an internal audit score answer different questions; report the source and date of each.
FAQ
What does the seo-audit skill do?
Diagnose and audit SEO issues affecting crawlability, indexation, rankings, and organic performance.
How do I install seo-audit?
Run npx skills add https://github.com/sickn33/agentic-awesome-skills --skill seo-audit in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/seo-audit/ (personal) or .claude/skills/seo-audit/ (project).
Which AI agents can use seo-audit?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is seo-audit safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains seo-audit?
It is published by sickn33 in sickn33/agentic-awesome-skills. It has 1,003 recorded installs.
More from sickn33/agentic-awesome-skills
docker-expert
sickn33/agentic-awesome-skills
You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, multi-stage builds, orchestration patterns, and production deployment strategies based on current industry best practices.
nodejs-best-practices
sickn33/agentic-awesome-skills
Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.
typescript-expert
sickn33/agentic-awesome-skills
TypeScript and JavaScript expert with deep knowledge of type-level programming, performance optimization, monorepo management, migration strategies, and modern tooling.
clean-code
sickn33/agentic-awesome-skills
This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean."
api-security-best-practices
sickn33/agentic-awesome-skills
Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common API vulnerabilities
nextjs-best-practices
sickn33/agentic-awesome-skills
Next.js App Router principles. Server Components, data fetching, routing patterns.
Popular security skills
azure-compliance
microsoft/azure-skills
Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.
minimal-run-and-audit
lllllllama/rigorpilot-skills
Rigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation command and write standardized reprooutputs/ files, including patch notes when repository files changed. Do not use for training execution, initial repo intake, generic environment setup, paper lookup, target selection, hidden scientific-meaning changes, or end-to-end orchestration by itself.
seo-audit
coreyhaines31/marketingskills
When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.
firebase-security-rules-auditor
firebase/agent-skills
Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing/reviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.
audit
pbakaus/impeccable
Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.
competitors
coreyhaines31/marketingskills
When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'competitor teardown,' 'audit our competitor pages,' 'are our comparison pages out of date,' or 'competitive asset audit.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For auditing existing claims (not researching competitors from scratch, which is competitor-profiling; not technical SEO on these pages, which is seo-audit), use the asset audit here. For internal battle cards and sales-specific competitor docs, see sales-enablement.
