| name | seo |
| description | Optimize content for search engines and AI answer engines. Use when writing or auditing SEO for any Lightfast page. |
| allowed-tools | Read, Grep, Glob, Write, Edit |
SEO Skill
Comprehensive SEO and AEO (Answer Engine Optimization) guidelines for Lightfast pages.
Core Principle: Citability Over Rankings
Traditional SEO optimizes for position #1-10. AEO optimizes for AI citation frequency. Modern SEO requires both.
"AEO is about becoming the definitive source that AI trusts and cites, not just ranking for keywords."
When to Use This Skill
- Writing new Lightfast pages
- Auditing existing pages for SEO/AEO compliance
- Adding structured data (JSON-LD schema)
- Reviewing meta tags and OpenGraph
Quick Reference
Content Structure Requirements
| Element |
Requirement |
| TL;DR |
40-100 words, first position |
| Meta description |
150-160 chars |
| FAQ section |
3-5 Q&A pairs |
| Answer-first |
Key answer in first 200 words |
| Question headings |
H2/H3 as questions |
| Internal links |
3-5 per page |
Schema Priority
| Priority |
Schema Type |
Use Case |
| 1 |
FAQPage |
Any page with Q&A content |
| 2 |
HowTo |
Step-by-step instructions |
| 3 |
Article |
Content with dates and authors |
| 4 |
WebPage |
General pages, landing pages |
| 5 |
Product |
Features with pricing |
| 6 |
Organization |
Site-wide identity |
The 5-Step AEO Framework
- Analyze: What are users asking AI about this topic?
- Create: Structure content for citability (tables, lists, FAQs)
- Distribute: Link from high-authority pages
- Measure: Track AI visibility (citations, mentions)
- Iterate: Refresh content every 90 days for recency signals
Resources
Do
- Lead with direct answers (first 100-200 words)
- Use question-format headings for discoverability
- Include comparison tables with specific values
- Add FAQ sections with self-contained answers
- Cite 5+ external authoritative sources (E-E-A-T)
- Update content regularly (90-day freshness signal)
Don't
- Keyword stuff (AI detects this)
- Use generic headings ("Overview", "Introduction")
- Skip schema markup
- Write walls of text without structure
- Use creative prose over clarity
- Neglect internal linking
AI Engine Optimization Matrix
| Engine |
Priority Signal |
Content Focus |
| ChatGPT |
Comprehensiveness |
Encyclopedic coverage |
| Perplexity |
Recency (90 days) |
Fresh, updated content |
| Google AI |
E-E-A-T + Rankings |
Authority signals |
| Gemini |
Entity clarity |
Consistent terminology |
Lightfast-Specific Notes
- Use
@vendor/seo/metadata for createMetadata utility
- Use
@vendor/seo/json-ld for <JsonLd> component
- Canonical URLs:
https://lightfast.ai/{path}
- Twitter handle:
@lightfastai
- OG images: 1200x630px, stored in
/public/og/