seo-aeo-best-practices
sanity-io/agent-toolkit
SEO and AEO best practices for metadata, structured data, sitemaps, and AI answer engine optimization.
What is seo-aeo-best-practices?
Guidance for optimizing content to rank in traditional search engines and be selected by AI assistants. Covers metadata, Open Graph, JSON-LD schema, EEAT principles, technical SEO, and AI-overview readiness across Google, ChatGPT, Perplexity, and similar platforms.
- Implement metadata and Open Graph tags for search visibility
- Create and manage sitemaps and robots.txt files
- Add JSON-LD structured data (Article, FAQ, Breadcrumb, Product schemas)
- Optimize content for featured snippets and AI answer selection
- Apply EEAT (Experience, Expertise, Authoritativeness, Trustworthiness) principles
- Configure hreflang for international SEO and AI crawler management
How to install seo-aeo-best-practices
npx skills add https://github.com/sanity-io/agent-toolkit --skill seo-aeo-best-practicesHow to use seo-aeo-best-practices
- 1.Select the reference guide matching your task (EEAT, structured data, technical SEO, or AEO)
- 2.Review the relevant principles and patterns in the references/ directory
- 3.Implement metadata, schema markup, or technical configurations as needed
- 4.Validate structured data using Google's Rich Results Test or Schema.org validators
- 5.Test AI crawler access and content eligibility for your target platforms
Use cases
- Preparing a product page with schema markup for Google Shopping and AI assistants
- Optimizing a blog article for featured snippets and ChatGPT/Perplexity citations
- Setting up technical SEO infrastructure (sitemaps, robots.txt, hreflang) for a multi-region site
- Implementing author and publisher schema to demonstrate EEAT
- Configuring AI crawler access and content eligibility for AI Overviews
- Content strategists implementing SEO
- Full-stack developers building search-optimized sites
- Technical SEO specialists
- Product managers preparing content for AI platforms
- International site managers handling multi-language/region content
seo-aeo-best-practices FAQ
SEO optimizes for traditional search engines like Google and Bing. AEO optimizes for AI-powered answer engines like ChatGPT and Perplexity, focusing on authoritative, well-sourced content that AI systems cite.
Yes. Traditional search remains dominant, but AI assistants are increasingly used for research and answers. Optimizing for both ensures visibility across all discovery channels.
EEAT (Experience, Expertise, Authoritativeness, Trustworthiness) is Google's framework for evaluating content quality. It's critical for E-E-A-T sensitive topics and helps both search ranking and AI selection.
Start with Article for blog posts, FAQ for Q&A content, Breadcrumb for navigation, and Product for e-commerce. Choose based on your content type and business goals.
Focus on authoritative, well-sourced content with clear author/publisher information, proper schema markup, and robots.txt/meta tags that allow AI crawlers. Avoid paywalls or access restrictions that prevent indexing.
Full instructions (SKILL.md)
Source of truth, from sanity-io/agent-toolkit.
name: seo-aeo-best-practices description: SEO and AEO best practices for metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD structured data, EEAT, and content optimized for search engines and AI answer surfaces. Use this skill when implementing page SEO, technical SEO, schema markup, international SEO, AI-overview readiness, or improving content for Google, ChatGPT, Perplexity, and similar assistants.
SEO & AEO Best Practices
Principles for optimizing content for both traditional search engines (SEO) and AI-powered answer engines (AEO). Includes Google's EEAT guidelines and structured data implementation.
When to Apply
Reference these guidelines when:
- Implementing metadata and Open Graph tags
- Creating sitemaps and robots.txt
- Adding JSON-LD structured data
- Optimizing content for featured snippets
- Preparing content for AI assistants (ChatGPT, Perplexity, etc.)
- Evaluating content quality using EEAT principles
Core Concepts
SEO (Search Engine Optimization)
Optimizing content to rank well in traditional search results (Google, Bing).
AEO (Answer Engine Optimization)
Optimizing content to be selected as authoritative answers by AI systems.
EEAT (Experience, Expertise, Authoritativeness, Trustworthiness)
Google's framework for evaluating content quality.
References
Start with the one reference that matches the task, such as technical SEO, structured data, EEAT, or AI-answer readiness. See references/ for detailed guidance:
references/eeat-principles.md— EEAT implementation and author schemareferences/structured-data.md— JSON-LD patterns (Article, FAQ, Breadcrumb, Product)references/technical-seo.md— Technical SEO checklist (metadata, sitemaps, hreflang, robots.txt)references/aeo-considerations.md— AI/AEO considerations (AI Overviews, crawler management)
Related skills
More from sanity-io/agent-toolkit and the wider catalog.

content-experimentation-best-practices
A/B testing and experimentation guidance for content-driven products and CMS workflows.

content-modeling-best-practices
Structured content modeling guidance for schema design, reusability, and multi-channel delivery in headless CMSes.

portable-text-conversion
Convert HTML and Markdown into Portable Text blocks for Sanity content migration and pipelines.

portable-text-serialization
Render and serialize Portable Text across React, Vue, Svelte, Astro, HTML, Markdown, and plain text.

book-study
Systematic reading coach with knowledge compilation, mastery testing, and spaced repetition for deep book learning.

code-review-expert
Expert code review of git changes detecting SOLID violations, security risks, and proposing actionable improvements.