SEO audit skill

When the user wants to audit, review, or diagnose SEO issues on their site.

by davila7·MIT license·★ 32,299 Stars on the repo·GitHub ↗

Use now

Files of SEO audit

davila7/main1 file shown
SKILL.md
Show the full text385 lines

SEO Audit

You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance.

Initial Assessment

Before auditing, understand:

  1. Site Context

    • What type of site? (SaaS, e-commerce, blog, etc.)
    • What's the primary business goal for SEO?
    • What keywords/topics are priorities?
  2. Current State

    • Any known issues or concerns?
    • Current organic traffic level?
    • Recent changes or migrations?
  3. Scope

    • Full site audit or specific pages?
    • Technical + on-page, or one focus area?
    • Access to Search Console / analytics?

Audit Framework

Priority Order
  1. Crawlability & Indexation (can Google find and index it?)
  2. Technical Foundations (is the site fast and functional?)
  3. On-Page Optimization (is content optimized?)
  4. Content Quality (does it deserve to rank?)
  5. Authority & Links (does it have credibility?)

Technical SEO Audit

Crawlability

Robots.txt

  • Check for unintentional blocks
  • Verify important pages allowed
  • Check sitemap reference

XML Sitemap

  • Exists and accessible
  • Submitted to Search Console
  • Contains only canonical, indexable URLs
  • Updated regularly
  • Proper formatting

Site Architecture

  • Important pages within 3 clicks of homepage
  • Logical hierarchy
  • Internal linking structure
  • No orphan pages

Crawl Budget Issues (for large sites)

  • Parameterized URLs under control
  • Faceted navigation handled properly
  • Infinite scroll with pagination fallback
  • Session IDs not in URLs
Indexation

Index Status

  • site:domain.com check
  • Search Console coverage report
  • Compare indexed vs. expected

Indexation Issues

  • Noindex tags on important pages
  • Canonicals pointing wrong direction
  • Redirect chains/loops
  • Soft 404s
  • Duplicate content without canonicals

Canonicalization

  • All pages have canonical tags
  • Self-referencing canonicals on unique pages
  • HTTP → HTTPS canonicals
  • www vs. non-www consistency
  • Trailing slash consistency
Site Speed & Core Web Vitals

Core Web Vitals

  • LCP (Largest Contentful Paint): < 2.5s
  • INP (Interaction to Next Paint): < 200ms
  • CLS (Cumulative Layout Shift): < 0.1

Speed Factors

  • Server response time (TTFB)
  • Image optimization
  • JavaScript execution
  • CSS delivery
  • Caching headers
  • CDN usage
  • Font loading

Tools

  • PageSpeed Insights
  • WebPageTest
  • Chrome DevTools
  • Search Console Core Web Vitals report
Mobile-Friendliness
  • Responsive design (not separate m. site)
  • Tap target sizes
  • Viewport configured
  • No horizontal scroll
  • Same content as desktop
  • Mobile-first indexing readiness
Security & HTTPS
  • HTTPS across entire site
  • Valid SSL certificate
  • No mixed content
  • HTTP → HTTPS redirects
  • HSTS header (bonus)
URL Structure
  • Readable, descriptive URLs
  • Keywords in URLs where natural
  • Consistent structure
  • No unnecessary parameters
  • Lowercase and hyphen-separated

On-Page SEO Audit

Title Tags

Check for:

  • Unique titles for each page
  • Primary keyword near beginning
  • 50-60 characters (visible in SERP)
  • Compelling and click-worthy
  • Brand name placement (end, usually)

Common issues:

  • Duplicate titles
  • Too long (truncated)
  • Too short (wasted opportunity)
  • Keyword stuffing
  • Missing entirely
Meta Descriptions

Check for:

  • Unique descriptions per page
  • 150-160 characters
  • Includes primary keyword
  • Clear value proposition
  • Call to action

Common issues:

  • Duplicate descriptions
  • Auto-generated garbage
  • Too long/short
  • No compelling reason to click
Heading Structure

Check for:

  • One H1 per page
  • H1 contains primary keyword
  • Logical hierarchy (H1 → H2 → H3)
  • Headings describe content
  • Not just for styling

Common issues:

  • Multiple H1s
  • Skip levels (H1 → H3)
  • Headings used for styling only
  • No H1 on page
Content Optimization

Primary Page Content

  • Keyword in first 100 words
  • Related keywords naturally used
  • Sufficient depth/length for topic
  • Answers search intent
  • Better than competitors

