К основному содержанию
скилл CX Codex

astro-sites-manager — скилл для Claude Code

Скилл astro-sites-manager помогает создавать и обновлять проекты на Astro v7, настраивать фоновый dev-сервер для агентов и связываться с MCP-сервером astro-docs.

Apache-2.0 ★ 141 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fabricioctelles/skills --skill astro-sites-manager -a claude-code
Открыть на GitHub

Что делает astro-sites-manager

Скилл инструктирует агента по стандартам Astro v7: от архитектуры островов и директив гидратации client:* до работы с коллекциями контента в content.config.ts. Для проверки актуальных API он сначала ищет MCP-инструмент search_astro_docs из сервера astro-docs, а при его отсутствии опирается на встроенные правила и документацию.

В процессы заложена специфика автономной работы ИИ-агентов: вместо стандартного блокирующего запуска предлагается команда astro dev --background. Сервер запускается в фоне с защитой от дублей через lockfile и проверяется запросом к эндпоинту /_astro/status.

Без установленного Node.js и самого пакета Astro команды запуска и валидации работать не будут. Скилл также предписывает запускать astro check перед коммитами и генерировать типы вызовом astro sync.

Какие задачи решает

  • Перевести проект с Astro v6 на v7 без устаревших паттернов
  • Запустить dev-сервер Astro в фоновом режиме для автономных агентов
  • Настроить кэширование маршрутов и парсер Sätteri Markdown
  • Сгенерировать схемы коллекций контента и проверить типы через astro check

Примеры запросов агенту

  • Проверь проект и подскажи, как перевести его с Astro v6 на Astro v7
  • Запусти Astro dev-сервер в фоновом режиме и проверь статус через эндпоинт
  • Настрой кэширование страниц блога в astro.config.mjs с помощью memoryCache

Как установить astro-sites-manager

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill astro-sites-manager -a claude-code

2Вручную: положить файлы

~/.claude/skills/astro-sites-manager/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/astro-sites-manager/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об astro-sites-manager

Как установить astro-sites-manager в Claude Code?

Выполните команду npx skills add fabricioctelles/skills --skill astro-sites-manager -a claude-code.

Зачем скиллу нужен MCP-сервер astro-docs?

Перед ответом скилл обращается к инструменту search_astro_docs, чтобы получить актуальные данные из официальной документации Astro, используя её как единый источник правды.

Чем полезен фоновый режим dev-сервера?

Команда astro dev --background запускает сервер в отсоединённом процессе, не блокирует консоль агента и позволяет опрашивать статус через /_astro/status.

Исходный текст

SKILL.md · Apache-2.0
---
name: astro-sites-manager
description: >
  Comprehensive skill for building, migrating, and maintaining Astro v7
  projects. Covers best practices from the official AGENTS.md, the v6→v7
  migration path, validation of breaking/deprecated patterns, AI-enhanced dev
  server usage (background mode, JSON logging), advanced routing with
  src/fetch.ts, route caching, Sätteri Markdown, and the Rust compiler. Use
  when the user mentions 'Astro', '.astro files', 'astro dev', 'astro build',
  'islands architecture', 'content collections', 'SSG', 'SSR adapter',
  'upgrade to Astro 7', 'migrate Astro', 'Astro v7', 'Astro v6', 'Sätteri',
  'route caching', 'Astro.cache', 'astro dev --background', 'src/fetch.ts',
  'advanced routing', 'Hono + Astro', 'Rolldown', 'Vite 8', 'queued
  rendering', 'CDN cache provider', 'Astro AI', 'related content',
  'related posts', 'vector embeddings Astro', 'astro-related-content',
  or asks about static site generation with Astro.
metadata:
  author: ft.ia.br
  version: "1.0.0"
  date: 2026-06-22
  repository: https://github.com/fabricioctelles/skills
  license: Apache-2.0
  category: ci-cd-and-deployment
---

# Astro Framework — v7

## MCP Documentation Access

This skill works alongside the **Astro Docs MCP server**. Before answering Astro questions, check if the `astro-docs` MCP tool is available and query it for the latest documentation. The MCP server provides real-time access to docs.astro.build and is the single source of truth for current APIs.

```
MCP Server: astro-docs
Tool: search_astro_docs
```

If the MCP server is unavailable, fall back to the reference material in this skill and https://docs.astro.build.

---

## Best Practices

### Component Design
- One `.astro` component per file. Keep components small and focused.
- Use frontmatter (`---`) for data fetching and logic; template below for markup only.
- Prefer Astro components over framework components unless client interactivity is needed.
- Use `client:*` directives sparingly — each adds JavaScript to the bundle.
- Directive hierarchy: `client:idle` > `client:visible` > `client:load` (prefer lazy).

### Routing & Pages
- Use file-based routing in `src/pages/`. Dynamic routes: `[slug].astro`, `[...path].astro`.
- Always export `getStaticPaths()` for prerendered dynamic routes.
- For SSR pages: `export const prerender = false` at the top.
- Use `src/fetch.ts` (v7) only when you need control beyond middleware — don't use it for simple auth.

