playbooks

home / skills / bankkroll / skills-builder / astro

astro skill

/skills/astro

This skill helps you navigate Astro documentation, explain concepts, and implement best practices for Astro projects across content, islands, and deployments.

npx playbooks add skill bankkroll/skills-builder --skill astro

Review the files below or copy the command above to add this skill to your agents.

Files (63)
SKILL.md
10.3 KB
---
name: "astro"
description: "Scraped from https://docs.astro.build/ Source: https://docs.astro.build. Use when questions involve: en."
---

# Astro

> Official documentation: https://docs.astro.build

## Overview

This skill provides comprehensive documentation for astro.

**Total references:** 62 files (~804,839 tokens)

**Topics covered:**
Key Differences between Docusaurus and Astro, Imports fromastrotransitionsclient, Cloudflare Pages, Display unprocessed images with the HTMLimgtag, Intellisense for TypeScript, Mux Uploader, astro add, Content Collection Errors, Features, Where to store images, Imports fromastroassets, Redirects...

## Reference Files

Load only the reference files relevant to the user's question:

### En

- **[Astro Courses and more](references/en-1.md)** (~6,363 tokens)
  - Topics: Education Partners, Community learning resources, Component Structure
- **[Islands architecture and more](references/en-2.md)** (~7,286 tokens)
  - Topics: A brief history, What is an island, Island components
- **[Actions](references/en-3.md)** (~5,328 tokens)
  - Topics: Basic usage, Organizing actions, Handling returned data
- **[Astro DB and more](references/en-4.md)** (~6,585 tokens)
  - Topics: Installation, Define your database, Seed your database for development
- **[Firebase & Astro and more](references/en-5.md)** (~6,302 tokens)
  - Topics: Initializing Firebase in Astro, Adding authentication with Firebase, Connecting to Firestore database
- **[Supabase & Astro and more](references/en-6.md)** (~6,438 tokens)
  - Topics: Initializing Supabase in Astro, Adding authentication with Supabase, Community Resources
- **[Scripts and event handling and more](references/en-7.md)** (~7,542 tokens)
  - Topics: Client-Side Scripts, Script processing, Common script patterns
- **[ButterCMS & Astro and more](references/en-8.md)** (~7,016 tokens)
  - Topics: Integrating with Astro, Official Resources, Community Resources
- **[Cosmic & Astro and more](references/en-9.md)** (~5,993 tokens)
  - Topics: Prerequisites, Integrating Cosmic with Astro, Fetching Data from Cosmic
- **[Drupal & Astro and more](references/en-10.md)** (~7,904 tokens)
  - Topics: Prerequisites, Integrating Drupal with Astro, Fetching data from Drupal
- **[Hashnode & Astro and more](references/en-11.md)** (~7,828 tokens)
  - Topics: Integrating with Astro, Making a blog with Astro and Hashnode, Community Resources
- **[Payload CMS & Astro and more](references/en-12.md)** (~5,253 tokens)
  - Topics: Integrating with Astro, Building a blog with PayloadCMS and Astro, Community Resources
- **[Storyblok & Astro and more](references/en-13.md)** (~6,631 tokens)
  - Topics: Integrating with Astro, Making a blog with Astro and Storyblok, Official Resources
- **[Umbraco & Astro and more](references/en-14.md)** (~4,890 tokens)
  - Topics: Integrating with Astro, Building a blog with Umbraco and Astro, Publishing your site
- **[Content collections and more](references/en-15.md)** (~6,719 tokens)
  - Topics: What are Content Collections, TypeScript configuration for collections, Defining Collections
- **[Deploy your Astro Site to AWS and more](references/en-16.md)** (~6,713 tokens)
  - Topics: AWS Amplify, S3 static website hosting, S3 with CloudFront
- **[Deploy your Astro Site with Deno and more](references/en-17.md)** (~7,745 tokens)
  - Topics: Requirements, Project Configuration, How to deploy
- **[Deploy your Astro Site to Juno and more](references/en-18.md)** (~7,319 tokens)
  - Topics: Create your container, Configure your project, How to deploy
