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
Check for product marketing context first:
If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Before auditing, understand:
Site Context
- What type of site? (SaaS, e-commerce, blog, etc.)
- What's the primary business goal for SEO?
- What keywords/topics are priorities?
Current State
- Any known issues or concerns?
- Current organic traffic level?
- Recent changes or migrations?
Scope
- Full site audit or specific pages?
- Technical + on-page, or one focus area?
- Access to Search Console / analytics?
Audit Framework
Priority Order
- Crawlability & Indexation (can Google find and index it?)
- Technical Foundations (is the site fast and functional?)
- On-Page Optimization (is content optimized?)
- Content Quality (does it deserve to rank?)
- 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
- Critical fixes (blocking indexation/ranking)
- High-impact improvements
- Quick wins (easy, immediate benefit)
- Long-term recommendations
References
- AI Writing Detection: Common AI writing patterns to avoid (em dashes, overused phrases, filler words)
- AEO & GEO Patterns: Content patterns optimized for answer engines and AI citation
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
Task-Specific Questions
- What pages/keywords matter most?
- Do you have Search Console access?
- Any recent changes or migrations?
- Who are your top organic competitors?
- What's your current organic traffic baseline?
Related Skills
- programmatic-seo — WHEN: user wants to build SEO pages at scale after the audit identifies keyword gaps. WHEN NOT: don't use for diagnosing existing issues; stay in seo-audit mode.
- ai-seo — WHEN: user wants to optimize for AI answer engines (SGE, Perplexity, ChatGPT) in addition to traditional search. WHEN NOT: don't use for purely technical crawl/indexation issues.
- schema-markup — WHEN: audit reveals missing structured data opportunities (FAQ, HowTo, Product, Review schemas). WHEN NOT: don't use as a standalone fix when core technical SEO is broken.
- site-architecture — WHEN: audit uncovers poor internal linking, orphan pages, or crawl depth issues that need a structural redesign. WHEN NOT: don't involve when the audit scope is limited to on-page or content issues.
- content-strategy — WHEN: audit reveals thin content, keyword gaps, or lack of topical authority requiring a content plan. WHEN NOT: don't use when the problem is purely technical (robots.txt, redirects, speed).
- marketing-context — WHEN: always read first if
.claude/product-marketing-context.md exists to avoid redundant questions. WHEN NOT: skip if no context file exists and user has provided all necessary product info directly.
Communication
All audit output follows the SEO Audit Quality Standard:
- Lead with the executive summary (3-5 bullets max)
- Findings use the Issue / Impact / Evidence / Fix / Priority format consistently
- Prioritized Action Plan is always the final deliverable section
- Avoid jargon without explanation; write for a technically-aware but non-SEO-specialist reader
- Quick wins are called out explicitly and kept separate from high-effort recommendations
- Never present recommendations without evidence or rationale
Proactive Triggers
Automatically surface seo-audit recommendations when:
- Traffic drop mentioned — User says organic traffic dropped or rankings fell; immediately frame an audit scope.
- Site migration or redesign — User mentions a planned or recent URL change, platform switch, or redesign; flag pre/post-migration audit needs.
- "Why isn't my page ranking?" — Any ranking frustration triggers the on-page + intent checklist before external factors.
- Content strategy discussion — When content-strategy skill is active and keyword gaps appear, proactively suggest an SEO audit to validate opportunity.
- New site or product launch — User preparing a launch; proactively recommend a technical SEO pre-launch checklist from the audit framework.
Output Artifacts
| Artifact |
Format |
Description |
| Executive Summary |
Markdown bullets |
3-5 top issues + quick wins, suitable for sharing with stakeholders |
| Technical SEO Findings |
Structured table |
Issue / Impact / Evidence / Fix / Priority per finding |
| On-Page SEO Findings |
Structured table |
Same format, focused on content and metadata |
| Prioritized Action Plan |
Numbered list |
Ordered by impact × effort, grouped into Critical / High / Quick Wins |
| Keyword Cannibalization Map |
Table |
Pages competing for same keyword with recommended canonical or redirect actions |
1---2name: seo-audit3description: 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.4license: MIT5metadata:6 source: https://skillmd.com/skills/realwigu/seo-audit7 version: 1.0.08 author: realwigu9 category: marketing10 updated: 2026-03-0611---1213# SEO Audit1415You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance.1617## Initial Assessment1819**Check for product marketing context first:**20If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.2122Before auditing, understand:23241. **Site Context**25 - What type of site? (SaaS, e-commerce, blog, etc.)26 - What's the primary business goal for SEO?27 - What keywords/topics are priorities?28292. **Current State**30 - Any known issues or concerns?31 - Current organic traffic level?32 - Recent changes or migrations?33343. **Scope**35 - Full site audit or specific pages?36 - Technical + on-page, or one focus area?37 - Access to Search Console / analytics?3839---4041## Audit Framework4243### Priority Order441. **Crawlability & Indexation** (can Google find and index it?)452. **Technical Foundations** (is the site fast and functional?)463. **On-Page Optimization** (is content optimized?)474. **Content Quality** (does it deserve to rank?)485. **Authority & Links** (does it have credibility?)4950---5152## Technical SEO Audit5354### Crawlability5556**Robots.txt**57- Check for unintentional blocks58- Verify important pages allowed59- Check sitemap reference6061**XML Sitemap**62- Exists and accessible63- Submitted to Search Console64- Contains only canonical, indexable URLs65- Updated regularly66- Proper formatting6768**Site Architecture**69- Important pages within 3 clicks of homepage70- Logical hierarchy71- Internal linking structure72- No orphan pages7374**Crawl Budget Issues** (for large sites)75- Parameterized URLs under control76- Faceted navigation handled properly77- Infinite scroll with pagination fallback78- Session IDs not in URLs7980### Indexation8182**Index Status**83- site:domain.com check84- Search Console coverage report85- Compare indexed vs. expected8687**Indexation Issues**88- Noindex tags on important pages89- Canonicals pointing wrong direction90- Redirect chains/loops91- Soft 404s92- Duplicate content without canonicals9394**Canonicalization**95- All pages have canonical tags96- Self-referencing canonicals on unique pages97- HTTP → HTTPS canonicals98- www vs. non-www consistency99- Trailing slash consistency100101### Site Speed & Core Web Vitals102103**Core Web Vitals**104- LCP (Largest Contentful Paint): < 2.5s105- INP (Interaction to Next Paint): < 200ms106- CLS (Cumulative Layout Shift): < 0.1107108**Speed Factors**109- Server response time (TTFB)110- Image optimization111- JavaScript execution112- CSS delivery113- Caching headers114- CDN usage115- Font loading116117**Tools**118- PageSpeed Insights119- WebPageTest120- Chrome DevTools121- Search Console Core Web Vitals report122123### Mobile-Friendliness124125- Responsive design (not separate m. site)126- Tap target sizes127- Viewport configured128- No horizontal scroll129- Same content as desktop130- Mobile-first indexing readiness131132### Security & HTTPS133134- HTTPS across entire site135- Valid SSL certificate136- No mixed content137- HTTP → HTTPS redirects138- HSTS header (bonus)139140### URL Structure141142- Readable, descriptive URLs143- Keywords in URLs where natural144- Consistent structure145- No unnecessary parameters146- Lowercase and hyphen-separated147148---149150## On-Page SEO Audit151152### Title Tags153154**Check for:**155- Unique titles for each page156- Primary keyword near beginning157- 50-60 characters (visible in SERP)158- Compelling and click-worthy159- Brand name placement (end, usually)160161**Common issues:**162- Duplicate titles163- Too long (truncated)164- Too short (wasted opportunity)165- Keyword stuffing166- Missing entirely167168### Meta Descriptions169170**Check for:**171- Unique descriptions per page172- 150-160 characters173- Includes primary keyword174- Clear value proposition175- Call to action176177**Common issues:**178- Duplicate descriptions179- Auto-generated garbage180- Too long/short181- No compelling reason to click182183### Heading Structure184185**Check for:**186- One H1 per page187- H1 contains primary keyword188- Logical hierarchy (H1 → H2 → H3)189- Headings describe content190- Not just for styling191192**Common issues:**193- Multiple H1s194- Skip levels (H1 → H3)195- Headings used for styling only196- No H1 on page197198### Content Optimization199200**Primary Page Content**201- Keyword in first 100 words202- Related keywords naturally used203- Sufficient depth/length for topic204- Answers search intent205- Better than competitors206207**Thin Content Issues**208- Pages with little unique content209- Tag/category pages with no value210- Doorway pages211- Duplicate or near-duplicate content212213### Image Optimization214215**Check for:**216- Descriptive file names217- Alt text on all images218- Alt text describes image219- Compressed file sizes220- Modern formats (WebP)221- Lazy loading implemented222- Responsive images223224### Internal Linking225226**Check for:**227- Important pages well-linked228- Descriptive anchor text229- Logical link relationships230- No broken internal links231- Reasonable link count per page232233**Common issues:**234- Orphan pages (no internal links)235- Over-optimized anchor text236- Important pages buried237- Excessive footer/sidebar links238239### Keyword Targeting240241**Per Page**242- Clear primary keyword target243- Title, H1, URL aligned244- Content satisfies search intent245- Not competing with other pages (cannibalization)246247**Site-Wide**248- Keyword mapping document249- No major gaps in coverage250- No keyword cannibalization251- Logical topical clusters252253---254255## Content Quality Assessment256257### E-E-A-T Signals258259**Experience**260- First-hand experience demonstrated261- Original insights/data262- Real examples and case studies263264**Expertise**265- Author credentials visible266- Accurate, detailed information267- Properly sourced claims268269**Authoritativeness**270- Recognized in the space271- Cited by others272- Industry credentials273274**Trustworthiness**275- Accurate information276- Transparent about business277- Contact information available278- Privacy policy, terms279- Secure site (HTTPS)280281### Content Depth282283- Comprehensive coverage of topic284- Answers follow-up questions285- Better than top-ranking competitors286- Updated and current287288### User Engagement Signals289290- Time on page291- Bounce rate in context292- Pages per session293- Return visits294295---296297## Common Issues by Site Type298299### SaaS/Product Sites300- Product pages lack content depth301- Blog not integrated with product pages302- Missing comparison/alternative pages303- Feature pages thin on content304- No glossary/educational content305306### E-commerce307- Thin category pages308- Duplicate product descriptions309- Missing product schema310- Faceted navigation creating duplicates311- Out-of-stock pages mishandled312313### Content/Blog Sites314- Outdated content not refreshed315- Keyword cannibalization316- No topical clustering317- Poor internal linking318- Missing author pages319320### Local Business321- Inconsistent NAP322- Missing local schema323- No Google Business Profile optimization324- Missing location pages325- No local content326327---328329## Output Format330331### Audit Report Structure332333**Executive Summary**334- Overall health assessment335- Top 3-5 priority issues336- Quick wins identified337338**Technical SEO Findings**339For each issue:340- **Issue**: What's wrong341- **Impact**: SEO impact (High/Medium/Low)342- **Evidence**: How you found it343- **Fix**: Specific recommendation344- **Priority**: 1-5 or High/Medium/Low345346**On-Page SEO Findings**347Same format as above348349**Content Findings**350Same format as above351352**Prioritized Action Plan**3531. Critical fixes (blocking indexation/ranking)3542. High-impact improvements3553. Quick wins (easy, immediate benefit)3564. Long-term recommendations357358---359360## References361362- [AI Writing Detection](references/ai-writing-detection.md): Common AI writing patterns to avoid (em dashes, overused phrases, filler words)363- [AEO & GEO Patterns](references/aeo-geo-patterns.md): Content patterns optimized for answer engines and AI citation364365---366367## Tools Referenced368369**Free Tools**370- Google Search Console (essential)371- Google PageSpeed Insights372- Bing Webmaster Tools373- Rich Results Test374- Mobile-Friendly Test375- Schema Validator376377**Paid Tools** (if available)378- Screaming Frog379- Ahrefs / Semrush380- Sitebulb381- ContentKing382383---384385## Task-Specific Questions3863871. What pages/keywords matter most?3882. Do you have Search Console access?3893. Any recent changes or migrations?3904. Who are your top organic competitors?3915. What's your current organic traffic baseline?392393---394395## Related Skills396397- **programmatic-seo** — WHEN: user wants to build SEO pages at scale after the audit identifies keyword gaps. WHEN NOT: don't use for diagnosing existing issues; stay in seo-audit mode.398- **ai-seo** — WHEN: user wants to optimize for AI answer engines (SGE, Perplexity, ChatGPT) in addition to traditional search. WHEN NOT: don't use for purely technical crawl/indexation issues.399- **schema-markup** — WHEN: audit reveals missing structured data opportunities (FAQ, HowTo, Product, Review schemas). WHEN NOT: don't use as a standalone fix when core technical SEO is broken.400- **site-architecture** — WHEN: audit uncovers poor internal linking, orphan pages, or crawl depth issues that need a structural redesign. WHEN NOT: don't involve when the audit scope is limited to on-page or content issues.401- **content-strategy** — WHEN: audit reveals thin content, keyword gaps, or lack of topical authority requiring a content plan. WHEN NOT: don't use when the problem is purely technical (robots.txt, redirects, speed).402- **marketing-context** — WHEN: always read first if `.claude/product-marketing-context.md` exists to avoid redundant questions. WHEN NOT: skip if no context file exists and user has provided all necessary product info directly.403404---405406## Communication407408All audit output follows the **SEO Audit Quality Standard**:409- Lead with the executive summary (3-5 bullets max)410- Findings use the Issue / Impact / Evidence / Fix / Priority format consistently411- Prioritized Action Plan is always the final deliverable section412- Avoid jargon without explanation; write for a technically-aware but non-SEO-specialist reader413- Quick wins are called out explicitly and kept separate from high-effort recommendations414- Never present recommendations without evidence or rationale415416---417418## Proactive Triggers419420Automatically surface seo-audit recommendations when:4214221. **Traffic drop mentioned** — User says organic traffic dropped or rankings fell; immediately frame an audit scope.4232. **Site migration or redesign** — User mentions a planned or recent URL change, platform switch, or redesign; flag pre/post-migration audit needs.4243. **"Why isn't my page ranking?"** — Any ranking frustration triggers the on-page + intent checklist before external factors.4254. **Content strategy discussion** — When content-strategy skill is active and keyword gaps appear, proactively suggest an SEO audit to validate opportunity.4265. **New site or product launch** — User preparing a launch; proactively recommend a technical SEO pre-launch checklist from the audit framework.427428---429430## Output Artifacts431432| Artifact | Format | Description |433|----------|--------|-------------|434| Executive Summary | Markdown bullets | 3-5 top issues + quick wins, suitable for sharing with stakeholders |435| Technical SEO Findings | Structured table | Issue / Impact / Evidence / Fix / Priority per finding |436| On-Page SEO Findings | Structured table | Same format, focused on content and metadata |437| Prioritized Action Plan | Numbered list | Ordered by impact × effort, grouped into Critical / High / Quick Wins |438| Keyword Cannibalization Map | Table | Pages competing for same keyword with recommended canonical or redirect actions |