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
.claude/agents/astro-expert.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/astro-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/astro-expert.mdCursor also reads .claude/agents/
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