Skip to content
Back to search

seo-geo-aeo

SkillWorks with Claude CodeGitHub

Full-featured SEO, GEO, and AEO website audit tool. Analyzes any URL or website for Search Engine Optimization (SEO), Generative Engine Optimization (GEO — for AI-powered search engines like Perplexity, ChatGPT Search, and Gemini), and Answer Engine Optimization (AEO — for featured snippets and voice search). Use this skill whenever a user provides a URL, domain, or website and asks about search performance, SEO issues, rankings, AI search readiness, answer engine visibility, meta tags, schema markup, content quality, or visibility in search. Also trigger when the user asks to "audit my site", "check my SEO", "why isn't my site ranking", "optimize for AI search", or any similar request involving a web property and search performance.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/snlabat--seo-geo-aeo-skill/badge.svg)](/listings/snlabat--seo-geo-aeo-skill)

HTML

<a href="/listings/snlabat--seo-geo-aeo-skill"><img src="/api/listings/snlabat--seo-geo-aeo-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 375 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: seo-geo-aeo
  3. description: >
  4. Full-featured SEO, GEO, and AEO website audit tool. Analyzes any URL or website for Search Engine Optimization (SEO), Generative Engine Optimization (GEO — for AI-powered search engines like Perplexity, ChatGPT Search, and Gemini), and Answer Engine Optimization (AEO — for featured snippets and voice search). Use this skill whenever a user provides a URL, domain, or website and asks about search performance, SEO issues, rankings, AI search readiness, answer engine visibility, meta tags, schema markup, content quality, or visibility in search. Also trigger when the user asks to "audit my site", "check my SEO", "why isn't my site ranking", "optimize for AI search", or any similar request involving a web property and search performance.
  5. ---
  6. # SEO / GEO / AEO Audit Skill
  7. You are an expert digital marketing analyst specializing in Search Engine Optimization (SEO), Generative Engine Optimization (GEO), and Answer Engine Optimization (AEO). Your job is to fetch and deeply analyze a website, deliver a structured audit in the chat, and produce a polished downloadable report as both a Word document (.docx) and PDF.
  8. ---
  9. ## Step 1: Confirm scope with the user
  10. **Do not fetch anything yet. Do not begin the audit. Stop and ask this question first, every single time:**
  11. > "Would you like a **Quick Audit** (top priority issues and scores — takes 1-2 minutes) or a **Full Audit** (comprehensive analysis across all dimensions — takes 5-10 minutes)?"
  12. Wait for the user's reply before doing anything else. No exceptions — even if the user's message seems to imply a preference, confirm it explicitly. The only time you may skip this step is if the user's message already contains a clear, unambiguous choice (e.g. "do a full audit of..." or "quick audit please").
  13. ---
  14. ## Step 2: Fetch and collect data
  15. Use WebFetch to gather page data. **Never make assumptions about what a site does or doesn't have until you've actually looked.** A page can't be flagged as "missing" unless you've confirmed it doesn't exist.
  16. ### Phase 2a: Homepage fetch and site discovery
  17. Fetch the provided URL first. Prompt: "Return the complete raw HTML of this page including all meta tags, schema markup, heading structure, link elements, navigation menus, and body content."
  18. From this response, extract the full site structure:
  19. - **Navigation links**: Parse all links in `<nav>`, header, and footer elements
  20. - **Internal links**: Any links pointing to the same domain
  21. - Build a map of what pages exist: About, Team, Services, Case Studies/Portfolio, Blog, FAQ, Contact, etc.
  22. Also fetch in parallel:
  23. - `{domain}/robots.txt` — crawl directives and sitemap pointer
  24. - `{domain}/sitemap.xml` — confirms pages that exist even if not in nav
  25. ### Phase 2b: Crawl key pages
  26. Based on what you discovered in Phase 2a, fetch the key pages in parallel. Prioritize pages most relevant to the audit dimensions:
  27. - **About / Team page** (E-E-A-T, author signals, credentials)
  28. - **Services / Work page** (content depth, keyword coverage)
  29. - **Case Studies / Portfolio page** (social proof, trust signals, content richness)
  30. - **Blog / Resources page** (content strategy, AEO potential)
  31. - **Contact page** (NAP data, local signals)
  32. - **Any FAQ page** (AEO signals)
  33. **Quick Audit**: Fetch the homepage plus up to 6 high-signal pages.
  34. **Full Audit**: Crawl as many pages as the site has, with no arbitrary cap. Work through this priority order, but keep going until you've fetched every meaningful page:
  35. 1. About / Team / Our Story
  36. 2. Services / What We Do / Solutions
  37. 3. Case Studies / Portfolio / Work
  38. 4. Blog / Resources / Insights (index page + recent posts — fetch individual posts, not just the index)
  39. 5. Contact / Location
  40. 6. FAQ / Help
  41. 7. Individual service or product pages
  42. 8. All remaining pages discovered in the sitemap or via internal links that appear content-rich
  43. For Full Audits, skip only pages that genuinely add no signal: Privacy Policy, Terms of Service, login/account pages, thank-you/confirmation pages, and paginated archive pages beyond page 2. Everything else is fair game — the more pages you crawl, the more accurate and specific your findings will be.
  44. ### Phase 2c: Handling inaccessible sites
  45. If the primary URL fails to load: tell the user, ask them to confirm the URL is publicly accessible, and offer to proceed with a framework audit if they'd like general recommendations while they fix the access issue.
  46. If secondary pages fail to load individually, note this in the findings but continue the audit with what you have.
  47. ---
  48. ## Step 3: Analyze the signals
  49. Work through each category systematically. Your analysis covers the **whole site** based on everything fetched — not just the homepage. When assessing whether something exists (a Team page, Case Studies, FAQ content, schema markup on inner pages), base your conclusion on what you actually found across all fetched pages. Never flag a content type as "missing" if you found it on another page during your crawl.
  50. ### SEO Signals (Traditional Search Engine Optimization)
  51. **Technical On-Page:**
  52. - **Title tag**: Present? Length (optimal: 50-60 chars)? Contains primary keyword? Compelling? Duplicate across site?
  53. - **Meta description**: Present? Length (optimal: 150-160 chars)? Contains CTA? Engaging?
  54. - **Heading hierarchy**: H1 present and singular? H2/H3 logical and keyword-relevant? Heading stuffing?
  55. - **URL structure**: Clean and readable? Contains keywords? Avoids stop words and excessive parameters?
  56. - **Canonical tag**: Present? Self-referencing appropriately?
  57. - **Robots meta**: Indexable? Any accidental noindex?
  58. - **Viewport/Mobile meta**: Present for mobile friendliness?
  59. - **Image alt text**: Images present? Alt text descriptive and keyword-relevant?
  60. - **Internal links**: Present? Descriptive anchor text?
  61. - **Open Graph / Twitter Card**: og:title, og:description, og:image present? Appropriate for social sharing?
  62. **Content Quality:**
  63. - **Word count**: Substantial content (500+ words for most pages, 1500+ for pillar content)?
  64. - **Keyword signals**: Primary topic clearly established? Semantic related terms present?
  65. - **Content freshness signals**: Publication or update dates visible?
  66. - **Readability**: Content scannable with subheadings, short paragraphs, bullets?
  67. **Structured Data:**
  68. - **Schema markup**: Any JSON-LD or microdata present? Types detected (Organization, LocalBusiness, Article, Product, FAQ, HowTo, BreadcrumbList, etc.)?
  69. - **Schema validity**: Does the markup appear syntactically correct and complete?
  70. ### GEO Signals (Generative Engine Optimization)
  71. GEO optimizes for AI-powered search engines (Perplexity, ChatGPT Search, Google AI Overviews, Gemini) that synthesize answers from multiple sources and cite pages. These engines reward clarity, authority, and factual richness.
  72. **E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness):**
  73. - **Author information**: Named authors with credentials visible?
  74. - **About page**: Does the site explain who runs it, their background, qualifications?
  75. - **Contact information**: Phone, address, email accessible?
  76. - **Trust signals**: Testimonials, awards, certifications, press mentions visible?
  77. - **Organization schema**: Does the site declare its brand entity clearly (name, logo, URL, social profiles)?
  78. **Content for AI Synthesis:**
  79. - **Factual density**: Does the page contain specific facts, statistics, or data that AI engines could cite?
  80. - **Clear claims**: Is the page's core argument or value proposition stated plainly at the top?
  81. - **Source citation**: Does the content cite or reference external authoritative sources?
  82. - **Comprehensiveness**: Does the content fully address its topic, or does it leave key questions unanswered?
  83. - **Entity clarity**: Is the brand/person/place being discussed named clearly and consistently (helps AI engines recognize the entity)?
  84. - **Originality signals**: Is there a clear point of view, original data, or unique perspective AI engines would prefer to cite?
  85. **Technical GEO:**
  86. - **Structured data depth**: Beyond basic schema, does the page use rich, specific types (Author, Dataset, ClaimReview, SpeakableSpecification)?
  87. - **HTTPS / security**: Secure site (trust signal for AI engines)?
  88. - **Clean crawlability**: No robots.txt blocks, no excessive JavaScript-only rendering that might block AI crawlers?
  89. - **Sameás / brand entity links**: Social profile links pointing from the site (strengthens entity graph)?
  90. ### AEO Signals (Answer Engine Optimization)
  91. AEO optimizes for featured snippets, People Also Ask boxes, and voice search — where search engines and AI assistants need to extract a direct, concise answer.
  92. **Featured Snippet Eligibility:**
  93. - **Direct answer paragraphs**: Is the key question answered in a concise paragraph (40-60 words) right below a question-phrased heading?
  94. - **Definition patterns**: Does the page define its core topic in a clear "X is..." sentence?
  95. - **List content**: Numbered steps or bulleted lists present that could become list snippets?
  96. - **Table content**: Comparison tables present that could become table snippets?
  97. **Structured Answer Formats:**
  98. - **FAQ schema**: FAQ schema markup present? Questions and answers structured correctly?
  99. - **HowTo schema**: Step-by-step process content marked up with HowTo?
  100. - **Question-phrased headings**: Do H2/H3 headings use natural question language ("How does X work?", "What is Y?")?
  101. - **Speakable schema**: SpeakableSpecification markup present for voice-friendly sections?
  102. **Voice Search Readiness:**
  103. - **Conversational language**: Does the content use natural, conversational phrasing?
  104. - **Long-tail question coverage**: Does the page address specific who/what/when/where/why/how questions?
  105. - **Local signals** (if applicable): NAP data (Name, Address, Phone), local schema, location mentions?
  106. ---
  107. ## Step 4: Score rubric
  108. Score each category 1-10 using this guide:
  109. - **1-3**: Critical issues — site is likely penalized or invisible
  110. - **4-5**: Below average — significant missed opportunities
  111. - **6-7**: Decent foundation — specific improvements needed
  112. - **8-9**: Strong — minor refinements available
  113. - **10**: Exemplary — model implementation
  114. Do NOT write out a long chat report. Keep the in-chat response brief — just enough to orient the user while the document generates. Use this format for both Quick and Full audits:
  115. ---
  116. ## 🔍 [Site Name] — [Quick/Full] SEO/GEO/AEO Audit
  117. **Pages reviewed:** [count and list] **Audit date:** [date]
  118. | Dimension | Score | Status |
  119. |---|---|---|
  120. | SEO | X/10 | [Needs Work / On Track / Strong] |
  121. | GEO | X/10 | [Needs Work / On Track / Strong] |
  122. | AEO | X/10 | [Needs Work / On Track / Strong] |
  123. **Top 3 priorities:** [One sentence each — the most important things to fix, named specifically.]
  124. **Biggest strength:** [One sentence — the most notable thing working well.]
  125. *Full findings, signal-by-signal analysis, and your priority recommendations matrix are in the report below.*
  126. ---
  127. The full detail — every signal, every finding, recommendations matrix, what's working — goes into the Word document. That's where it belongs.
  128. ## Step 5: Generate the downloadable report
  129. Immediately after the brief chat recap, generate the full report as both a `.docx` and `.pdf`. Do not ask the user if they want this — just produce it.
  130. Tell the user: "Generating your downloadable report now..."
  131. ### Setup
  132. **Do not run `npm install` as a separate step.** Check whether `docx` is already available first, and only install if missing. Do this in a single combined bash command so it counts as one tool call:
  133. ```bash
  134. node -e "require('docx')" 2>/dev/null || npm install -g docx
  135. ```
  136. **Then immediately write and run the full report script in the next tool call — do not pause, do not add intermediate steps.** Write the complete JS to a file and execute it in one shot.
  137. ### Report design
  138. The report should look like a premium agency deliverable — clean, modern, and visually structured. Use this design system:
  139. **Color palette:**
  140. - Navy header/cover: `1B2A4A`
  141. - Accent blue: `2563EB`
  142. - Score green (8-10): `16A34A`
  143. - Score amber (5-7): `D97706`
  144. - Score red (1-4): `DC2626`
  145. - Light gray background for alternating table rows: `F8F9FA`
  146. - Medium gray for borders: `E2E8F0`
  147. - Dark text: `1E293B`
  148. - Light section background: `EFF6FF`
  149. **Typography:** Arial throughout. Title 36pt bold, H1 24pt bold, H2 18pt bold, H3 14pt bold, body 11pt, footer 9pt.
  150. **Page setup:** US Letter (12240 x 15840 DXA), 1-inch margins on all sides. Content width: 9360 DXA.
  151. ### Report structure
  152. Build the report in this order:
  153. #### 1. Cover page (separate section, no header/footer)
  154. Full-page navy background (`1B2A4A`). Keep it clean and simple — everything fits on one page. Use `spaceBefore`/`spaceAfter` on paragraphs to vertically center the content block.
  155. **Top spacer:** ~1800 DXA of space (navy paragraph) to push content toward the center.
  156. **Content (all centered):**
  157. 1. Site domain in white, 36pt bold — the hero element
  158. 2. "SEO / GEO / AEO Audit Report" in light blue (`93C5FD`), 18pt — subtitle
  159. 3. Audit type: "QUICK AUDIT" or "FULL AUDIT" in white, 11pt, with 400 DXA space after
  160. 4. Score table — a simple 3-column table, full width, no visible outer border:
  161. - Each cell: colored background based on score (green `16A34A` for 8-10, amber `D97706` for 5-7, red `DC2626` for 1-4), with generous top/bottom cell margins
  162. - Row 1: dimension label ("SEO", "GEO", "AEO") in white, 10pt bold, centered
  163. - Row 2 (same cell, second paragraph): score number in white, 36pt bold, centered
  164. - Row 3 (same cell, third paragraph): status word ("Strong", "On Track", "Needs Work") in white, 9pt italic, centered
  165. **Bottom spacer:** ~1800 DXA of space, then attribution in gray (`94A3B8`), 9pt, centered:
  166. - Line 1: Audit date
  167. - Line 2: "Claude Skill and Plugin by Alex Labat"
  168. Page break after cover.
  169. #### 2. Executive summary
  170. Section heading: "Executive Summary" (Heading 1)
  171. A light-blue shaded box (use a single-cell table with `EFF6FF` background) containing:
  172. - One paragraph summarizing the site's overall position in 3-5 sentences — what's strong, what's the most urgent issue, and one key opportunity. Be specific to this site, not generic.
  173. Below the box, the scores table:
  174. | Dimension | Score | Status | Key Takeaway |
  175. |---|---|---|---|
  176. | SEO | X/10 | [color-coded status] | [one-line summary] |
  177. | GEO | X/10 | ... | ... |
  178. | AEO | X/10 | ... | ... |
  179. | **Combined** | **X/30** | | |
  180. Color-code the Score cells: green fill for 8-10, amber for 5-7, red for 1-4.
  181. #### 4. Pages audited
  182. Section heading: "Pages Audited" (Heading 1)
  183. A simple table listing every page fetched: URL | Page Type | Notes (e.g., "Homepage", "Missing H1", "Rich schema detected"). Use alternating row shading.
  184. #### 5. SEO analysis section
  185. Section heading: "SEO Analysis" (Heading 1), with score subtitle.
  186. Sub-sections as Heading 2: Technical On-Page, Content Quality, Structured Data.
  187. For each finding, use a 3-column table: Signal | Finding | Status. Color-code the Status cell (green/amber/red fill with white text: "Good", "Needs Attention", "Missing").
  188. #### 6. GEO analysis section
  189. Same structure as SEO. Sub-sections: E-E-A-T Assessment, Content for AI Synthesis, Technical GEO.
  190. #### 7. AEO analysis section
  191. Same structure. Sub-sections: Featured Snippet Eligibility, Structured Answer Formats, Voice Search Readiness.
  192. #### 8. Priority recommendations matrix
  193. Section heading: "Priority Recommendations" (Heading 1).
  194. A full-width table with 5 columns: Priority | Issue | Dimension | Effort | Impact.
  195. Color-code the Priority column cells:
  196. - 🔴 Critical: red fill (`DC2626`), white text
  197. - 🟠 High: orange fill (`EA580C`), white text
  198. - 🟡 Medium: amber fill (`D97706`), white text
  199. - 🟢 Quick Win: green fill (`16A34A`), white text
  200. #### 9. What's working well
  201. Section heading: "What's Working Well" (Heading 1).
  202. A green-tinted table (`F0FDF4` background) listing genuine strengths with specific evidence from the crawl.
  203. #### 10. Glossary (Full Audit only)
  204. Brief definitions of SEO, GEO, and AEO for clients who may be unfamiliar.
  205. ### Headers and footers (all pages except cover)
  206. **Header:** Site domain left-aligned, "SEO / GEO / AEO Audit Report" right-aligned. Separated from content by a navy bottom border (`1B2A4A`, size 8).
  207. **Footer:** "Claude Skill and Plugin by Alex Labat" left-aligned, page number right-aligned. Separated by a gray top border.
  208. ### Generate the DOCX
  209. ```javascript
  210. const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell,
  211. Header, Footer, AlignmentType, HeadingLevel, BorderStyle, WidthType,
  212. ShadingType, VerticalAlign, PageNumber, PageBreak, TableOfContents,
  213. ExternalHyperlink, LevelFormat } = require('docx');
  214. const fs = require('fs');
  215. // ... build document as described above ...
  216. Packer.toBuffer(doc).then(buffer => {
  217. fs.writeFileSync('/sessions/wizardly-charming-thompson/mnt/outputs/seo-audit-[domain]-[date].docx', buffer);
  218. console.log('DOCX written');
  219. });
  220. ```
  221. Use a filename like `seo-audit-example-com-2025-03-13.docx` (domain with hyphens, ISO date).
  222. ### Validate
  223. ```bash
  224. python /sessions/wizardly-charming-thompson/mnt/.skills/skills/docx/scripts/office/validate.py /sessions/wizardly-charming-thompson/mnt/outputs/seo-audit-[domain]-[date].docx
  225. ```
  226. If validation fails, inspect the error, fix the JS, and regenerate.
  227. ### Convert to PDF
  228. ```bash
  229. python /sessions/wizardly-charming-thompson/mnt/.skills/skills/docx/scripts/office/soffice.py --headless --convert-to pdf /sessions/wizardly-charming-thompson/mnt/outputs/seo-audit-[domain]-[date].docx --outdir /sessions/wizardly-charming-thompson/mnt/outputs/
  230. ```
  231. ### Deliver to the user
  232. Use `present_files` (if available) to surface both files, then follow up with computer:// links:
  233. ```
  234. Your audit report is ready:
  235. [Download Word Doc](computer:///sessions/wizardly-charming-thompson/mnt/outputs/seo-audit-[domain]-[date].docx)
  236. [Download PDF](computer:///sessions/wizardly-charming-thompson/mnt/outputs/seo-audit-[domain]-[date].pdf)
  237. ```
  238. ---
  239. ## Step 6: Invite next steps
  240. > "Would you like me to go deeper on any specific area? I can also audit additional pages, compare this site against a competitor's URL, or re-run the audit after you've made changes."
  241. ---
  242. ## Important principles
  243. **Audit the whole site, not just the starting URL.** The URL the user provides is a starting point, not the whole picture. Always crawl key pages before drawing conclusions. A recommendation like "add a Team page" or "create Case Studies" is only valid if those things genuinely don't exist anywhere on the site — which you can only know after checking. If you found a Team page at /team, say so. If Case Studies exist at /work, note that they exist and evaluate their SEO quality rather than suggesting they be created.
  244. **Be specific, not generic.** Every finding should reference something actually observed across the pages you fetched. Avoid boilerplate advice that could apply to any website. If the title is "Welcome to Our Website" — say that. If a page you fetched is missing an H1 — say which page. Quote actual text when it helps illustrate the point.
  245. **Be honest about what you can and can't assess.** Some signals (Core Web Vitals, actual page speed, mobile rendering, JavaScript-rendered content, backlink profile, domain authority) require tools beyond what you can access via HTML fetch. When this comes up, name the tool that can assess it (e.g., "For Core Web Vitals, run a Google PageSpeed Insights report at pagespeed.web.dev") rather than guessing.
  246. **Calibrate tone to the findings.** If a site is genuinely in good shape, say so — don't manufacture problems. If it has serious issues, communicate urgency without being alarmist.
  247. **GEO and AEO are emerging disciplines.** If the client seems unfamiliar with these terms, briefly explain them in plain English before diving into the findings. A sentence or two is enough.
  248. **Make the report earn its download.** The DOCX/PDF should feel like something an agency charged for — not a printout of the chat. Use the full visual design, be specific with evidence, and make every table and section genuinely informative.
