astro skill for Claude Code: build and deploy Astro sites

Gives Claude a quick reference for building Astro sites: pages, components, CLI commands and deploy adapters.

Installs: 18.7K; on skills.sh
Stars: 13; on GitHub
Updated: Mar 2026; last repo commit

The astro skill is a short guide that tells Claude how an Astro project is laid out and which commands to run. It covers the npx astro commands, the src/pages and src/components folders, a minimal astro.config.ts, and a five-step adapter deploy flow. It points Claude to docs.astro.build for code examples and the latest API.

It loads when you mention .astro files, static site generation, islands architecture, content collections or deploying an Astro project. It bundles no scripts. Claude runs npx astro commands in your project, and the adapter step uses --yes.

Good for

Developers building or maintaining an Astro site with Claude Code
Anyone adding a Node, Vercel, Netlify or Cloudflare adapter to an Astro project

Install astro

Claude Code

Copy this prompt.

Install the astro skill in Claude Code. Run this command:

npx skills add https://github.com/astrolicious/agent-skills --skill astro

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The skill has Claude run npx astro commands in your Astro project, so we store no Claude app upload for it.

From the vendor's docs. Source.

What's in the skill

When it loads

Skill for building with the Astro web framework. Helps create Astro components and pages, configure SSR adapters, set up content collections, deploy static sites, and manage project structure and CLI commands. Use when the user needs to work with Astro, mentions .astro files, asks about static site generation (SSG), islands architecture, content collections, or deploying an Astro project.

Sections in SKILL.md

Quick Reference
File Location
CLI Commands
Project Structure
Core Config Options
Example astro.config.ts
Common Workflows
Creating a Basic Page
Creating a Component
Deploying with an Adapter
Adapters
Resources

Key facts

Author: SKILL.md frontmatter lists "Astro Team"; the repo is under the astrolicious GitHub organization
License: MIT in SKILL.md frontmatter; the repo has no LICENSE file
Installs on skills.sh: 18,651 as of 2026-11-02
GitHub stars: 13 for the repo, 2026-11-02
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
What is inside: 1 file: SKILL.md (the repo has 2 files: its README and this skill)
Needs: An Astro project and Node, since the skill runs npx astro commands
Last repo commit: 2026-03-20

What it includes

Five npx astro commands: dev, build, check, add, sync
Claude starts the dev server, builds to disk, checks for errors, adds an integration or generates TypeScript types. SKILL.md says to re-run sync after adding or changing plugins.
Try: “Run astro check and tell me what is wrong.”
Runs code · CLI commands
Where pages, components, layouts and config live
src/pages is required and defines routes. Components, layouts, styles, public/, package.json and the astro.config file follow the conventions listed.
Read · Project structure
The site option in astro.config.ts
An example sets site to your deployed URL, which SKILL.md says is used for sitemaps and canonical URLs.
Write · Core config
Minimal .astro examples
A file in src/pages becomes a route. A component takes its title and body from Astro.props.
Try: “Add an About page to my Astro site.”
Write · Create a page or component
Add the adapter, check, build, verify, deploy
Five steps: run npx astro add with vercel, node, cloudflare or netlify, run astro check, run astro build, confirm the output folder is not empty, then deploy as the adapter docs describe.
Try: “Add the Vercel adapter and build the site.”
Runs code · Deploy with an adapter
Tells Claude to read docs.astro.build first
SKILL.md says to always consult docs.astro.build for code examples and the latest API, and lists the config reference and llms.txt.
Network · Docs pointer

From the official docs

Permissions

Medium risk

Claude runs npx astro commands in your project and edits its files. Use a git branch and check the changes before you commit or deploy.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The adapter step skips prompts
SKILL.md tells Claude to run npx astro add with --yes. Work on a git branch and review the changes before you commit. github.com
The deploy flow ends with a deploy
Step 5 says to deploy the output per the adapter's documentation. Tell Claude to stop after the build if you want to deploy yourself. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md defines no read-only mode. astro check and astro dev are the commands that only inspect or serve.
Talks to	docs.astro.build
Scopes	Claude runs npx astro dev, build, check, add and sync in your project Claude creates and edits .astro files, config and package setup when you ask for pages or an adapter Step 5 of the deploy flow deploys the build output to your host, per the adapter documentation

Questions

What does the astro skill do?

It gives Claude a compact guide to Astro: the CLI commands, project folders, a minimal config, page and component examples, and how to add a deploy adapter.

How do I install it?

Use the install box at the top of the page. We store no Claude app upload for it because it works through npx commands in your Astro project.

Is this the official Astro skill?

Treat it as a community skill. The SKILL.md frontmatter lists "Astro Team" as author, but the repo is under the astrolicious GitHub organization, not withastro (the Astro project's own organization, which hosts github.com/withastro/astro). The astrolicious org has no profile description and is not GitHub-verified, and the repo README lists only credits. Check docs.astro.build for official guidance.

Does it need an API key?

SKILL.md names no API key. Deploying with an adapter may need a login with your host, which the adapter's own docs cover.

Is the astro skill safe?

It bundles no scripts, but it has Claude run npx astro commands in your project. The adapter step passes --yes, so Claude does not stop for prompts there. Work on a branch and review what changed before you commit or deploy.

Does it cover Astro content collections?

The description mentions content collections, but the body of SKILL.md has no section on them. It sends Claude to docs.astro.build for details.

Information

updated Nov 2, 2026

Repository: astrolicious/agent-skills
Folder: skills/astro

astrolicious/agent-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 1

astro SKILL.md · github.com