SEO audit skill

When the user wants to run an SEO audit, technical SEO audit, or site health check.

by kostja94·MIT license·★ 1,006 Stars on the repo·GitHub ↗

Use now

Files of SEO audit

kostja94/main1 file shown
SKILL.md
Show the full text80 lines

Strategies: SEO Audit

Guides end-to-end SEO audit: technical foundation, on-page, content, and off-page. Execute in order—technical blockers prevent indexing; on-page limits rankings; content and off-page build authority. Use when auditing an existing site or planning fixes.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Audit Order

Phase Focus Skills
1. Technical Crawl, index, sitemap robots-txt, xml-sitemap, canonical-tag, indexing, site-crawlability
2. On-Page Metadata, structure, schema title-tag, meta-description, page-metadata, schema-markup, internal-links, heading-structure
3. Content Gaps, intent, optimization keyword-research, content-strategy, content-optimization
4. Off-Page Backlinks, authority link-building, backlink-analysis

Principle: Fix foundation before optimizing pages. See seo-strategy for workflow and prioritization.

Technical Checklist

Item Check Skill
robots.txt Syntax; not blocking important pages robots-txt
Sitemap Submitted to GSC; indexable pages only; ≤50K URLs per sitemap xml-sitemap
HTTPS Sitewide; valid certificate canonical-tag
404/5xx Proper status codes; fix or redirect site-crawlability
noindex No accidental noindex on key pages indexing
Canonical Correct; no conflicts canonical-tag
Core Web Vitals LCP ≤2.5s, INP ≤200ms, CLS <0.1 core-web-vitals
Mobile Mobile-first; content parity; no intrusive interstitials mobile-friendly
Crawlability Redirect chains, broken links, orphan pages site-crawlability

On-Page Checklist

Item Check Skill
Title Unique; 50–60 chars; keyword in first 10 words title-tag
Meta description 150–160 chars; CTA meta-description
Headings One H1; H1→H2→H3 hierarchy heading-structure
Images Alt text; no decorative alt for decorative images image-optimization
Schema Valid; Rich Results Test schema-markup
Internal links From strong pages; descriptive anchors internal-links
Duplicate content Canonical; consolidate or differentiate canonical-tag

Content & Off-Page

Phase Focus Skill
Content gap Missing topics vs competitors content-strategy, competitor-research
Intent match Content matches search intent content-optimization
Backlinks Toxic links; link gap vs competitors backlink-analysis, link-building

Frequency

Cadence Use
Full audit Quarterly
Check-ins Monthly (GSC, indexing, Core Web Vitals)

Output Format

  • Phase 1–4 findings (technical → on-page → content → off-page)
  • Priority list (P0 blocker → P1 core → P2 important)
  • Skill mapping (which skill for each fix)
  • Timeline (immediate vs short-term vs ongoing)
  • seo-strategy: Workflow order, prioritization, when to invest in SEO
  • google-search-console: Performance, indexing, Core Web Vitals data
  • site-crawlability: Redirect chains, broken links, crawl budget
  • indexing: Indexing issues, noindex, Search Console
  • core-web-vitals: LCP, INP, CLS optimization
1---
2name: seo-audit
3description: When the user wants to run an SEO audit, technical SEO audit, or site health check. Also use when the user mentions "SEO audit," "technical audit," "site audit," "crawl audit," "indexing audit," "SEO health," or "fix SEO issues." For prioritization and organic strategy, use seo-strategy. For GSC data analysis, use google-search-console.
4metadata:
5 version: 1.1.0
6---
7 
8# Strategies: SEO Audit
9 
10Guides end-to-end SEO audit: technical foundation, on-page, content, and off-page. Execute in order—technical blockers prevent indexing; on-page limits rankings; content and off-page build authority. Use when auditing an existing site or planning fixes.
11 
12**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
13 
14## Audit Order
15 
16| Phase | Focus | Skills |
17|-------|-------|--------|
18| **1. Technical** | Crawl, index, sitemap | robots-txt, xml-sitemap, canonical-tag, indexing, site-crawlability |
19| **2. On-Page** | Metadata, structure, schema | title-tag, meta-description, page-metadata, schema-markup, internal-links, heading-structure |
20| **3. Content** | Gaps, intent, optimization | keyword-research, content-strategy, content-optimization |
21| **4. Off-Page** | Backlinks, authority | link-building, backlink-analysis |
22 
23**Principle**: Fix foundation before optimizing pages. See **seo-strategy** for workflow and prioritization.
24 
25## Technical Checklist
26 
27| Item | Check | Skill |
28|------|-------|-------|
29| **robots.txt** | Syntax; not blocking important pages | robots-txt |
30| **Sitemap** | Submitted to GSC; indexable pages only; ≤50K URLs per sitemap | xml-sitemap |
31| **HTTPS** | Sitewide; valid certificate | canonical-tag |
32| **404/5xx** | Proper status codes; fix or redirect | site-crawlability |
33| **noindex** | No accidental noindex on key pages | indexing |
34| **Canonical** | Correct; no conflicts | canonical-tag |
35| **Core Web Vitals** | LCP ≤2.5s, INP ≤200ms, CLS <0.1 | core-web-vitals |
36| **Mobile** | Mobile-first; content parity; no intrusive interstitials | mobile-friendly |
37| **Crawlability** | Redirect chains, broken links, orphan pages | site-crawlability |
38 
39## On-Page Checklist
40 
41| Item | Check | Skill |
42|------|-------|-------|
43| **Title** | Unique; 50–60 chars; keyword in first 10 words | title-tag |
44| **Meta description** | 150–160 chars; CTA | meta-description |
45| **Headings** | One H1; H1→H2→H3 hierarchy | heading-structure |
46| **Images** | Alt text; no decorative alt for decorative images | image-optimization |
47| **Schema** | Valid; Rich Results Test | schema-markup |
48| **Internal links** | From strong pages; descriptive anchors | internal-links |
49| **Duplicate content** | Canonical; consolidate or differentiate | canonical-tag |
50 
51## Content & Off-Page
52 
53| Phase | Focus | Skill |
54|-------|-------|-------|
55| **Content gap** | Missing topics vs competitors | content-strategy, competitor-research |
56| **Intent match** | Content matches search intent | content-optimization |
57| **Backlinks** | Toxic links; link gap vs competitors | backlink-analysis, link-building |
58 
59## Frequency
60 
61| Cadence | Use |
62|---------|-----|
63| **Full audit** | Quarterly |
64| **Check-ins** | Monthly (GSC, indexing, Core Web Vitals) |
65 
66## Output Format
67 
68- **Phase 1–4 findings** (technical → on-page → content → off-page)
69- **Priority list** (P0 blocker → P1 core → P2 important)
70- **Skill mapping** (which skill for each fix)
71- **Timeline** (immediate vs short-term vs ongoing)
72 
73## Related Skills
74 
75- **seo-strategy**: Workflow order, prioritization, when to invest in SEO
76- **google-search-console**: Performance, indexing, Core Web Vitals data
77- **site-crawlability**: Redirect chains, broken links, crawl budget
78- **indexing**: Indexing issues, noindex, Search Console
79- **core-web-vitals**: LCP, INP, CLS optimization
80 

Discussion

Alternatives

Agentic Browsing ReadinessAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).Marketing · MITBacklink Profile AnalysisBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.Marketing · MIT/setup-cmsConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report. · MITBacklink checkBacklink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor. Use when asked "check my backlinks", "backlink profile of X", "who links to them", or "link gap vs competitor".Marketing · MIT