Skip to content

Commit d62c0e7

Browse files
Xeclaude
Xe
and
claude
authored
Add SEO/AEO best practices skill from tigris-blog (#1161)
Copies the seo-aeo-best-practices skill including EEAT principles, structured data patterns, technical SEO checklist, and AEO considerations. https://claude.ai/code/session_01H2sEDhsTTK6nJix9ByNCoT Co-authored-by: Claude <noreply@anthropic.com>
1 parent ae2749b commit d62c0e7

5 files changed

Lines changed: 669 additions & 0 deletions

File tree

‎.agents/skills/seo-aeo-best-practices/SKILL.md‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
name: seo-aeo-best-practices
3+
description:
4+
SEO and AEO (Answer Engine Optimization) best practices including EEAT
5+
principles, structured data, and technical SEO. Use when implementing
6+
metadata, sitemaps, structured data, or optimizing content for search engines
7+
and AI assistants.
8+
license: MIT
9+
metadata:
10+
author: sanity
11+
version: "1.0.0"
12+
---
13+
14+
# SEO & AEO Best Practices
15+
16+
Principles for optimizing content for both traditional search engines (SEO) and
17+
AI-powered answer engines (AEO). Includes Google's EEAT guidelines and
18+
structured data implementation.
19+
20+
## When to Apply
21+
22+
Reference these guidelines when:
23+
24+
- Implementing metadata and Open Graph tags
25+
- Creating sitemaps and robots.txt
26+
- Adding JSON-LD structured data
27+
- Optimizing content for featured snippets
28+
- Preparing content for AI assistants (ChatGPT, Perplexity, etc.)
29+
- Evaluating content quality using EEAT principles
30+
31+
## Core Concepts
32+
33+
### SEO (Search Engine Optimization)
34+
35+
Optimizing content to rank well in traditional search results (Google, Bing).
36+
37+
### AEO (Answer Engine Optimization)
38+
39+
Optimizing content to be selected as authoritative answers by AI systems.
40+
41+
### EEAT (Experience, Expertise, Authoritativeness, Trustworthiness)
42+
43+
Google's framework for evaluating content quality.
44+
45+
## Resources
46+
47+
See `resources/` for detailed guidance:
48+
49+
- EEAT implementation
50+
- Structured data patterns
51+
- Technical SEO checklist
52+
- AI/AEO considerations

‎.agents/skills/seo-aeo-best-practices/resources/aeo-considerations.md‎

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
# AI/AEO Considerations
2+
3+
Answer Engine Optimization (AEO) prepares content to be selected as
4+
authoritative answers by AI systems like ChatGPT, Perplexity, Google AI
5+
Overviews, and Bing Copilot.
6+
7+
## How AI Selects Answers
8+
9+
AI systems evaluate content based on:
10+
11+
1. **Clarity:** Is the answer direct and easy to extract?
12+
2. **Authority:** Is the source trustworthy?
13+
3. **Comprehensiveness:** Does it fully address the question?
14+
4. **Recency:** Is the information up to date?
15+
5. **Structure:** Can the AI parse and understand it?
16+
17+
## Content Structure for AI
18+
19+
### Direct Answers First
20+
21+
Lead with the answer, then explain.
22+
23+
**Bad:**
24+
25+
> The history of JavaScript dates back to 1995 when Brendan Eich... [500 words >
26+
> > later] ...JavaScript runs in the browser.
27+
28+
**Good:**
29+
30+
> JavaScript is a programming language that runs in web browsers. It was created
31+
> in 1995 by Brendan Eich...
32+
33+
### Clear Headings
34+
35+
Use descriptive H2/H3 headings that match user questions.
36+
37+
**Bad:** "Overview" → "Details" → "More Information" **Good:** "What is X?" →
38+
"How does X work?" → "When should you use X?"
39+
40+
### Lists and Tables
41+
42+
AI extracts structured information more easily than prose.
43+
44+
```markdown
45+
## Benefits of Structured Content
46+
47+
- **Reusability:** Use content across channels
48+
- **Flexibility:** Change presentation without changing content
49+
- **Scalability:** Manage large content volumes
50+
```
51+
52+
### FAQ Format
53+
54+
Question-answer pairs are ideal for AI extraction.
55+
56+
```typescript
57+
// Schema for AI-friendly FAQs
58+
defineType({
59+
name: "faq",
60+
type: "document",
61+
fields: [
62+
defineField({ name: "question", type: "string" }),
63+
defineField({ name: "answer", type: "text" }),
64+
defineField({
65+
name: "category",
66+
type: "reference",
67+
to: [{ type: "faqCategory" }],
68+
}),
69+
],
70+
});
71+
```
72+
73+
## Technical Implementation
74+
75+
### Structured Data (Critical)
76+
77+
JSON-LD helps AI understand content type and relationships.
78+
79+
```typescript
80+
// FAQ structured data
81+
const faqSchema = {
82+
"@context": "https://schema.org",
83+
"@type": "FAQPage",
84+
mainEntity: faqs.map((faq) => ({
85+
"@type": "Question",
86+
name: faq.question,
87+
acceptedAnswer: {
88+
"@type": "Answer",
89+
text: faq.answer,
90+
},
91+
})),
92+
};
93+
```
94+
95+
### Canonical Content
96+
97+
Ensure AI finds your authoritative version, not copies.
98+
99+
- Set canonical URLs
100+
- Avoid duplicate content across pages
101+
- Use `rel="canonical"` for syndicated content
102+
103+
### Freshness Signals
104+
105+
AI systems prefer current information.
106+
107+
- Display publish and update dates prominently
108+
- Update content regularly (even small updates signal freshness)
109+
- Use `dateModified` in structured data
110+
111+
## Content Quality Signals
112+
113+
### Author Credentials
114+
115+
AI systems increasingly check author authority.
116+
117+
- Display author name and credentials
118+
- Link to author profiles
119+
- Include author structured data
120+
121+
### Citations and Sources
122+
123+
Linking to authoritative sources increases trust.
124+
125+
- Cite primary sources
126+
- Link to studies, documentation, official sources
127+
- Avoid circular citations (sites citing each other)
128+
129+
### Comprehensive Coverage
130+
131+
AI prefers content that fully answers questions.
132+
133+
- Cover related questions users might have
134+
- Include definitions for technical terms
135+
- Address common misconceptions
136+
137+
## Measuring AEO Success
138+
139+
### Monitor AI Mentions
140+
141+
Track when AI assistants cite your content:
142+
143+
- Search for your brand + "according to"
144+
- Monitor traffic from AI platforms
145+
- Check Perplexity, Bing Copilot responses
146+
147+
### Track Zero-Click Queries
148+
149+
If AI answers questions directly, traditional rankings matter less.
150+
151+
### Featured Snippet Capture
152+
153+
Featured snippets often become AI answers. Track which you own.
154+
155+
## AEO vs SEO Balance
156+
157+
AEO and SEO largely align—quality content serves both. Key differences:
158+
159+
| Aspect | SEO Focus | AEO Focus |
160+
| ------ | -------------- | ----------------------- |
161+
| Goal | Rank on page 1 | Be THE answer |
162+
| Format | Varies | Direct, structured |
163+
| Length | Often longer | Concise + comprehensive |
164+
| Links | Link building | Source citations |

‎.agents/skills/seo-aeo-best-practices/resources/eeat-principles.md‎

Lines changed: 149 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,149 @@
1+
# EEAT Principles
2+
3+
Google's EEAT framework (Experience, Expertise, Authoritativeness,
4+
Trustworthiness) guides how content quality is evaluated. This applies to both
5+
SEO rankings and AI answer selection.
6+
7+
## The Four Pillars
8+
9+
### Experience
10+
11+
First-hand or life experience with the topic.
12+
13+
**Signals:**
14+
15+
- Personal anecdotes and case studies
16+
- "I tested this" content
17+
- Real-world results and screenshots
18+
- User-generated reviews
19+
20+
**Implementation:**
21+
22+
- Include author bios with relevant experience
23+
- Add "About the Author" sections
24+
- Feature customer testimonials
25+
- Show real examples, not just theory
26+
27+
### Expertise
28+
29+
Knowledge and skill in the subject area.
30+
31+
**Signals:**
32+
33+
- Credentials and qualifications
34+
- Depth of content coverage
35+
- Technical accuracy
36+
- Citations to authoritative sources
37+
38+
**Implementation:**
39+
40+
- Display author credentials
41+
- Link to primary sources
42+
- Cover topics comprehensively
43+
- Keep content technically accurate and updated
44+
45+
### Authoritativeness
46+
47+
Recognition as a go-to source in the field.
48+
49+
**Signals:**
50+
51+
- Backlinks from respected sites
52+
- Mentions in industry publications
53+
- Social proof and follower counts
54+
- Brand recognition
55+
56+
**Implementation:**
57+
58+
- Build thought leadership content
59+
- Contribute to industry publications
60+
- Maintain consistent publishing
61+
- Develop recognizable brand voice
62+
63+
### Trustworthiness
64+
65+
Accuracy, transparency, and legitimacy.
66+
67+
**Signals:**
68+
69+
- Clear authorship and contact info
70+
- Accurate, fact-checked content
71+
- Secure website (HTTPS)
72+
- Privacy policy and terms
73+
74+
**Implementation:**
75+
76+
- Display clear author attribution
77+
- Include publication and update dates
78+
- Provide contact information
79+
- Use HTTPS and maintain security
80+
81+
## Sanity Implementation
82+
83+
```typescript
84+
// Author schema with EEAT signals
85+
defineType({
86+
name: "author",
87+
type: "document",
88+
fields: [
89+
defineField({ name: "name", type: "string" }),
90+
defineField({ name: "role", type: "string" }),
91+
defineField({ name: "bio", type: "text" }),
92+
defineField({
93+
name: "credentials",
94+
type: "array",
95+
of: [{ type: "string" }],
96+
}),
97+
defineField({ name: "image", type: "image" }),
98+
defineField({
99+
name: "socialLinks",
100+
type: "array",
101+
of: [
102+
{
103+
type: "object",
104+
fields: [
105+
defineField({ name: "platform", type: "string" }),
106+
defineField({ name: "url", type: "url" }),
107+
],
108+
},
109+
],
110+
}),
111+
],
112+
});
113+
114+
// Content with EEAT metadata
115+
defineType({
116+
name: "post",
117+
fields: [
118+
defineField({
119+
name: "author",
120+
type: "reference",
121+
to: [{ type: "author" }],
122+
}),
123+
defineField({ name: "publishedAt", type: "datetime" }),
124+
defineField({ name: "updatedAt", type: "datetime" }),
125+
defineField({
126+
name: "reviewedBy",
127+
type: "reference",
128+
to: [{ type: "author" }],
129+
description: "Expert reviewer for fact-checking",
130+
}),
131+
defineField({
132+
name: "sources",
133+
type: "array",
134+
of: [{ type: "url" }],
135+
description: "Citations and references",
136+
}),
137+
],
138+
});
139+
```
140+
141+
## YMYL Considerations
142+
143+
"Your Money or Your Life" topics (health, finance, legal, safety) require extra
144+
EEAT rigor:
145+
146+
- Medical content reviewed by healthcare professionals
147+
- Financial advice from certified experts
148+
- Legal content reviewed by attorneys
149+
- Clear disclaimers where appropriate

0 commit comments

Comments
 (0)