All skills
sanity-io avatar

/seo-aeo-best-practices

@ad50ea4 official
by Sanitysanity-io/agent-toolkit187 stars
30

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.

Use this Skill: https://skilld.dev/gh/sanity-io/agent-toolkit/seo-aeo-best-practices

This session only. Nothing lands on disk.

referencesaeo-considerations.md

≈1.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

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.

## 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.

// 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.

// 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, PerplexityBot, Google-Extended to control access.
  • Allowing crawlers increases chances of being cited as a source in AI responses.
  • Blocking crawlers prevents content from being used in AI training (but may reduce AI citations).
  • Review your policy regularly — this is one of the most actively evolving areas of SEO.

Measuring AEO Success

Monitor AI Mentions

Track when AI assistants cite your content:

  • Use Google Search Console's AI Overview data for impression and click tracking
  • Monitor referral traffic from AI platforms (Perplexity, ChatGPT, Bing Copilot)
  • Search for your brand + "according to" in AI assistants
  • Consider third-party AEO tracking tools for comprehensive monitoring

Track Zero-Click Queries

If AI answers questions directly, traditional rankings matter less.

Featured Snippet Capture

Featured snippets often become AI answers. Track which you own.

AEO vs SEO Balance

AEO and SEO largely align—quality content serves both. Key differences:

Aspect SEO Focus AEO Focus
Goal Rank on page 1 Be THE answer
Format Varies Direct, structured
Length Often longer Concise + comprehensive
Links Link building Source citations

Source: SKILL.md on GitHub

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides comprehensive best practices and code templates for Search Engine Optimization (SEO) and Answer Engine Optimization (AEO). It includes Sanity CMS schemas, Next.js metadata implementations, and JSON-LD structured data patterns for enhancing content visibility for search engines and AI assistants. No security issues were detected.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    5 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at ad50ea4. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated 6 months ago
  • SEO
  • aeo
  • metadata
  • structured-data
  • json-ld
  • open-graph
  • robots.txt
  • hreflang
  • eeat
  • schema-markup

README badge

README badge for sanity-io/agent-toolkit/seo-aeo-best-practices

Provides SEO and AEO best practices for metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD structured data, and EEAT guidelines. Use this when implementing page SEO, technical SEO, schema markup, or optimizing content for both search engines and AI answer engines like ChatGPT and Perplexity.

Generated from the current SKILL.md.

Does this skill cover both traditional SEO and AI answer engine optimization?
Yes. It includes SEO best practices for search engines and AEO practices for AI assistants like ChatGPT and Perplexity, plus Google's EEAT framework for content quality.
What structured data formats does this skill document?
It covers JSON-LD patterns including Article, FAQ, Breadcrumb, and Product schema, with implementation guidance in the structured-data reference.
Does this skill provide technical SEO guidance like sitemaps and robots.txt?
Yes. It includes a technical SEO checklist covering metadata, sitemaps, hreflang tags, and robots.txt configuration.
What is EEAT and how does this skill use it?
EEAT (Experience, Expertise, Authoritativeness, Trustworthiness) is Google's framework for evaluating content quality. The skill includes EEAT implementation principles and author schema patterns to meet these guidelines.

Generated from the current SKILL.md. These answers refresh after source changes.