# astro

Скилл для работы с фреймворком Astro: страницы, компоненты, адаптеры SSR, коллекции контента и деплой. Пригодится, когда проект уже на Astro или вы только начинаете его.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 18200 установок · ★ 13
- Автор: astrolicious
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/astrolicious/agent-skills/tree/HEAD/skills/astro/SKILL.md
- Обновлён: 2026-03-20
- HTML: https://affpapa.org/nevibecode/skills/astrolicious-astro

## Что делает

Скилл даёт агенту справочник по Astro: где лежит конфиг, какие есть CLI-команды, как устроена структура проекта. Внутри — таблица опций конфига, примеры `astro.config.ts`, страницы и компонента, пошаговый деплой через адаптер.

Адаптеры добавляются командой вида `npx astro add vercel --yes`, есть варианты для `node`, `cloudflare`, `netlify`. После смены плагинов справочник советует перезапускать `npx astro sync`, иначе типы для модулей останутся старыми. Перед сборкой стоит прогнать `npx astro check` — он ловит ошибки типов и конфигурации раньше, чем `npx astro build`.

Каталог `src/pages` обязателен: без него маршруты не построятся, остальные папки вроде `src/components` и `src/layouts` — просто соглашение. Скилл не заменяет документацию, а отсылает к `docs.astro.build` за актуальным API, поэтому для свежих версий фреймворка сверяйтесь с первоисточником.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astrolicious/agent-skills --skill astro -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/astro/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/astro/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astrolicious/agent-skills --skill astro -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/astro/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astrolicious/agent-skills --skill astro -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/astro/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install astrolicious/agent-skills astro
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/astro/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astrolicious/agent-skills --skill astro -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/astrolicious/agent-skills --path skills/astro
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/astro/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add astrolicious/agent-skills --skill astro -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/astrolicious/agent-skills/tree/HEAD/skills/astro/SKILL.md

## Когда брать
- создать страницу и компонент в проекте на Astro
- подключить адаптер для Vercel, Netlify, Cloudflare или Node
- настроить коллекции контента и типы модулей
- разобраться в структуре каталогов Astro-проекта
- собрать статический сайт и проверить его перед деплоем

## Примеры запросов агенту
- добавь адаптер vercel в мой Astro-проект и объясни шаги деплоя
- создай страницу `src/pages/about.astro` с заголовком и текстом
- почему `npx astro check` ругается на типы после установки плагина?

## Похожие
- [astro-framework](https://affpapa.org/nevibecode/skills/astro-framework.md) — скилл · 2200 установок
- [clerk-astro-patterns](https://affpapa.org/nevibecode/skills/clerk-astro-patterns.md) — скилл · 14300 установок
- [sveltekit](https://affpapa.org/nevibecode/skills/claude-mpm-team-sveltekit.md) — скилл · 441 установка
- [setting-up-astro-project](https://affpapa.org/nevibecode/skills/setting-up-astro-project.md) — скилл · 1100 установок
- [managing-astro-deployments](https://affpapa.org/nevibecode/skills/managing-astro-deployments.md) — скилл · 567 установок
- [netlify-frameworks](https://affpapa.org/nevibecode/skills/netlify-frameworks.md) — скилл · 3200 установок

## Другие версии с тем же именем
- [astro · mindrally](https://affpapa.org/nevibecode/skills/mindrally-astro.md) — 886 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md