Astro Dev

Documentation Strategy

This skill works best alongside the Astro Docs MCP (search_astro_docs()). The MCP handles single-concept lookups (API details, config options). This skill handles what MCP can't: guardrails that catch wrong code before it's generated, multi-concept patterns that require combining several features, and decision frameworks for choosing between approaches.

MCP-first workflow

1. For "how does X work?" → Use MCP: search_astro_docs({ query: "X" })
2. For "what's the right pattern for X?" → Use this skill's reference files
3. Before generating any Astro code → Check the guardrails below to avoid known mistakes
4. No MCP available? → Fall back to references/doc-endpoints.md for LLM-optimized doc URLs

Quick Router — Read the right file for your task