Back to Skills
    🦞

    seo-audit

    When the user wants to audit, review

    By @jchopard69
    View on GitHub
    SKILL.md
    ---
    name: seo-audit
    description: 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.
    ---
    
    # 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?
    
    ---
    
    ## Related Skills
    
    - **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