plugins/website-audit/skills/auditing-website-seo-geo/SKILL.md
Audits a site's SEO and AI-search (GEO) readiness — meta tags, Open Graph/Twitter, JSON-LD, robots/llms conventions — and generates fixes. Use when reviewing search visibility, social previews, structured data, or LLM/AI-crawler discoverability.
npx skillsauth add qte77/claude-code-utils auditing-website-seo-geoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Target: $ARGUMENTS
Audits a site for traditional SEO and Generative-Engine Optimization (GEO — visibility in AI search such as ChatGPT, Perplexity, Gemini, and Google AI Overviews) and generates implementable fixes. Prefer configuring the site or static-site generator so tags are emitted once (DRY) over hand-stuffing meta into every page. No over-analysis.
<title> (~30-60 chars, unique per page), <meta name="description">
(~120-160 chars, entity-clear), lang on <html>, charset, viewport
(no maximum-scale — it blocks zoom), robots, author, keywords,
format-detection, and a canonical link.og:title, og:description, og:url, og:type, og:site_name, og:image.twitter:card, twitter:title, twitter:description, twitter:image,
twitter:site, twitter:creator.WebSite / Organization (name, url, logo, sameAs) and per-page
Article / BlogPosting (headline, description, datePublished, author,
publisher, image). Validate against the matching schema.org type.robots.txt AI user-agents (GPTBot, ClaudeBot, Google-Extended, CCBot,
PerplexityBot, OAI-SearchBot) — the highest-leverage, best-honored lever.llms.txt at root — cheap, uncertain adoption; fine to keep.twitter:description and og:image / twitter:image may not be
emitted without explicit config or a per-page image. Fill only the genuine
gaps in a single shared include.Some checkers want mutually-exclusive lengths on a single shared tag:
og:title 25-35 vs twitter:title 50-70 — same tag, cannot satisfy both.og:description 55-65 vs <meta name="description"> 120-160 — same tag.Recommend the real-world optimum (Google limits plus GEO: a ~50-char title and a ~150-char description) and note the tradeoff rather than ping-ponging.
/.well-known/ai.txt is not a recognized standard (competing
vendor proposals, no IANA .well-known registration, no major adopter).
Skip it; do not spend effort on /.well-known/ai.txt.robots.txt AI-agent policy plus a full OG/JSON-LD set are what
actually move GEO and social previews.<head> — converting tools return markdown, so fetch
raw HTML when you need the tags verbatim.HIGH
- [Tag/issue] - Current: [value or "missing"] - Page: [url/path]
Fix: [code/config snippet]
MEDIUM / LOW
- [Tag/issue] - Current: [value or "missing"]
Fix: [code/config snippet]
- [ ] [Fix] - Impact: [High/Medium/Low] - scope: [site-wide | per-page]
development
Verify an external or AI-generated security report against the actual codebase before acting on it. Use when handed a scanner PDF, automated teardown, audit report, or bug-bounty submission — classifies every finding CONFIRMED / OVERSTATED / FALSE-POSITIVE / FABRICATED and salvages the real work items.
development
Analyzes industry websites for design patterns, layout, typography, and content strategies using first-principles thinking. Use when researching website design, UI patterns, or competitive design analysis.
development
Audits website usability for UX optimization, covering forms, navigation, validation, and microcopy. Use when reviewing user experience, task completion flows, or interface friction points.
development
Audits website accessibility for WCAG 2.2 AA compliance, generating findings and code fixes. Use when reviewing accessibility, keyboard navigation, screen reader compatibility, or inclusive design.