astro-starlight-best-practices

Installation
SKILL.md

Astro + Starlight Best Practices

Use this skill for apps/eridu_docs and other Astro/Starlight doc surfaces.

Workflow

  1. Classify the change:
    • docs content + sidebar
    • Astro route/endpoint
    • SSR/auth middleware behavior
    • search/index behavior
    • Starlight UI override
  2. Pick the lowest-complexity rendering model that satisfies requirements.
  3. Keep content/schema/search decisions aligned with Starlight defaults unless there is a strong requirement to diverge.
  4. Verify the app with repo-standard commands before finalizing.

Guardrails

1) Rendering mode and prerender

Related skills
Installs
1
GitHub Stars
1
First Seen
Mar 31, 2026