### Content Collections
- Define schemas in `content.config.ts` with Zod — never trust untyped content.
- Use `getCollection()` for lists, `getEntry()` for single items.
- Prefer `glob()` loader for local files, custom loaders for CMS data.

### Performance
- Default to static (`prerender = true`). Use SSR only for personalized/dynamic content.
- Use `<Image />` from `astro:assets` — never raw `<img>` for local images.
- Prefer Sätteri (default v7) over unified for Markdown — it's significantly faster.
- Use Server Islands (`server:defer`) for mixing static shells with dynamic fragments.

### Styling
- Scoped `<style>` in `.astro` files is default and preferred.
- Use `is:global` only when truly needed (third-party component styling).
- Tailwind: install with `astro add tailwind`, don't configure manually.

### TypeScript
- Run `astro sync` after changing content schemas or env variables.
- Run `astro check` before committing — catches template type errors other tools miss.
- Use `astro:env/server` and `astro:env/client` for typed env variables (never `process.env` directly).

### Development Workflow
- Use `astro dev` for HMR. Never use `python -m http.server` or other static servers.
- Use `astro add` for official integrations — don't manually edit config for them.
- Use `astro build && astro preview` to test production behavior locally.
- In AI agent workflows: use `astro dev --background` and validate via `/_astro/status`.

---

## CLI Commands

```bash
npx astro dev              # Dev server (foreground)
npx astro dev --background # Dev server (detached, for AI agents)
npx astro dev --json       # Dev server with JSON structured logs
npx astro build            # Production build
npx astro preview          # Serve production build locally
npx astro check            # Type checking and diagnostics
npx astro sync             # Generate TypeScript types
npx astro add <integration># Install and configure integration
```

### Background Dev Server (AI Agents)

When working as an AI agent, use background mode:

```bash
# Start (blocks until ready, then detaches)
astro dev --background
# → Dev server running at http://localhost:4321 (pid 12345)

# Check status
astro dev status

# Read logs
astro dev logs

# Stop
astro dev stop

# Health check endpoint (JSON)
curl http://localhost:4321/_astro/status
# → {"ok": true}
```

**Key behaviors:**
- Lockfile prevents duplicate instances — starting again returns existing instance
- All commands are idempotent (stop when not running = silent success)
- Auto-detected when running inside an AI agent (no flag needed)
- Opt out: `ASTRO_DEV_BACKGROUND=0 astro dev`

---

## Project Structure

```
src/
├── pages/          # File-based routing (.astro, .md, .mdx)
├── layouts/        # Reusable page layouts
├── components/     # Astro & framework components
├── content/        # Content collections (type-safe)
├── middleware.ts   # Request middleware
├── fetch.ts        # Advanced routing (v7, optional)
├── styles/         # Global CSS
├── assets/         # Optimized assets (images, fonts)
├── actions/        # Server actions
└── env.d.ts        # Environment type declarations
astro.config.mjs    # Main configuration
content.config.ts   # Content collection schemas
tsconfig.json       # TypeScript config
```

---

## Configuration (v7)

```typescript
import { defineConfig, memoryCache, logHandlers } from 'astro/config';

export default defineConfig({
  // Output mode
  output: 'static', // or configure per-page with server adapter

  // Route caching (stable in v7)
  cache: {
    provider: memoryCache(),
  },
  routeRules: {
    '/blog/[...path]': { maxAge: 300, swr: 60 },
  },

  // Logger (stable in v7)
  logger: logHandlers.json(), // or .console(), or .compose(...)

  // Markdown (Sätteri is default in v7)
  markdown: {
    // No config needed for defaults (GFM, smartypants, heading IDs)
    // For extra features:
    // processor: satteri({ features: { directive: true, math: true } })
  },

  // Advanced routing file (default: src/fetch.ts)
  // fetchFile: null, // disable if src/fetch.ts is used for other purposes

  // Whitespace (v7 default: 'jsx')
  compressHTML: 'jsx', // or true (v6 behavior), or false (preserve all)
});
```

---

## Islands Architecture (client:* directives)

```astro
<!-- Load immediately (interactive above the fold) -->
<Counter client:load />

<!-- Load when browser is idle (non-critical interactivity) -->
<Newsletter client:idle />

<!-- Load when scrolled into viewport (below the fold) -->
<Comments client:visible />

<!-- Load on media query match (mobile-only widget) -->
<MobileMenu client:media="(max-width: 768px)" />

<!-- Client-only, skip SSR entirely (browser APIs needed) -->
<MapWidget client:only="react" />

<!-- Server Island: static shell, fetched at request time (v6+) -->
<UserGreeting server:defer />
```

**Decision guide:** No directive (default) = zero JS, static HTML. Add directive only when user interaction is required.

---

## Image Optimization

```astro
---
import { Image } from 'astro:assets';
import heroImage from '../assets/hero.jpg';
---
<!-- Local image (optimized, lazy-loaded, responsive) -->
<Image src={heroImage} alt="Hero" width={1200} />

<!-- Remote image (must allowlist domain in config) -->
<Image src="https://cdn.example.com/photo.jpg" alt="Photo" width={800} height={600} />
```

