astro-docs

Scaffolds Astro v5 projects, components, and content collections with Starlight support.

1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/asachs01/astro-docs-skill --skill astro-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: astro-docs
Source: https://github.com/asachs01/astro-docs-skill/tree/main
Command: npx skills add https://github.com/asachs01/astro-docs-skill --skill astro-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the creation and development of Astro projects, ensuring adherence to the latest v5 patterns and best practices, saving developers time and reducing boilerplate.

Core Features & Use Cases

  • Project Scaffolding: Generate complete Astro projects (blogs, docs, e-commerce, portfolios, landing pages) with correct v5 structure.
  • Component Patterns: Scaffold components, pages, layouts, and islands with proper TypeScript, slots, and scoped styles.
  • Content Layer API: Set up type-safe content collections using Zod schemas and built-in loaders.
  • Starlight Docs: Full support for scaffolding Starlight documentation sites.
  • Live Docs Fallback: Fetches from docs.astro.build for edge cases.

Quick Start

Use the astro-docs skill to create a new Astro blog project.

Frequently Asked Questions about astro-docs

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

FAQPage Schema
How do I scaffold an Astro project using the latest v5 patterns?

Scaffolding an Astro project with v5 patterns is automated by generating complete site structures like blogs or docs. It enforces best practices for file-based routing and islands architecture, reducing manual boilerplate setup.

How do I set up type-safe content collections in Astro with the Content Layer API?

Type-safe content collections are set up by integrating Zod schemas with built-in loaders via the Content Layer API. This validates content structures and ensures type safety across your Astro project's data.

Can I use this to scaffold a Starlight documentation site?

Yes, scaffolding a Starlight documentation site is fully supported. It integrates Starlight's theming system and documentation components directly into the generated Astro v5 project architecture.

How do I create Astro components with TypeScript and scoped styles?

Creating Astro components with TypeScript and scoped styles is automated by generating pages, layouts, and islands. It applies proper slots and style isolation without requiring manual component boilerplate configuration.

What should I do if I encounter an edge case not covered in the Astro documentation?

For edge cases, a live docs fallback fetches information directly from docs.astro.build. This ensures scaffolding remains accurate even when encountering undocumented Astro v5 scenarios or rare Starlight configurations.

Does this support generating different types of web projects beyond documentation?

Generating various web projects is supported, including e-commerce sites, portfolios, and landing pages. It applies the correct Astro v5 structure and file-based routing configuration tailored to each specific project type.