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.

referenceseeat-principles.md

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

EEAT Principles

Google's EEAT framework (Experience, Expertise, Authoritativeness, Trustworthiness) guides how content quality is evaluated. This applies to both SEO rankings and AI answer selection.

The Four Pillars

Experience

First-hand or life experience with the topic.

Signals:

  • Personal anecdotes and case studies
  • "I tested this" content
  • Real-world results and screenshots
  • User-generated reviews

Implementation:

  • Include author bios with relevant experience
  • Add "About the Author" sections
  • Feature customer testimonials
  • Show real examples, not just theory

Expertise

Knowledge and skill in the subject area.

Signals:

  • Credentials and qualifications
  • Depth of content coverage
  • Technical accuracy
  • Citations to authoritative sources

Implementation:

  • Display author credentials
  • Link to primary sources
  • Cover topics comprehensively
  • Keep content technically accurate and updated

Authoritativeness

Recognition as a go-to source in the field.

Signals:

  • Backlinks from respected sites
  • Mentions in industry publications
  • Social proof and follower counts
  • Brand recognition

Implementation:

  • Build thought leadership content
  • Contribute to industry publications
  • Maintain consistent publishing
  • Develop recognizable brand voice

Trustworthiness

Accuracy, transparency, and legitimacy.

Signals:

  • Clear authorship and contact info
  • Accurate, fact-checked content
  • Secure website (HTTPS)
  • Privacy policy and terms

Implementation:

  • Display clear author attribution
  • Include publication and update dates
  • Provide contact information
  • Use HTTPS and maintain security

Sanity Implementation

// Author schema with EEAT signals
defineType({
  name: 'author',
  type: 'document',
  fields: [
    defineField({ name: 'name', type: 'string' }),
    defineField({ name: 'role', type: 'string' }),
    defineField({ name: 'bio', type: 'text' }),
    defineField({ name: 'credentials', type: 'array', of: [{ type: 'string' }] }),
    defineField({ name: 'image', type: 'image' }),
    // sameAs: used for schema.org Person structured data output
    defineField({ name: 'sameAs', type: 'array', of: [{ type: 'url' }],
      description: 'Canonical profile URLs (LinkedIn, Twitter, etc.) for schema.org Person'
    }),
    // socialLinks: used for display purposes (platform icons, labels)
    defineField({
      name: 'socialLinks',
      type: 'array',
      of: [{ type: 'object', fields: [
        defineField({ name: 'platform', type: 'string' }),
        defineField({ name: 'url', type: 'url' })
      ]}],
      description: 'Social links for display in the UI. Use sameAs for structured data output.'
    }),
  ]
})

// Content with EEAT metadata
defineType({
  name: 'post',
  fields: [
    defineField({ name: 'author', type: 'reference', to: [{ type: 'author' }] }),
    defineField({ name: 'publishedAt', type: 'datetime' }),
    defineField({ name: 'updatedAt', type: 'datetime' }),
    defineField({ 
      name: 'reviewedBy', 
      type: 'reference', 
      to: [{ type: 'author' }],
      description: 'Expert reviewer for fact-checking'
    }),
    defineField({
      name: 'sources',
      type: 'array',
      of: [{ type: 'url' }],
      description: 'Citations and references'
    }),
  ]
})

YMYL Considerations

"Your Money or Your Life" topics (health, finance, legal, safety) require extra EEAT rigor:

  • Medical content reviewed by healthcare professionals
  • Financial advice from certified experts
  • Legal content reviewed by attorneys
  • Clear disclaimers where appropriate

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.