Config for remote images:
```typescript
// astro.config.mjs
image: {
  domains: ['cdn.example.com'],
  remotePatterns: [{ protocol: 'https', hostname: '**.cloudinary.com' }],
}
```

---

## Detailed References

- [Install MCP Server](references/install-mcp.md) — Setup Astro Docs MCP for any AI tool (Kiro, Claude, Cursor, VS Code, etc.)
- [Migration Guide v6→v7](references/migration-v6-to-v7.md) — Step-by-step upgrade plan with breaking changes checklist
- [Validation Checklist](references/validation-checklist.md) — Verify installation, detect breaking/deprecated patterns
- [AI Dev Server](references/ai-dev-server.md) — Background mode, JSON logging, agent detection
- [Astro v7 Features](references/v7-features.md) — Rust compiler, Sätteri, Advanced Routing, Route Caching, CDN providers
- [Astro v6 Features](references/v6-features.md) — Content Collections v2, Actions, Sessions, Server Islands, env module
- [Related Content](references/related-content.md) — Vector embeddings para posts relacionados, deploy leve no Coolify sem modelo
- [Testing](references/testing.md) — Vitest components, Playwright E2E, link checking, CI pipeline
- [SEO Full Stack](references/seo-full-stack.md) — JSON-LD graph, agent discovery, IndexNow, OG images, build-time validation, performance
- [Starlight & Patterns](references/starlight-and-patterns.md) — Docs sites, Pagefind search, i18n, pagination, RSS
- [Deployment](references/deployment.md) — Cloudflare, Vercel, Netlify, Firebase, GitHub Pages, Docker/Coolify, Azure
- [Coolify Deploy](references/coolify-deploy.md) — Self-hosted deploy on Coolify (Dockerfile, API, gotchas, recommended stack)

© ft.ia.br · Apache-2.0 · fabricioctelles/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
astro astrolicious Страницы, компоненты, адаптеры SSR, коллекции контента и деплой на Astro. Покрывает старт проекта и работу с существующим. CX Codex +1 20 000установок astro-framework delineas Скилл astro-framework для Claude Code и других агентов: разбирается в islands architecture, гидратации и Content Layer API. Решает, что рендерить на сервере, а что в браузере, когда проект на Astro растёт. CX Codex +1 2 200установок clerk-astro-patterns clerk Скилл clerk-astro-patterns для Claude Code подсказывает правила интеграции аутентификации Clerk в проекты на Astro 5. Помогает настроить middleware, серверный рендеринг и островные компоненты. CX Codex +1 15 000установок integration-astro-ssr PostHog Скилл integration-astro-ssr встраивает аналитику PostHog в SSR-проекты на Astro с API-роутами. Помогает связать клиентские и серверные события. CX Codex +1 109установок astro-expert 0xfurai Субагент astro-expert помогает проектировать сайты на Astro, настраивать коллекции контента и ускорять сборку страниц. CX Codex ★ 1 029звёзд репо astro-best-practices incluud Скилл astro-best-practices для Claude Code задаёт правила разработки и проверки проектов на Astro: гидратация, схемы контента и доступность интерфейса. CX Codex +1 675установок

Из того же набора46

Весь набор →
design-md-validator Скилл design-md-validator проверяет DESIGN.md на соответствие спецификации Google через CLI-линтер @google/design.md. Находит битые ссылки на токены и считает контраст по WCAG. CX Codex +1 ★ 141звёзд репо humanizar Скилл humanizar редактирует и пишет тексты на бразильском португальском без штампов нейросетей, строго сохраняя факты автора. CX Codex +1 ★ 141звёзд репо agent-plugin-eval Скилл agent-plugin-eval для Claude Code проверяет Agent Plugins по спецификации, выставляет оценку и сравнивает два репозитория. Задача — ревью перед выпуском. CX Codex +1 ★ 141звёзд репо loop-architect Скилл loop-architect проектирует агент-луп с проверкой по best practice и кросс-модельными воротами рецензирования. Помогает, если нужно построить итеративный рабочий процесс, self-review луп, LLM-as-judge или многомодельный совет. CX Codex +1 ★ 141звёзд репо ralph-loop-kiro-specs Скилл ralph-loop-kiro-specs запускает kiro-cli в цикле и берёт по одной задаче из спеки Kiro за итерацию. Пригодится, чтобы автоматизировать выполнение задач и проверку критериев выхода. CX Codex +1 ★ 141звёзд репо security-specialist Скилл security-specialist запускает аудит кодовой базы, строит модель угроз, находит подтверждённые уязвимости и оформляет отчёт в HTML. Помогает проверить репозиторий или пулреквест на эксплуатируемые ошибки. CX Codex +1 ★ 141звёзд репо human-ai Скилл human-ai редактирует английскую прозу: убирает шаблонные AI-обороты и сохраняет смысл, голос автора и фактические детали. CX Codex +1 ★ 141звёзд репо skill-evaluation Скилл skill-evaluation оценивает агентский скилл по методике, собранной из рекомендаций Anthropic для Claude Code и доклада Matt Pocock «How to Write Great Skills». Выдаёт скоркард по 4 осям с баллами 0–100 и ссылками на строки SKILL.md. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой