astro_skill

Overview

This skill provides searchable, consolidated documentation and practical guidance derived from the official Astro docs (docs.astro.build). It helps developers find API details, configuration patterns, integration recipes, and migration guidance for building sites with Astro. Note: content is sourced from scraped docs and is not an official Astro release.

How this skill works

The skill inspects the Astro documentation set and returns concise explanations, examples, and links to relevant reference topics such as configuration, adapters, images, content collections, integrations, and deployment. It matches user questions to specific sections (install, routing, adapters, migrations, APIs) and synthesizes actionable steps and recommended settings. For complex scenarios it combines multiple docs (e.g., adapters + environment variables + deployment) to give end-to-end instructions.

When to use it

• You need quick answers about Astro CLI commands, config options, or build behavior.
• You are migrating from another static/site framework (Nuxt, Eleventy, Jekyll) and need mapping guidance.
• You want recipes for integrations (React, Netlify, Vercel, Supabase, Firebase, Mux).
• You must configure images, content collections, or TypeScript with Astro.
• You plan to deploy Astro to a platform (Cloud, Docker, Vercel, Netlify) and need adapter or environment guidance.

Best practices

• Use the provided CLI and configuration examples as starting points and adapt environment variables per deployment target.
• Follow recommended directory conventions for images and content collections to enable Astro’s image and content features.
• When adding renderers or integrations, declare client entry points and test dev/build flows to catch renderer errors early.
• Prefer incremental upgrades: consult the specific v2–v5 upgrade notes and run tests after each step.
• For performance, use islands/server islands only where interactivity is needed and keep other components static.

Example use cases

• Set up a new Astro project and follow install, TypeScript, and CSS guidance to get started.
• Migrate a blog from Eleventy or Jekyll: map templates, content collections, and build scripts.
• Deploy an Astro site to a cloud provider (S3+CloudFront, Vercel, Netlify, Zephyr) using the documented adapter and environment variable patterns.
• Integrate third-party services like Supabase, Firebase, or Mux with example initialization and usage snippets.
• Add advanced features: image handling (where to store images, Markdown/image usage), view transitions, or experimental fonts API.