Astro Advanced Skill

This skill provides production-grade guidance for Astro projects — from initial scaffolding through deployment, caching, and performance tuning. It covers the patterns that actually matter in real projects and the mistakes that actually happen.

How to use this skill

1. Read this file first for the core workflow and decision tree.
2. Consult the reference files in references/ for deep dives on specific topics:
   • references/setup-and-structure.md — Project creation, file structure, config, adapters
   • references/rendering-modes.md — SSG vs SSR vs Hybrid, when to use each, caching strategies
   • references/seo.md — Meta tags, Open Graph, JSON-LD, sitemaps, canonical URLs
   • references/islands-and-vue.md — Island architecture, client directives, Vue/React/Svelte integration
   • references/content-and-data.md — Content collections, data fetching, dynamic routes
   • references/deployment.md — Adapters, static hosts, serverless, environment variables
   • references/performance.md — Image optimization, bundle analysis, hydration control
   • references/troubleshooting.md — Common errors and fixes organized by symptom