Astro Framework Agents
Agent Skills for building with Astro. Compatible with Claude Code, Cursor, Cline, OpenAI Codex, and other agents supporting the Agent Skills specification.

Subscribe to Web Reactiva Newsletter — Weekly insights on web development, AI tools, and modern frameworks.
Why Astro?
Astro made me fall in love with web development again.
After years of complexity, heavy frameworks, and JavaScript fatigue, Astro reminded me that the web can be simple, fast, and beautiful. It embraces HTML as a first-class citizen. It ships zero JavaScript by default. It lets you use React, Vue, Svelte, or Solid—or none of them—without judgment.
Astro is plural: it welcomes every developer, every framework, every approach. Astro is universal: it works for blogs, docs, e-commerce, and everything in between. Astro is honest: it doesn't pretend the web is something it's not.
This repository is my way of sharing that love with the AI tools we use every day.
— Dani Primo
Available Skills
| Skill | Description | Install |
|---|
| astro-framework | Comprehensive Astro framework development guide for islands architecture, content collections, SSR, and view transitions | npx skills add delineas/astro-framework-agents/astro-framework |
| learning-astro | Interactive tutorial to learn Astro by building a personal blog — 3 guided lessons with concepts, reflections, and hands-on code | npx skills add delineas/astro-framework-agents/learning-astro |
Quick Start
Install a Single Skill
npx skills add https://github.com/delineas/astro-framework-agents --skill astro-framework
npx skills add https://github.com/delineas/astro-framework-agents --skill learning-astro
Manual Installation
Clone the repository and copy the desired skill folder to your agent's skills directory:
git clone https://github.com/delineas/astro-framework-agents.git
cp -r astro-framework-agents/skills/astro-framework ~/.claude/skills/
cp -r astro-framework-agents/skills/learning-astro ~/.claude/skills/
Repository Structure
astro-framework-agents/
├── README.md
├── LICENSE
└── skills/
├── astro-framework/ # Astro framework reference skill
│ ├── SKILL.md # Main skill instructions
│ ├── AGENTS.md # Compiled guidelines
│ ├── references/ # Detailed reference docs (14 files)
│ └── rules/ # Context-specific rules (9 files)
└── learning-astro/ # Interactive Astro tutorial skill
├── SKILL.md # Tutoring protocol and lesson structure
├── guides/ # Step-by-step lesson guides (3 lessons)
├── reflect/ # Reflection moments between parts (9 files)
├── concepts/ # Deep dives on Astro fundamentals (4 files)
└── help/ # Common errors and verification procedures
Skills Overview
astro-framework
A reference skill for experienced developers building with Astro. Covers islands architecture, content collections, SSR adapters, view transitions, server islands, sessions, actions, i18n, and more. Designed to be consulted while writing Astro code — it provides decision frameworks, code patterns, and rules for Astro 5+/6+.
learning-astro
An interactive tutorial skill that teaches Astro from scratch by building a personal blog. Designed for beginners and developers coming from other frameworks.
3 lessons (~45 min each):
- Your First Astro Site — Pages, components, layouts, styling
- Content & Dynamic Routes — Content collections, blog posts, RSS
- Interactivity & Launch — Islands, view transitions, deployment
How it works:
- Adapts to the user's experience level (beginner / knows other frameworks / knows Astro)
- Follows a Discover → Build → Reflect rhythm
- Uses the
astro-framework skill for technical accuracy
- Queries the Astro docs MCP for questions beyond the tutorial
Creating a New Skill
- Create a new directory under
skills/:
mkdir -p skills/my-new-skill
- Create the required
SKILL.md with frontmatter:
---
name: my-new-skill
description: Description of what this skill does and when to use it.
license: MIT
metadata:
author: your-name
version: "1.0.0"
---
# My New Skill
Instructions for the agent...
-
(Optional) Add supporting files:
references/ - Detailed reference documentation
rules/ - Context-specific rules with glob patterns
-
Update this README to include your new skill in the table.
Skill Format Specification