seo-aeo-best-practices — Claude Code skill: SEO and AEO rules
A skill with SEO and AEO guidance: metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD and EEAT. Useful while you build pages and want search engines and AI answers to pick them up.
npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a claude-codeWhat seo-aeo-best-practices does
The skill hands your agent four reference files. references/technical-seo.md is a checklist for metadata, sitemaps, hreflang and robots.txt. references/structured-data.md holds JSON-LD patterns for Article, FAQ, Breadcrumb and Product. references/eeat-principles.md covers EEAT implementation and author schema, and references/aeo-considerations.md deals with AI Overviews and crawler management.
It works as a reference, not a code generator. The agent opens the one file that matches the task and leans on it while writing meta tags, schema markup or crawl rules. That makes it most useful during page build and content edits rather than after launch.
Each platform gets its own copy: Claude reads ~/.claude/skills/seo-aeo-best-practices/SKILL.md, Cursor reads .cursor/skills/seo-aeo-best-practices/SKILL.md, Codex reads .agents/skills/seo-aeo-best-practices/SKILL.md. If your project already has metadata conventions, they will fight with this skill, so decide which one wins before the agent starts editing templates.
What it helps with
- write metadata and Open Graph tags for a page
- generate JSON-LD for an article, FAQ or product card
- audit technical SEO: sitemaps, robots.txt, hreflang
- score a draft against EEAT principles before publishing
- prepare content for AI Overviews and answer engines
Example prompts for the agent
- add Article JSON-LD markup to the blog page
- check the metadata and Open Graph tags on this page
- generate a sitemap and robots.txt for the site
How to install seo-aeo-best-practices
1Skills CLI (Vercel)
npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a claude-code2Manually: put the files in place
~/.claude/skills/seo-aeo-best-practices/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-aeo-best-practices/
1Skills CLI (Vercel)
npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a codex2Manually: put the files in place
.agents/skills/seo-aeo-best-practices/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a cursor2Manually: put the files in place
.cursor/skills/seo-aeo-best-practices/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sanity-io/agent-toolkit seo-aeo-best-practices2Manually: put the files in place
.github/skills/seo-aeo-best-practices/SKILL.md1Skills CLI (Vercel)
npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a gemini-cli2Platform CLI
gemini skills install https://github.com/sanity-io/agent-toolkit --path skills/seo-aeo-best-practicesManually: put the files in place
.devin/skills/seo-aeo-best-practices/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about seo-aeo-best-practices
How do I install seo-aeo-best-practices in Claude?
Run npx skills add sanity-io/agent-toolkit --skill seo-aeo-best-practices -a claude-code. The skill file lands at ~/.claude/skills/seo-aeo-best-practices/SKILL.md.
What does seo-aeo-best-practices do?
It gives the agent rules for metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD and EEAT, plus guidance on getting content picked up by AI answers. The agent pulls the matching file from references/ for the task at hand.
How is SEO different from AEO here?
SEO covers ranking in regular Google and Bing results, while AEO is about AI systems choosing your content as an authoritative answer. The skill keeps them as two separate sets of guidance.
Source text
SKILL.md · MIT
--- 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 schema - `references/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)
© sanity-io · MIT · sanity-io/agent-toolkit
