astro-framework-agents

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 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](https://agentskills.io).

[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-blue)](https://agentskills.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

---

**[Subscribe to Web Reactiva Newsletter](https://webreactiva.com/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](https://webreactiva.com)

---

## Available Skills

| Skill | Description | Install |
|-------|-------------|---------|
| [astro-framework](https://github.com/delineas/astro-framework-agents/tree/HEAD/skills/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](https://github.com/delineas/astro-framework-agents/tree/HEAD/skills/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

```bash
npx skills add https://github.com/delineas/astro-framework-agents --skill astro-framework
```

```bash
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:

```bash
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):**
1. **Your First Astro Site** — Pages, components, layouts, styling
2. **Content & Dynamic Routes** — Content collections, blog posts, RSS
3. **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

1. Create a new directory under `skills/`:

```bash
mkdir -p skills/my-new-skill
```

2. Create the required `SKILL.md` with frontmatter:

```yaml
---
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...
```

3. (Optional) Add supporting files:
   - `references/` - Detailed reference documentation
   - `rules/` - Context-specific rules with glob patterns

4. Update this README to include your new skill in the table.

## Skill Format Specification

Each skill follows the [Agent Skills Specification](https://agentskills.io/specification):

### Required Files

- `SKILL.md` - Main skill file with YAML frontmatter and instructions

### Required Frontmatter

```yaml
---
name: skill-name          # Must match directory name
description: "..."        # What it does and when to use it
---
```

### Optional Frontmatter

```yaml
---
license: MIT
metadata:
  author: your-name
  version: "1.0.0"
  category: framework
  tags: tag1, tag2
compatibility: Requires Node.js 18+
allowed-tools: Bash(npm:*) Read
---
```

## Compatibility

These skills are compatible with:

| Agent | Status |
|-------|--------|
| Claude Code | Fully supported |
| Cursor | Fully supported |
| Cline | Fully supported |
| OpenAI Codex | Compatible |
| GitHub Copilot | Compatible |
| Windsurf | Compatible |

## Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a new skill in `skills/your-skill-name/`
3. Follow the [Agent Skills Specification](https://agentskills.io/specification)
4. Add your skill to the table in this README
5. Submit a pull request

### Guidelines

- Keep `SKILL.md` under 500 lines (use `references/` for detailed docs)
- Use progressive disclosure (metadata → instructions → references)
- Include clear examples in your instructions
- Add `rules/` files with glob patterns for context-specific guidance

## License

MIT License - see [LICENSE](https://github.com/delineas/astro-framework-agents/tree/HEAD/LICENSE) for details.

## Resources

- [Agent Skills Specification](https://agentskills.io/specification)
- [Skills.sh Directory](https://skills.sh)
- [Anthropic Skills Repository](https://github.com/anthropics/skills)
- [Vercel Agent Skills](https://github.com/vercel-labs/agent-skills)

---

Built with love for Astro and the open web and the Malandriner Community

Made by [Dani Primo](https://webreactiva.com) — [@webreactiva-devs](https://github.com/webreactiva-devs)

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

Each skill follows the Agent Skills Specification:

Required Files

SKILL.md - Main skill file with YAML frontmatter and instructions

Required Frontmatter

---
name: skill-name          # Must match directory name
description: "..."        # What it does and when to use it
---

Optional Frontmatter

---
license: MIT
metadata:
  author: your-name
  version: "1.0.0"
  category: framework
  tags: tag1, tag2
compatibility: Requires Node.js 18+
allowed-tools: Bash(npm:*) Read
---

Compatibility

These skills are compatible with:

Agent	Status
Claude Code	Fully supported
Cursor	Fully supported
Cline	Fully supported
OpenAI Codex	Compatible
GitHub Copilot	Compatible
Windsurf	Compatible

Contributing

Contributions are welcome! Please:

Fork the repository
Create a new skill in skills/your-skill-name/
Follow the Agent Skills Specification
Add your skill to the table in this README
Submit a pull request

Guidelines

Keep SKILL.md under 500 lines (use references/ for detailed docs)
Use progressive disclosure (metadata → instructions → references)
Include clear examples in your instructions
Add rules/ files with glob patterns for context-specific guidance

License

MIT License - see LICENSE for details.

Resources

Built with love for Astro and the open web and the Malandriner Community

Made by Dani Primo — @webreactiva-devs