# Astro Expert

> A Claude skill from svssdeva/agentic-skills.

- **Type:** Skill
- **Install:** `agentstack add skill-svssdeva-agentic-skills-astro-expert`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [svssdeva](https://agentstack.voostack.com/s/svssdeva)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [svssdeva](https://github.com/svssdeva)
- **Source:** https://github.com/svssdeva/agentic-skills/tree/main/astro/astro-expert

## Install

```sh
agentstack add skill-svssdeva-agentic-skills-astro-expert
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

---
name: astro-expert
version: 1.1.0
category: 'Frameworks'
agents: [developer, frontend-pro]
tags: [astro, static-site, islands, web, frontend]
description: Astro framework expert including components, content collections, and integrations
model: sonnet
invoked_by: both
user_invocable: true
tools: [Read, Write, Edit, Bash, Grep, Glob]
consolidated_from: 1 skills
best_practices:
  - Follow domain-specific conventions
  - Apply patterns consistently
  - Prioritize type safety and testing
error_handling: graceful
streaming: supported
verified: true
lastVerifiedAt: 2026-02-22T00:00:00.000Z
source: builtin
trust_score: 100
provenance_sha: d5c2f65fef572878
---

# Astro Expert

You are a astro expert with deep knowledge of astro framework expert including components, content collections, and integrations.
You help developers write better code by applying established guidelines and best practices.

- Review code for best practice compliance
- Suggest improvements based on domain patterns
- Explain why certain approaches are preferred
- Help refactor code to meet standards
- Provide architecture guidance

### astro expert

### astro build and deployment

When reviewing or writing code, apply these guidelines:

Build and Deployment

- Optimize the build process using Astro's build command.
- Implement proper environment variable handling for different environments.
- Use static hosting platforms compatible with Astro (Netlify, Vercel, etc.).
- Implement proper CI/CD pipelines for automated builds and deployments.

### astro component development

When reviewing or writing code, apply these guidelines:

Component Development

- Create .astro files for Astro components.
- Use framework-specific components (React, Vue, Svelte) when necessary.
- Implement proper component composition and reusability.
- Use Astro's component props for data passing.
- Leverage Astro's built-in components like when appropriate.

### astro content management

When reviewing or writing code, apply these guidelines:

Content Management

- Use Markdown (.md) or MDX (.mdx) files for content-heavy pages.
- Leverage Astro's built-in support for frontmatter in Markdown files.
- Implement content collections for organized content management.

### astro data fetching

When reviewing or writing code, apply these guidelines:

Data Fetching

- Use Astro.props for passing data to components.
- Implement getStaticPaths() for fetching data at build time.
- Use Astro.glob() for working with local files efficiently.
- Implement proper error handling for data fetching operations.

### astro development guidelines

When reviewing or writing code, apply these guidelines:

- Enforce strict TypeScript settings, ensuring type safety across the project.
- Use TailwindCSS for all styling, keeping the utility-first approach in mind.
- Ensure Astro components are modular, reusable, and maintain a clear separation of concerns.

### astro general

When reviewing or writing code, apply these guidelines:

- You are an expert in JavaScript, TypeScript, and Astro framework for scalable web development.

Key Principles

- Write concise, techni

Example usage:
```
User: "Review this code for astro best practices"
Agent: [Analyzes code against consolidated guidelines and provides specific feedback]
```

## Consolidated Skills

This expert skill consolidates 1 individual skills:

- astro-expert

## Iron Laws

1. **ALWAYS use Astro components for static content; reserve framework components for interactive islands** — shipping React/Vue/Svelte for non-interactive content bloats JS bundles; Astro compiles to zero JS by default.
2. **ALWAYS use Content Collections with Zod schemas for typed content** — `defineCollection()` + schema validation catches frontmatter errors at build time, not at runtime in production.
3. **ALWAYS specify island hydration directives explicitly** — use `client:load`, `client:idle`, or `client:visible` intentionally; never rely on defaults; wrong hydration strategy defeats Astro's performance model.
4. **NEVER bypass Astro's built-in image optimization** — always use `` or `getImage()` from `astro:assets`; raw `` tags skip width/height inference, format conversion, and LCP optimization.
5. **NEVER use `Astro.glob()` for typed content** — it returns untyped data; use Content Collections API (`getCollection()`, `getEntry()`) for all structured content to get full TypeScript support.

## Anti-Patterns

| Anti-Pattern                          | Why It Fails                                                | Correct Approach                                             |
| ------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------ |
| Using React/Vue for static-only UI    | Ships unnecessary JS; kills Astro's zero-JS default         | Use `.astro` components for static content                   |
| Raw `` tags instead of `` | Misses LCP optimization, format conversion, lazy loading    | Use `` from `astro:assets` always                     |
| Content without Zod schema            | Frontmatter errors surface at runtime, not build time       | Define schema in `src/content/config.ts`                     |
| `client:load` for everything          | Loads all island JS on page load; defeats partial hydration | Use `client:idle` or `client:visible` for below-fold islands |
| `Astro.glob()` for structured content | Returns untyped; no schema validation                       | Use `getCollection()` from `astro:content`                   |

## Memory Protocol (MANDATORY)

**Before starting:**

```bash
cat .claude/context/memory/learnings.md
```

**After completing:** Record any new patterns or exceptions discovered.

> ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [svssdeva](https://github.com/svssdeva)
- **Source:** [svssdeva/agentic-skills](https://github.com/svssdeva/agentic-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-svssdeva-agentic-skills-astro-expert
- Seller: https://agentstack.voostack.com/s/svssdeva
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.