seo

Optimize content for search engines and AI answer engines. Use when writing or auditing SEO for any Lightfast page.

⭐13stars🔀2forks📁View on GitHub🕐Updated Dec 24, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill optimizes web content for both traditional search engines and modern AI answer engines (AEO). It provides a comprehensive framework for auditing and writing high-authority pages, focusing on citability, structured data (JSON-LD), and E-E-A-T principles to maximize visibility across platforms like Google, ChatGPT, and Perplexity.

Use Cases

  • Auditing existing web pages to ensure compliance with modern SEO and AEO standards and identifying gaps in content structure.
  • Generating and implementing structured data schemas such as FAQPage, HowTo, and Article to improve rich snippet visibility.
  • Restructuring content using the 'Answer-first' framework to increase the likelihood of being cited by AI agents and LLMs.
  • Optimizing meta descriptions, OpenGraph tags, and internal linking structures to enhance search engine rankings and social sharing performance.
  • Validating content against E-E-A-T signals by ensuring proper external citations and authoritative formatting.
nameseo
descriptionOptimize content for search engines and AI answer engines. Use when writing or auditing SEO for any Lightfast page.
allowed-toolsRead, 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

  1. Analyze: What are users asking AI about this topic?
  2. Create: Structure content for citability (tables, lists, FAQs)
  3. Distribute: Link from high-authority pages
  4. Measure: Track AI visibility (citations, mentions)
  5. 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/