$npx -y skills add mysticaltech/marketingskills --skill seo-auditWhen 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
| 1 | # SEO Audit |
| 2 | |
| 3 | You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance. |
| 4 | |
| 5 | ## Initial Assessment |
| 6 | |
| 7 | **Check for product marketing context first:** |
| 8 | 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. |
| 9 | |
| 10 | Before auditing, understand: |
| 11 | |
| 12 | 1. **Site Context** |
| 13 | - What type of site? (SaaS, e-commerce, blog, etc.) |
| 14 | - What's the primary business goal for SEO? |
| 15 | - What keywords/topics are priorities? |
| 16 | |
| 17 | 2. **Current State** |
| 18 | - Any known issues or concerns? |
| 19 | - Current organic traffic level? |
| 20 | - Recent changes or migrations? |
| 21 | |
| 22 | 3. **Scope** |
| 23 | - Full site audit or specific pages? |
| 24 | - Technical + on-page, or one focus area? |
| 25 | - Access to Search Console / analytics? |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Audit Framework |
| 30 | |
| 31 | ### Priority Order |
| 32 | 1. **Crawlability & Indexation** (can Google find and index it?) |
| 33 | 2. **Technical Foundations** (is the site fast and functional?) |
| 34 | 3. **On-Page Optimization** (is content optimized?) |
| 35 | 4. **Content Quality** (does it deserve to rank?) |
| 36 | 5. **Authority & Links** (does it have credibility?) |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## Technical SEO Audit |
| 41 | |
| 42 | ### Crawlability |
| 43 | |
| 44 | **Robots.txt** |
| 45 | - Check for unintentional blocks |
| 46 | - Verify important pages allowed |
| 47 | - Check sitemap reference |
| 48 | |
| 49 | **XML Sitemap** |
| 50 | - Exists and accessible |
| 51 | - Submitted to Search Console |
| 52 | - Contains only canonical, indexable URLs |
| 53 | - Updated regularly |
| 54 | - Proper formatting |
| 55 | |
| 56 | **Site Architecture** |
| 57 | - Important pages within 3 clicks of homepage |
| 58 | - Logical hierarchy |
| 59 | - Internal linking structure |
| 60 | - No orphan pages |
| 61 | |
| 62 | **Crawl Budget Issues** (for large sites) |
| 63 | - Parameterized URLs under control |
| 64 | - Faceted navigation handled properly |
| 65 | - Infinite scroll with pagination fallback |
| 66 | - Session IDs not in URLs |
| 67 | |
| 68 | ### Indexation |
| 69 | |
| 70 | **Index Status** |
| 71 | - site:domain.com check |
| 72 | - Search Console coverage report |
| 73 | - Compare indexed vs. expected |
| 74 | |
| 75 | **Indexation Issues** |
| 76 | - Noindex tags on important pages |
| 77 | - Canonicals pointing wrong direction |
| 78 | - Redirect chains/loops |
| 79 | - Soft 404s |
| 80 | - Duplicate content without canonicals |
| 81 | |
| 82 | **Canonicalization** |
| 83 | - All pages have canonical tags |
| 84 | - Self-referencing canonicals on unique pages |
| 85 | - HTTP → HTTPS canonicals |
| 86 | - www vs. non-www consistency |
| 87 | - Trailing slash consistency |
| 88 | |
| 89 | ### Site Speed & Core Web Vitals |
| 90 | |
| 91 | **Core Web Vitals** |
| 92 | - LCP (Largest Contentful Paint): < 2.5s |
| 93 | - INP (Interaction to Next Paint): < 200ms |
| 94 | - CLS (Cumulative Layout Shift): < 0.1 |
| 95 | |
| 96 | **Speed Factors** |
| 97 | - Server response time (TTFB) |
| 98 | - Image optimization |
| 99 | - JavaScript execution |
| 100 | - CSS delivery |
| 101 | - Caching headers |
| 102 | - CDN usage |
| 103 | - Font loading |
| 104 | |
| 105 | **Tools** |
| 106 | - PageSpeed Insights |
| 107 | - WebPageTest |
| 108 | - Chrome DevTools |
| 109 | - Search Console Core Web Vitals report |
| 110 | |
| 111 | ### Mobile-Friendliness |
| 112 | |
| 113 | - Responsive design (not separate m. site) |
| 114 | - Tap target sizes |
| 115 | - Viewport configured |
| 116 | - No horizontal scroll |
| 117 | - Same content as desktop |
| 118 | - Mobile-first indexing readiness |
| 119 | |
| 120 | ### Security & HTTPS |
| 121 | |
| 122 | - HTTPS across entire site |
| 123 | - Valid SSL certificate |
| 124 | - No mixed content |
| 125 | - HTTP → HTTPS redirects |
| 126 | - HSTS header (bonus) |
| 127 | |
| 128 | ### URL Structure |
| 129 | |
| 130 | - Readable, descriptive URLs |
| 131 | - Keywords in URLs where natural |
| 132 | - Consistent structure |
| 133 | - No unnecessary parameters |
| 134 | - Lowercase and hyphen-separated |
| 135 | |
| 136 | --- |
| 137 | |
| 138 | ## On-Page SEO Audit |
| 139 | |
| 140 | ### Title Tags |
| 141 | |
| 142 | **Check for:** |
| 143 | - Unique titles for each page |
| 144 | - Primary keyword near beginning |
| 145 | - 50-60 characters (visible in SERP) |
| 146 | - Compelling and click-worthy |
| 147 | - Brand name placement (end, usually) |
| 148 | |
| 149 | **Common issues:** |
| 150 | - Duplicate titles |
| 151 | - Too long (truncated) |
| 152 | - Too short (wasted opportunity) |
| 153 | - Keyword stuffing |
| 154 | - Missing entirely |
| 155 | |
| 156 | ### Meta Descriptions |
| 157 | |
| 158 | **Check for:** |
| 159 | - Unique descriptions per page |
| 160 | - 150-160 characters |
| 161 | - Includes primary keyword |
| 162 | - Clear value proposition |
| 163 | - Call to action |
| 164 | |
| 165 | **Common issues:** |
| 166 | - Duplicate descriptions |
| 167 | - Auto-generated garbage |
| 168 | - Too long/short |
| 169 | - No compelling reason to click |
| 170 | |
| 171 | ### Heading Structure |
| 172 | |
| 173 | **Check for:** |
| 174 | - One H1 per page |
| 175 | - H1 contains primary keyword |
| 176 | - Logical hierarchy (H1 → H2 → H3) |
| 177 | - Headings describe content |
| 178 | - Not just for styling |
| 179 | |
| 180 | **Common issues:** |
| 181 | - Multiple H1s |
| 182 | - Skip levels (H1 → H3) |
| 183 | - Headings used for styling only |
| 184 | - No H1 on page |
| 185 | |
| 186 | ### Content Optimization |
| 187 | |
| 188 | **Primary Page Content** |
| 189 | - Keyword in first 100 words |
| 190 | - Related keywords naturally used |
| 191 | - Sufficient depth/length for topic |
| 192 | - Answers search intent |
| 193 | - Better than competitors |
| 194 | |
| 195 | **Thin Content Issues** |
| 196 | - Pages with little unique content |
| 197 | - Tag/category pages with no value |
| 198 | - Doorway pages |
| 199 | - Duplicate or near-duplicate content |
| 200 | |
| 201 | ### Image Optimization |
| 202 | |
| 203 | **Check for:** |
| 204 | - Descriptive file names |
| 205 | - Alt text on all i |