- **[Deploy your Astro Site to Zephyr Cloud and more](references/en-19.md)** (~6,981 tokens)
  - Topics: How to deploy, What happens during deployment, Official Resources
- **[Using environment variables and more](references/en-20.md)** (~4,470 tokens)
  - Topics: Vites built-in support, Default environment variables, Setting environment variables
- **[Images and more](references/en-21.md)** (~7,376 tokens)
  - Topics: Where to store images, Images inastrofiles, Images in Markdown files
- **[@astrojs/alpinejs and more](references/en-22.md)** (~6,992 tokens)
  - Topics: Installation, Configuration Options, Usage
- **[@astrojs/markdoc and more](references/en-23.md)** (~6,065 tokens)
  - Topics: Why Markdoc, Installation, Usage
- **[@astrojs/netlify and more](references/en-24.md)** (~7,274 tokens)
  - Topics: Why Astro Netlify, Installation, Usage
- **[@astrojs/react and more](references/en-25.md)** (~6,295 tokens)
  - Topics: Installation, Getting started, Integrate Actions withuseActionState
- **[@astrojs/vercel and more](references/en-26.md)** (~5,174 tokens)
  - Topics: Why Astro Vercel, Installation, Usage
- **[Internationalization (i18n) Routing and more](references/en-27.md)** (~6,892 tokens)
  - Topics: Routing Logic, Configure i18n routing, routing
- **[Mux & Astro and more](references/en-28.md)** (~7,775 tokens)
  - Topics: Using Mux in Astro, Prerequisites, Mux Player
- **[Migrating from Eleventy and more](references/en-29.md)** (~7,467 tokens)
  - Topics: Key Similarities between Eleventy 11ty and Astro, Key Differences between Eleventy 11ty and Astro, Switch from Eleventy to Astro
- **[Migrating from Jekyll and more](references/en-30.md)** (~4,487 tokens)
  - Topics: Key Similarities between Jekyll and Astro, Key Differences between Jekyll and Astro, Switch from Jekyll to Astro
- **[Migrating from NuxtJS and more](references/en-31.md)** (~7,928 tokens)
  - Topics: Key Similarities between Nuxt and Astro, Key Differences between Nuxt and Astro, Convert your NuxtJS Project
- **[On and more](references/en-32.md)** (~7,372 tokens)
  - Topics: Server adapters, Enabling on-demand rendering, On-demand rendering features
- **[Server islands and more](references/en-33.md)** (~6,682 tokens)
  - Topics: Server island components, Server island fallback content, How it works
- **[Syntax Highlighting and more](references/en-34.md)** (~6,396 tokens)
  - Topics: Markdown code blocks, Components for code blocks, Add a Prism stylesheet
- **[TypeScript and more](references/en-35.md)** (~7,541 tokens)
  - Topics: Setup, Type Imports, Import Aliases
- **[Upgrade to Astro v2](references/en-36.md)** (~2,450 tokens)
  - Topics: Upgrade Astro, Astro v20 Breaking Changes, Astro v20 Experimental Flags Removed
- **[Upgrade to Astro v3](references/en-37.md)** (~6,731 tokens)
  - Topics: Upgrade Astro, Astro v30 Experimental Flags Removed, Astro v30 Breaking Changes
- **[Upgrade to Astro v4](references/en-38.md)** (~2,862 tokens)
  - Topics: Upgrade Astro, Astro v40 Experimental Flags Removed, Upgrades
- **[Upgrade to Astro v5](references/en-39.md)** (~10,172 tokens)
  - Topics: Upgrade Astro, Dependency Upgrades, Legacy
- **[View transitions](references/en-40.md)** (~6,255 tokens)
  - Topics: Differences between browser-native view transitions and AstrosClientRouter, Enabling view transitions SPA mode, Transition Directives
- **[Install Astro and more](references/en-41.md)** (~7,355 tokens)
  - Topics: Prerequisites, Browser compatibility, Install from the CLI wizard
