astro

Build content-focused websites with Astro using islands architecture and Markdown content collections.

1|Updated Aug 17, 2025
One-click install
npx skills add https://github.com/ratnesh-maurya/mdconverter --skill astro-ratnesh-maurya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: astro
Source: https://github.com/ratnesh-maurya/mdconverter/tree/main/.claude/skills/astro
Command: npx skills add https://github.com/ratnesh-maurya/mdconverter --skill astro-ratnesh-maurya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building content-heavy sites like blogs, docs, and marketing pages with traditional SPA frameworks ships unnecessary JavaScript and hurts performance. This Skill guides you through Astro's zero-JS-by-default model, islands architecture, and type-safe content collections so you can build fast content sites without framework guesswork. ## Core Features & Use Cases - Islands Architecture Guidance: Learn when and how to hydrate interactive components with client:load, client:visible, client:idle, and client:media directives while keeping the rest of the page static. - Content Collections & Routing: Set up type-safe Markdown/MDX collections with Zod schemas, file-based routing, and dynamic routes via getStaticPaths. - SSR & Integrations: Configure hybrid/server output modes, adapters like Vercel, API endpoints, RSS feeds, and integrations such as Tailwind, React, and MDX. - Use Case: You want to build a personal blog with Markdown posts, an RSS feed, and a single interactive React search box. This Skill walks you through project scaffolding, collection schemas, dynamic blog routes, and hydrating only the search component. ## Quick Start Ask the AI to scaffold an Astro blog with a Markdown content collection, a dynamic post page, and one hydrated React component.

Frequently Asked Questions about astro

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a blog with Astro and Markdown?

Create a project with npm create astro@latest, define a content collection in src/content/config.ts with a Zod schema, and add Markdown files to src/content/blog. Use getCollection('blog') to query posts and getStaticPaths to generate dynamic routes for each post.

How do Astro client directives work for hydration?

Astro renders framework components as static HTML by default with no JavaScript. Add client:load to hydrate immediately, client:visible to hydrate when scrolled into view, client:idle for browser idle time, or client:media for specific media queries.

Can I use React and Vue components together in Astro?

Yes, Astro supports React, Vue, Svelte, Solid, and other frameworks in the same project. Install integrations with npx astro add react or npx astro add vue, then import and mix components freely in .astro files.

Astro vs Next.js for a content website?

Astro ships zero JavaScript by default and suits content-heavy sites like blogs and docs where performance matters most. Next.js is a React-first full-stack framework better suited for highly interactive applications with complex client-side state.

Why is my React component not interactive in Astro?

Framework components in Astro render as static HTML unless you add a client directive. Add client:load or client:visible to the component tag to send its JavaScript to the browser and enable interactivity.

Does Astro support server-side rendering?

Yes, set output to 'server' or 'hybrid' in astro.config.mjs and add an adapter such as @astrojs/vercel. In hybrid mode, individual pages opt into SSR with export const prerender = false.