Thin Content Issues

  • Pages with little unique content
  • Tag/category pages with no value
  • Doorway pages
  • Duplicate or near-duplicate content
Image Optimization

Check for:

  • Descriptive file names
  • Alt text on all images
  • Alt text describes image
  • Compressed file sizes
  • Modern formats (WebP)
  • Lazy loading implemented
  • Responsive images
Internal Linking

Check for:

  • Important pages well-linked
  • Descriptive anchor text
  • Logical link relationships
  • No broken internal links
  • Reasonable link count per page

Common issues:

  • Orphan pages (no internal links)
  • Over-optimized anchor text
  • Important pages buried
  • Excessive footer/sidebar links
Keyword Targeting

Per Page

  • Clear primary keyword target
  • Title, H1, URL aligned
  • Content satisfies search intent
  • Not competing with other pages (cannibalization)

Site-Wide

  • Keyword mapping document
  • No major gaps in coverage
  • No keyword cannibalization
  • Logical topical clusters

Content Quality Assessment

E-E-A-T Signals

Experience

  • First-hand experience demonstrated
  • Original insights/data
  • Real examples and case studies

Expertise

  • Author credentials visible
  • Accurate, detailed information
  • Properly sourced claims

Authoritativeness

  • Recognized in the space
  • Cited by others
  • Industry credentials

Trustworthiness

  • Accurate information
  • Transparent about business
  • Contact information available
  • Privacy policy, terms
  • Secure site (HTTPS)
Content Depth
  • Comprehensive coverage of topic
  • Answers follow-up questions
  • Better than top-ranking competitors
  • Updated and current
User Engagement Signals
  • Time on page
  • Bounce rate in context
  • Pages per session
  • Return visits

Common Issues by Site Type

SaaS/Product Sites
  • Product pages lack content depth
  • Blog not integrated with product pages
  • Missing comparison/alternative pages
  • Feature pages thin on content
  • No glossary/educational content
E-commerce
  • Thin category pages
  • Duplicate product descriptions
  • Missing product schema
  • Faceted navigation creating duplicates
  • Out-of-stock pages mishandled
Content/Blog Sites
  • Outdated content not refreshed
  • Keyword cannibalization
  • No topical clustering
  • Poor internal linking
  • Missing author pages
Local Business
  • Inconsistent NAP
  • Missing local schema
  • No Google Business Profile optimization
  • Missing location pages
  • No local content

Output Format

Audit Report Structure

Executive Summary

  • Overall health assessment
  • Top 3-5 priority issues
  • Quick wins identified

Technical SEO Findings For each issue:

  • Issue: What's wrong
  • Impact: SEO impact (High/Medium/Low)
  • Evidence: How you found it
  • Fix: Specific recommendation
  • Priority: 1-5 or High/Medium/Low

On-Page SEO Findings Same format as above

Content Findings Same format as above

Prioritized Action Plan

  1. Critical fixes (blocking indexation/ranking)
  2. High-impact improvements
  3. Quick wins (easy, immediate benefit)
  4. Long-term recommendations

Tools Referenced

Free Tools

  • Google Search Console (essential)
  • Google PageSpeed Insights
  • Bing Webmaster Tools
  • Rich Results Test
  • Mobile-Friendly Test
  • Schema Validator

Paid Tools (if available)

  • Screaming Frog
  • Ahrefs / Semrush
  • Sitebulb
  • ContentKing

Questions to Ask

If you need more context:

  1. What pages/keywords matter most?
  2. Do you have Search Console access?
  3. Any recent changes or migrations?
  4. Who are your top organic competitors?
  5. What's your current organic traffic baseline?

  • programmatic-seo: For building SEO pages at scale
  • schema-markup: For implementing structured data
  • page-cro: For optimizing pages for conversion (not just ranking)
  • analytics-tracking: For measuring SEO performance
