
Seo Aeo Best Practices
Structure Sanity-backed content and schema so AI answer engines can cite your site as authoritative answers.
Overview
SEO/AEO Best Practices is an agent skill most often used in Launch (also Grow) that teaches how to structure Sanity content so AI answer engines can extract clear, authoritative answers.
Install
npx skills add https://github.com/sanity-io/agent-toolkit --skill seo-aeo-best-practicesWhat is this skill?
- Five AI answer-selection criteria: clarity, authority, comprehensiveness, recency, and structure
- Direct-answer-first copy pattern with question-shaped H2/H3 headings
- Lists, tables, and FAQ pairs optimized for extraction by answer engines
- Sanity schema examples for AI-friendly FAQ and structured content types
- Bad vs good prose examples for lead-with-answer formatting
- 5 AI answer-selection evaluation criteria
Adoption & trust: 3.4k installs on skills.sh; 150 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your articles bury the answer in narrative and vague headings, so AI systems skip your pages when users ask direct questions.
Who is it for?
Indie builders shipping blogs, docs, or marketing sites on Sanity who care about Perplexity and ChatGPT citations as much as classic SEO.
Skip if: Teams that only need keyword density tweaks, paid ads, or a full technical crawl audit without changing content structure.
When should I use this skill?
Publishing or refactoring content meant to rank in AI answer surfaces and structured CMS entries.
What do I get? / Deliverables
You get repeatable AEO patterns—direct leads, question headings, FAQs, and schema-ready types—ready to apply in Sanity and similar structured CMS workflows.
- AEO-aligned content outline
- FAQ-friendly schema patterns
- Editorial before/after examples
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
AEO is the canonical launch concern for AI-search visibility before ongoing content iteration in grow. GEO (generative engine optimization) is the subphase for tuning pages for ChatGPT, Perplexity, and AI Overviews—not classic keyword SEO alone.
Where it fits
Rewrite product FAQ pages so each section opens with a one-sentence answer AI can quote.
Align H2s with 'what is' and 'how does' queries before ship week.
Refresh blog templates to use lists and tables instead of long unstructured paragraphs.
Define Sanity document types for FAQs before generating developer docs.
How it compares
Use for answer-engine content shape on structured CMS—not as a replacement for Lighthouse performance or backlink outreach.
Common Questions / FAQ
Who is seo-aeo-best-practices for?
Solo and indie builders publishing through Sanity or similar headless CMS who want AI answer engines to quote their pages reliably.
When should I use seo-aeo-best-practices?
During launch when polishing landing and docs for AI Overviews; in grow when refreshing posts and FAQs; whenever you add new schema-backed content types.
Is seo-aeo-best-practices safe to install?
It is editorial guidance only—review the Security Audits panel on this Prism page before installing any skill from the parent agent-toolkit repo.
SKILL.md
READMESKILL.md - Seo Aeo Best Practices
# AI/AEO Considerations Answer Engine Optimization (AEO) prepares content to be selected as authoritative answers by AI systems like ChatGPT, Perplexity, Google AI Overviews, and Bing Copilot. ## How AI Selects Answers AI systems evaluate content based on: 1. **Clarity:** Is the answer direct and easy to extract? 2. **Authority:** Is the source trustworthy? 3. **Comprehensiveness:** Does it fully address the question? 4. **Recency:** Is the information up to date? 5. **Structure:** Can the AI parse and understand it? ## Content Structure for AI ### Direct Answers First Lead with the answer, then explain. **Bad:** > The history of JavaScript dates back to 1995 when Brendan Eich... [500 words later] ...JavaScript runs in the browser. **Good:** > JavaScript is a programming language that runs in web browsers. It was created in 1995 by Brendan Eich... ### Clear Headings Use descriptive H2/H3 headings that match user questions. **Bad:** "Overview" → "Details" → "More Information" **Good:** "What is X?" → "How does X work?" → "When should you use X?" ### Lists and Tables AI extracts structured information more easily than prose. ```markdown ## Benefits of Structured Content - **Reusability:** Use content across channels - **Flexibility:** Change presentation without changing content - **Scalability:** Manage large content volumes ``` ### FAQ Format Question-answer pairs are ideal for AI extraction. ```typescript // Schema for AI-friendly FAQs defineType({ name: 'faq', type: 'document', fields: [ defineField({ name: 'question', type: 'string' }), defineField({ name: 'answer', type: 'text' }), defineField({ name: 'category', type: 'reference', to: [{ type: 'faqCategory' }] }), ] }) ``` ## Technical Implementation ### Structured Data (Critical) JSON-LD helps AI understand content type and relationships. ```typescript // FAQ structured data const faqSchema = { "@context": "https://schema.org", "@type": "FAQPage", mainEntity: faqs.map(faq => ({ "@type": "Question", name: faq.question, acceptedAnswer: { "@type": "Answer", text: faq.answer } })) } ``` ### Canonical Content Ensure AI finds your authoritative version, not copies. - Set canonical URLs - Avoid duplicate content across pages - Use `rel="canonical"` for syndicated content ### Freshness Signals AI systems prefer current information. - Display publish and update dates prominently - Update content regularly with substantive changes (superficial updates like changing dates without meaningful edits can be counterproductive) - Use `dateModified` in structured data ## Content Quality Signals ### Author Credentials AI systems increasingly check author authority. - Display author name and credentials - Link to author profiles - Include author structured data ### Citations and Sources Linking to authoritative sources increases trust. - Cite primary sources - Link to studies, documentation, official sources - Avoid circular citations (sites citing each other) ### Comprehensive Coverage AI prefers content that fully answers questions. - Cover related questions users might have - Include definitions for technical terms - Address common misconceptions ## Google AI Overviews Google's AI Overviews (formerly SGE) now appear in many search results. To optimize: - **Be the cited source:** AI Overviews cite specific pages. Concise, authoritative answers increase citation likelihood. - **Structure for extraction:** Use clear headings, direct answers, and lists that AI can easily parse. - **Cover follow-up questions:** AI Overviews often address related queries. Anticipate and answer them on the same page or link to dedicated pages. - **Monitor in Search Console:** Google Search Console provides data on AI Overview impressions and clicks. ## AI Crawler Management Make conscious decisions about which AI systems can crawl your content: - **robots.txt directives:** Use `User-agent: GPTBot`, `ClaudeBot`, `Perplexit