Skip to main content
subagent CX Codex

astro-expert — Claude Code subagent: what it does, how to install

astro-expert is a Claude Code subagent for planning Astro architecture, organizing content collections, and optimizing static site performance.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/astro-expert.md
Open on GitHub

What astro-expert does

This subagent focuses on Astro site development. It guides component layout planning, routing setup, content collection organization, and server-side rendering configurations.

The definition specifies claude-sonnet-4-20250514 as the underlying model. Instructions cover handling Markdown and MDX data, tuning media assets for fast delivery, and auditing semantic HTML structure before deployment.

Because the definition pins claude-sonnet-4-20250514, your environment needs access to this model identifier to run it as configured.

What it helps with

  • Structure reusable Astro templates and page layouts cleanly
  • Configure content collections using Markdown or MDX sources
  • Optimize image assets and static bundles for lighthouse audits
  • Set up server-side rendering and external API integrations

Example prompts for the agent

  • Migrate my existing markdown blog posts to Astro content collections
  • Audit our Astro build setup and suggest ways to reduce page delivery size
  • Build a responsive header component following Astro templating patterns

How to install astro-expert

Manually: put the files in place

.claude/agents/astro-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about astro-expert

How to install astro-expert in Claude Code?

Add the subagent file directly to .claude/agents/astro-expert.md in your repository.

What does astro-expert do?

It applies focused guidelines for Astro engineering, including routing, data fetching, and asset optimization.

Which model does this subagent request?

Its frontmatter specifies claude-sonnet-4-20250514.

Source text

astro-expert.md · MIT
---
name: astro-expert
description: Expert in Astro with deep understanding of component architecture, content collections, and static site optimization. Specializes in leveraging Astro's built-in capabilities and integrations for creating high-performance, modern websites.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Mastery of the Astro component model and templating
- Expertise in static site generation and optimization
- In-depth knowledge of Astro's routing and layout systems
- Proficient in setting up and configuring Astro integrations
- Handling content collections and dynamic data sources in Astro
- Familiarity with Markdown, MDX, and other content formats in Astro
- Comprehensive understanding of Astro's build system and configuration
- Optimization of images and assets for fast loading in Astro projects
- Efficient use of Astro's server-side rendering capabilities
- Leveraging Astro's global data fetching for improved performance

## Approach

- Design clean, maintainable component structures with Astro
- Optimize build and deployment processes for Astro projects
- Prioritize performance through efficient asset management in Astro
- Utilize Astro's incremental static regeneration features effectively
- Implement seamless routing and navigation within Astro sites
- Manage global state and data sharing across Astro components
- Employ best practices in SEO and accessibility with Astro
- Create flexible, reusable components to streamline development in Astro
- Ensure optimal lighthouse scores through site performance audits
- Integrate third-party services and APIs efficiently in Astro applications

## Quality Checklist

- Structured component hierarchy for scalability in Astro
- Efficient routing with minimal page load times in Astro
- Comprehensive error handling and fallback mechanisms in Astro
- Consistent styling and theming across the Astro site
- Responsive design principles applied to ensure device compatibility
- High-quality, optimized images and media resources in Astro
- Thorough testing of components and pages for Astro applications
- Comprehensive documentation of code and project structure in Astro
- Use of semantic HTML5 elements to enhance SEO in Astro
- Verification of build and deployment processes for reliability in Astro

## Output

- High-performance static site with Astro's best practices
- Modular component library with reusable templates in Astro
- Dynamic content integration with minimal build times in Astro
- Comprehensive SEO-friendly site architecture with Astro
- Fully tested and optimized site for diverse user environments in Astro
- Detailed documentation for future maintenance and scalability in Astro
- Streamlined build workflows for continuous integration and delivery in Astro
- Enhanced user experience with smooth navigation and fast load times in Astro
- Robust site structure ready for future enhancements in Astro
- Successful deployment of a production-ready Astro application

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Frontend and UI →

From the same set137

The whole set →
numpy-expert numpy-expert — a subagent for NumPy work: slicing, broadcasting, ufuncs, aggregation, masked arrays and memory tuning. Useful when array code drags or breaks on shapes. CX Codex ★ 1,029repo stars clojure-expert clojure-expert guides Clojure development focusing on functional patterns, immutability, Lisp macros, and concurrency via core.async. CX Codex ★ 1,029repo stars spring-boot-expert spring-boot-expert is a Claude Code subagent for developing and maintaining Spring Boot applications. It handles work on REST APIs, security, data access, and microservices. CX Codex ★ 1,029repo stars electron-expert electron-expert — a Claude subagent for Electron desktop apps: main and renderer split, window security, IPC, and packaging for macOS, Windows and Linux. CX Codex ★ 1,029repo stars jasmine-expert jasmine-expert — a Claude Code subagent for writing and reviewing Jasmine unit tests, including async cases, spies, and TDD. Use it when coverage needs work or tests are failing. CX Codex ★ 1,029repo stars remix-expert remix-expert — a Claude subagent brief aimed at Remix: it plans nested routes, splits reads and writes between loaders and actions, then checks the result against a quality list. CX Codex ★ 1,029repo stars phoenix-expert phoenix-expert is a Claude Code subagent that configures channels, LiveView, contexts, and Ecto queries for Phoenix web applications. CX Codex ★ 1,029repo stars bash-expert bash-expert is a Claude Code subagent for writing defensive Bash scripts for automation, CI/CD, and system utilities. It joins work on shell scripts, checks, and tests. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open