1---
2name: seo-audit
3description: 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," or "SEO health check." For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema-markup.
4---
5 
6# SEO Audit
7 
8You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance.
9 
10## Initial Assessment
11 
12Before auditing, understand:
13 
141. **Site Context**
15 - What type of site? (SaaS, e-commerce, blog, etc.)
16 - What's the primary business goal for SEO?
17 - What keywords/topics are priorities?
18 
192. **Current State**
20 - Any known issues or concerns?
21 - Current organic traffic level?
22 - Recent changes or migrations?
23 
243. **Scope**
25 - Full site audit or specific pages?
26 - Technical + on-page, or one focus area?
27 - Access to Search Console / analytics?
28 
29---
30 
31## Audit Framework
32 
33### Priority Order
341. **Crawlability & Indexation** (can Google find and index it?)
352. **Technical Foundations** (is the site fast and functional?)
363. **On-Page Optimization** (is content optimized?)
374. **Content Quality** (does it deserve to rank?)
385. **Authority & Links** (does it have credibility?)
39 
40---
41 
42## Technical SEO Audit
43 
44### Crawlability
45 
46**Robots.txt**
47- Check for unintentional blocks
48- Verify important pages allowed
49- Check sitemap reference
50 
51**XML Sitemap**
52- Exists and accessible
53- Submitted to Search Console
54- Contains only canonical, indexable URLs
55- Updated regularly
56- Proper formatting
57 
58**Site Architecture**
59- Important pages within 3 clicks of homepage
60- Logical hierarchy
61- Internal linking structure
62- No orphan pages
63 
64**Crawl Budget Issues** (for large sites)
65- Parameterized URLs under control
66- Faceted navigation handled properly
67- Infinite scroll with pagination fallback
68- Session IDs not in URLs
69 
70### Indexation
71 
72**Index Status**
73- site:domain.com check
74- Search Console coverage report
75- Compare indexed vs. expected
76 
77**Indexation Issues**
78- Noindex tags on important pages
79- Canonicals pointing wrong direction
80- Redirect chains/loops
81- Soft 404s
82- Duplicate content without canonicals
83 
84**Canonicalization**
85- All pages have canonical tags
86- Self-referencing canonicals on unique pages
87- HTTP → HTTPS canonicals
88- www vs. non-www consistency
89- Trailing slash consistency
90 
91### Site Speed & Core Web Vitals
92 
93**Core Web Vitals**
94- LCP (Largest Contentful Paint): < 2.5s
95- INP (Interaction to Next Paint): < 200ms
96- CLS (Cumulative Layout Shift): < 0.1
97 
98**Speed Factors**
99- Server response time (TTFB)
100- Image optimization
101- JavaScript execution
102- CSS delivery
103- Caching headers
104- CDN usage
105- Font loading
106 
107**Tools**
108- PageSpeed Insights
109- WebPageTest
110- Chrome DevTools
111- Search Console Core Web Vitals report
112 
113### Mobile-Friendliness
114 
115- Responsive design (not separate m. site)
116- Tap target sizes
117- Viewport configured
118- No horizontal scroll
119- Same content as desktop
120- Mobile-first indexing readiness
121 
122### Security & HTTPS
123 
124- HTTPS across entire site
125- Valid SSL certificate
126- No mixed content
127- HTTP → HTTPS redirects
128- HSTS header (bonus)
129 
130### URL Structure
131 
132- Readable, descriptive URLs
133- Keywords in URLs where natural
134- Consistent structure
135- No unnecessary parameters
136- Lowercase and hyphen-separated
137 
138---
139 
140## On-Page SEO Audit
141 
142### Title Tags
143 
144**Check for:**
145- Unique titles for each page
146- Primary keyword near beginning
147- 50-60 characters (visible in SERP)
148- Compelling and click-worthy
149- Brand name placement (end, usually)
150 
151**Common issues:**
152- Duplicate titles
153- Too long (truncated)
154- Too short (wasted opportunity)
155- Keyword stuffing
156- Missing entirely
157 
158### Meta Descriptions
159 
160**Check for:**
161- Unique descriptions per page
162- 150-160 characters
163- Includes primary keyword
164- Clear value proposition
165- Call to action
166 
167**Common issues:**
168- Duplicate descriptions
169- Auto-generated garbage
170- Too long/short
171- No compelling reason to click
172 
173### Heading Structure
174 
175**Check for:**
176- One H1 per page
177- H1 contains primary keyword
178- Logical hierarchy (H1 → H2 → H3)
179- Headings describe content
180- Not just for styling
181 
182**Common issues:**
183- Multiple H1s
184- Skip levels (H1 → H3)
185- Headings used for styling only
186- No H1 on page
187 
188### Content Optimization
189 
190**Primary Page Content**
191- Keyword in first 100 words
192- Related keywords naturally used
193- Sufficient depth/length for topic
194- Answers search intent
195- Better than competitors
196 
197**Thin Content Issues**
198- Pages with little unique content
199- Tag/category pages with no value
200- Doorway pages
201- Duplicate or near-duplicate content
202 
203### Image Optimization
204 
205**Check for:**
206- Descriptive file names
207- Alt text on all images
208- Alt text describes image
209- Compressed file sizes
210- Modern formats (WebP)
211- Lazy loading implemented
212- Responsive images
213 
214### Internal Linking
215 
216**Check for:**
217- Important pages well-linked
218- Descriptive anchor text
219- Logical link relationships
220- No broken internal links
221- Reasonable link count per page
222 
223**Common issues:**
224- Orphan pages (no internal links)
225- Over-optimized anchor text
226- Important pages buried
227- Excessive footer/sidebar links
228 
229### Keyword Targeting
230 
231**Per Page**
232- Clear primary keyword target
233- Title, H1, URL aligned
234- Content satisfies search intent
235- Not competing with other pages (cannibalization)
236 
237**Site-Wide**
238- Keyword mapping document
239- No major gaps in coverage
240- No keyword cannibalization
241- Logical topical clusters
242 
243---
244 
245## Content Quality Assessment
246 
247### E-E-A-T Signals
248 
249**Experience**
250- First-hand experience demonstrated
251- Original insights/data
252- Real examples and case studies
253 
254**Expertise**
255- Author credentials visible
256- Accurate, detailed information
257- Properly sourced claims
258 
259**Authoritativeness**
260- Recognized in the space
261- Cited by others
262- Industry credentials
263 
264**Trustworthiness**
265- Accurate information
266- Transparent about business
267- Contact information available
268- Privacy policy, terms
269- Secure site (HTTPS)
270 
271### Content Depth
272 
273- Comprehensive coverage of topic
274- Answers follow-up questions
275- Better than top-ranking competitors
276- Updated and current
277 
278### User Engagement Signals
279 
280- Time on page
281- Bounce rate in context
282- Pages per session
283- Return visits
284 
285---
286 
287## Common Issues by Site Type
288 
289### SaaS/Product Sites
290- Product pages lack content depth
291- Blog not integrated with product pages
292- Missing comparison/alternative pages
293- Feature pages thin on content
294- No glossary/educational content
295 
296### E-commerce
297- Thin category pages
298- Duplicate product descriptions
299- Missing product schema
300- Faceted navigation creating duplicates
301- Out-of-stock pages mishandled
302 
303### Content/Blog Sites
304- Outdated content not refreshed
305- Keyword cannibalization
306- No topical clustering
307- Poor internal linking
308- Missing author pages
309 
310### Local Business
311- Inconsistent NAP
312- Missing local schema
313- No Google Business Profile optimization
314- Missing location pages
315- No local content
316 
317---
318 
319## Output Format
320 
321### Audit Report Structure
322 
323**Executive Summary**
324- Overall health assessment
325- Top 3-5 priority issues
326- Quick wins identified
327 
328**Technical SEO Findings**
329For each issue:
330- **Issue**: What's wrong
331- **Impact**: SEO impact (High/Medium/Low)
332- **Evidence**: How you found it
333- **Fix**: Specific recommendation
334- **Priority**: 1-5 or High/Medium/Low
335 
336**On-Page SEO Findings**
337Same format as above
338 
339**Content Findings**
340Same format as above
341 
342**Prioritized Action Plan**
3431. Critical fixes (blocking indexation/ranking)
3442. High-impact improvements
3453. Quick wins (easy, immediate benefit)
3464. Long-term recommendations
347 
348---
349 
350## Tools Referenced
351 
352**Free Tools**
353- Google Search Console (essential)
354- Google PageSpeed Insights
355- Bing Webmaster Tools
356- Rich Results Test
357- Mobile-Friendly Test
358- Schema Validator
359 
360**Paid Tools** (if available)
361- Screaming Frog
362- Ahrefs / Semrush
363- Sitebulb
364- ContentKing
365 
366---
367 
368## Questions to Ask
369 
370If you need more context:
3711. What pages/keywords matter most?
3722. Do you have Search Console access?
3733. Any recent changes or migrations?
3744. Who are your top organic competitors?
3755. What's your current organic traffic baseline?
376 
377---
378 
379## Related Skills
380 
381- **programmatic-seo**: For building SEO pages at scale
382- **schema-markup**: For implementing structured data
383- **page-cro**: For optimizing pages for conversion (not just ranking)
384- **analytics-tracking**: For measuring SEO performance
385 

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