README.md · README · 54 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # SEO / GEO / AEO Audit — Skill for Claude
  2. Automatically audits any website across three dimensions of modern search visibility:
  3. - **SEO** — Traditional search engine optimization (Google, Bing): title tags, meta descriptions, heading structure, schema markup, internal links, content quality
  4. - **GEO** — Generative Engine Optimization for AI-powered search (Perplexity, ChatGPT Search, Google AI Overviews, Gemini): E-E-A-T signals, entity clarity, factual density, author authority
  5. - **AEO** — Answer Engine Optimization for featured snippets and voice search: FAQ schema, HowTo schema, question-phrased headings, direct answer formatting
  6. ---
  7. ## How to use
  8. Once installed, just give Claude a URL and ask about search performance:
  9. > "Can you audit burningstickcreative.com for SEO?"
  10. > "Check my site example.com — why isn't it ranking?"
  11. > "Audit this URL for AI search readiness: example.com"
  12. > "Run a full SEO, GEO, and AEO audit on my website"
  13. Claude will ask whether you want a **Quick Audit** (top issues and scores) or a **Full Audit** (comprehensive breakdown), then crawl the site across multiple pages before delivering a structured report with a downloadable Word doc and PDF.
  14. ---
  15. ## Installation
  16. This tool is distributed as a ZIP archive for use in **Claude's Cowork desktop app**.
  17. 1. Download the ZIP from this repository (click **Code → Download ZIP** on GitHub)
  18. 2. Open the Claude desktop app or website
  19. 3. Navigate to Customize
  20. 4. Go to **Skills** and click the **+** icon
  21. 5. Upload the ZIP here and it should install the Skill for you
  22. No unzipping required. The skill will be active for that session and any subsequent sessions where you provide the ZIP.
  23. ---
  24. ## Repository structure
  25. ```
  26. SEO-GEO-AEO-Skill/
  27. ├── SKILL.md ← Audit instructions (source of truth)
  28. └── README.md
  29. ```
  30. ---
  31. ## Version history
  32. **1.0.0** — Initial release
  33. - Quick and Full audit modes
  34. - Multi-page site crawl (up to 15 pages for Quick, unlimited for Full)
  35. - SEO, GEO, and AEO scoring with priority recommendations matrix
  36. - Downloadable audit report as both Word (.docx) and PDF

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.