- **[Build your Astro site with Docker and more](references/en-42.md)** (~6,934 tokens)
  - Topics: Prerequisites, Creating a Dockerfile, Recipe
- **[Add an RSS feed and more](references/en-43.md)** (~5,852 tokens)
  - Topics: Setting upastrojsrss, Generatingitems, Removing trailing slashes
- **[Astro Adapter API](references/en-44.md)** (~5,822 tokens)
  - Topics: What is an adapter, Building an adapter, Building a server entrypoint
- **[Astro render context and more](references/en-45.md)** (~6,461 tokens)
  - Topics: The context object, JSX-like Expressions, Component utilities
- **[CLI Commands](references/en-46.md)** (~3,053 tokens)
  - Topics: astro dev, astro build, astro preview
- **[Configuration Reference](references/en-47.md)** (~8,563 tokens)
  - Topics: Top-Level Options, Build Options, Server Options
- **[Astro Container API (experimental) and more](references/en-48.md)** (~5,922 tokens)
  - Topics: create, renderToString, renderToResponse
- **[Dev Toolbar App API and more](references/en-49.md)** (~7,933 tokens)
  - Topics: Toolbar app integration setup, Structure of a Dev Toolbar App, Client-side Events
- **[Adapter does not support server output. and more](references/en-50.md)** (~8,100 tokens)
  - Topics: What went wrong, What went wrong, What went wrong
- **[No client entrypoint specified in renderer. and more](references/en-51.md)** (~6,362 tokens)
  - Topics: What went wrong, What went wrong, What went wrong
- **[Experimental fonts API and more](references/en-52.md)** (~5,387 tokens)
  - Topics: Usage, Available font providers, Usage examples
- **[Experimental live content collections and more](references/en-53.md)** (~7,595 tokens)
  - Topics: Basic usage, When to use live content collections, Using live collections
- **[Astro Integration API](references/en-54.md)** (~10,934 tokens)
  - Topics: Examples, Quick API Reference, Hooks
- **[Legacy flags and more](references/en-55.md)** (~3,386 tokens)
  - Topics: Collections, Imports fromastroactions, astroactionstypes
- **[Image and Assets API Reference and more](references/en-56.md)** (~7,091 tokens)
  - Topics: Imports fromastroassets, astroassetstypes, Imports fromastroassets
- **[Content Collections API Reference and more](references/en-57.md)** (~7,901 tokens)
  - Topics: Imports fromastrocontent, astrocontenttypes, Imports fromastroenv
- **[Zod API Reference and more](references/en-58.md)** (~7,963 tokens)
  - Topics: Imports fromastrozod, AstroInlineConfig, dev
- **[Deploy your site to the web and more](references/en-59.md)** (~6,852 tokens)
  - Topics: Checklist, Try it yourself - Add a Blog page, Try it yourself - Define CSS variables

### General

- **[Astro Docs](references/general-1.md)** (~57 tokens)
- **[Why Astro?](references/general-2.md)** (~413,427 tokens)
  - Topics: Features, Design Principles, A brief history
- **[Astro](references/general-3.md)** (~397 tokens)
  - Topics: Documentation Sets, Notes, Optional

## Usage Guidelines

1. **Identify relevant sections** - Match the user's question to the appropriate reference file(s)
2. **Load minimally** - Only read files directly relevant to the question to conserve context
3. **Cite sources** - Reference specific sections when answering
4. **Combine knowledge** - For complex questions, you may need multiple reference files

### When to use each reference:

- **En**: En-related features and documentation
- **General**: General documentation, overview, and getting started

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.

FAQ

Is this the official Astro documentation?

No. The content is compiled from the official docs at docs.astro.build but this skill is not an official Astro distribution.

Which topics are covered?

Core topics include installation, configuration, adapters, images, content collections, integrations (React, Netlify, Vercel), deployment recipes, migrations, and upgrade notes.

How current is the information?

The skill reflects the snapshot of the scraped documentation. For breaking changes or newest releases, cross-check the official docs at docs.astro.build.