Commit Graph

4 Commits

Author SHA1 Message Date
Corey Haines 8b0a54eef9 fix(ai-seo): align with Google's official AI features optimization guide (#313)
Source: https://developers.google.com/search/docs/fundamentals/ai-optimization-guide

The skill was framed as "optimize for AI systems," which mis-states Google's
explicit position: AI Overviews and AI Mode are powered by core Search ranking,
so SEO best practices ARE the optimization strategy. Don't write separate
content "for AI."

The structural patterns the skill recommends (FAQ schema, comparison tables,
40-60 word answer blocks, llms.txt, /pricing.md) still help non-Google AI
engines (ChatGPT, Claude, Perplexity, Copilot) materially. The skill now
calls out the platform split explicitly rather than implying universal
benefit.

Major changes:

- New section "Google's Official Stance vs. Multi-Platform Reality":
  Frames Google's "don't optimize for AI" position alongside the reality that
  other AI engines reward extractable structure. Quotes Google's own
  phrasing.

- New section "Query Fan-Out (Google AI Search)":
  Explains Google's documented behavior of generating concurrent related
  queries. Reframes content strategy from per-query targeting to topical
  cluster coverage.

- New section "Agentic Experiences":
  Browser agents accessing sites via visual rendering, DOM inspection, and
  accessibility tree. Semantic HTML, JS-free meaningful render, clean a11y
  tree. Mentions the emerging Universal Commerce Protocol (UCP).

- New section "What NOT to Do":
  Explicit Google guidance: don't write for AI, don't chunk content for AI,
  don't scale variations (scaled content abuse spam policy), don't pursue
  inauthentic mentions, don't block AI crawlers if you want citation.

- Machine-Readable Files section reframed:
  Now opens with Google's stance ("not required") + the reason to include
  them anyway (non-Google AI engines).

- Schema markup note reframed:
  Notes Google's position that structured data is "not required for
  generative AI search" but still recommended.

- Search Console expectations added:
  Sets correct expectation that no AI-specific Search Console reporting
  exists; standard SEO metrics + third-party tools are the measurement
  options.

- Moved "AI SEO for Different Content Types" to references/content-types.md:
  Kept SKILL.md under 500 lines. Added a local-business/ecom subsection
  (Merchant Center + Google Business Profile + Business Agent) per
  Google's emphasis.

All 40 skills still pass validation.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-18 22:24:17 -07:00
Corey Haines 6914c62688 refactor: rewrite platform-ranking-factors to be original
Rewrote platform-ranking-factors.md from scratch with our own
organizational approach. Replaced table-heavy format with narrative
prose, different section structure, and synthesized analysis.
Updated SKILL.md robots.txt section to match.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 12:29:06 -08:00
Corey Haines 5436b34b98 feat: add GEO research data and platform-specific ranking factors
Add Princeton GEO study (KDD 2024) 9-method table with exact visibility
percentages to SKILL.md. Add AI bot robots.txt configuration. Add keyword
stuffing warning (-10% visibility). Add platform-ranking-factors.md reference
with per-platform details: Google AI Overviews (5-stage pipeline), ChatGPT
(content-answer fit 55%, 30-day freshness 3.2x), Perplexity (3-layer RAG,
FAQ Schema priority), Copilot (Bing index + MS ecosystem), Claude (Brave
Search, 38K:1 crawl-to-refer ratio).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 17:14:33 -08:00
Corey Haines ce8dd3b41a feat: add ai-seo skill for AI search optimization (AEO, GEO, LLMO)
Split AEO/GEO content patterns out of seo-audit into a standalone ai-seo
skill. Covers AI visibility auditing, content extractability, authority
signals, third-party presence strategy, schema markup for AI, monitoring
tools (Otterly, Peec AI, ZipTie), and optimization by content type.

Moves aeo-geo-patterns.md from seo-audit/references to ai-seo/references
(renamed to content-patterns.md). Updates seo-audit to cross-reference
the new skill.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 17:06:09 -08:00