Skip to content

Add Google AI Search Optimization Expert skill - #13

Merged
criptogus merged 1 commit into
mainfrom
claude/analyze-google-ai-repo-hWbQG
May 16, 2026
Merged

Add Google AI Search Optimization Expert skill#13
criptogus merged 1 commit into
mainfrom
claude/analyze-google-ai-repo-hWbQG

Conversation

@criptogus

Copy link
Copy Markdown
Owner

What does this PR add?

A new "Google AI Search Optimization Expert" skill that provides practical guidance for optimizing sites for Google AI Overviews and AI Mode based on official Google Search documentation.

Type

  • New package (skill / playbook / soul / guardrail)
  • Improvement to an existing package (bumped version)
  • Platform code or docs

Checklist (for content PRs)

  • Filename matches slug and the type's folder
  • At least 2 worked examples (skills) — realistic input + exact expected output
  • Original work, public-domain, or properly attributed; no secrets / PII
  • bun run validate:content passes locally
  • I've read CONTRIBUTING.md and agree to license under Apache-2.0 (code) / CC-BY-SA-4.0 (content)

Notes for reviewers

This skill introduces a specialized agent for Google AI Search optimization (AEO/GEO). Key design decisions:

  1. Grounding in official guidance: The system prompt explicitly anchors all recommendations to Google's public documentation and rejects unsupported shortcuts (llms.txt, content chunking, fan-out spam).

  2. Myth-busting focus: Includes explicit rejection of common AEO/GEO misconceptions and clarifies that optimization for Google's generative Search features is fundamentally an extension of standard SEO practices.

  3. Workflow classification: Structures requests into five types (Explain, Audit, Plan, Implement, Myth-check) to ensure appropriate output for each use case.

  4. Prioritization heuristic: Fixes are ranked by impact: crawl/index blockers → content depth → page comprehension → UX → rich results → measurement.

  5. Complementary pairing: Recommends gx-seo-technical-expert for deep crawl/Core Web Vitals work, positioning this skill as focused on AI-specific optimization rather than foundational SEO.

The two examples cover the primary use cases: auditing a page for AI Overviews and debunking a common myth about llms.txt files.

https://claude.ai/code/session_015KzWLfcuXZ85fHKDMe84hw

Adds gx-google-ai-search-expert covering AI Overviews/AI Mode optimization
with built-in AEO/GEO myth-busting, adapted from the open
deepakness/google-ai-search-optimization skill.

https://claude.ai/code/session_015KzWLfcuXZ85fHKDMe84hw
@criptogus
criptogus merged commit 4fc4d0a into main May 16, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants