Astro Starlight

Also covers multi-language documentation with hreflang support and Content Layer API integration (docsLoader, schema) specific to Starlight's content model, plus CSS custom property theming. Does not cover generic Astro Content Layer usage outside Starlight (astro-content) or non-Starlight i18n routing (astro-i18n) — those are handled by their own skills.

Astro Starlight

Production-ready documentation theme for Astro with built-in search, dark mode, i18n, and rich plugin ecosystem.

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

1. explore-codebase - Analyze existing Starlight config, sidebar, and content structure
2. research-expert - Verify Starlight plugin APIs via Context7/Exa
3. mcp__context7__query-docs - Check Starlight docs for Content Layer and i18n patterns

After implementation, run sniper for validation.

Overview

When to Use

• Building technical documentation sites
• Creating API reference docs (with starlight-openapi)
• Generating docs from TypeScript types (with starlight-typedoc)
• Adding a blog to a documentation site (with starlight-blog)
• Setting up versioned documentation (with starlight-versions)
• Multi-language documentation with hreflang support

Why Starlight

Reference Guide

Concepts

Templates

Best Practices

1. Start with filesystem sidebar - Add manual config only when needed
2. Keep Pagefind for small sites - DocSearch for high-traffic or large docs
3. Use starlight-llms-txt - AI crawlers increasingly important for docs
4. Content Layer schema - Type-safe frontmatter prevents runtime errors
5. CSS custom properties - Override theme without component slots