scaffold-astro

Scaffold and standardize Astro projects with Bun and Tailwind.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/1337hero/claude-toolkit --skill scaffold-astro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-astro
Source: https://github.com/1337hero/claude-toolkit/tree/main/skills/scaffold-astro
Command: npx skills add https://github.com/1337hero/claude-toolkit --skill scaffold-astro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold and standardize Astro projects by applying a consistent structure and conventions, reducing boilerplate and ensuring scalable setup for new or reorganized sites.

Core Features & Use Cases

  • Bun + Tailwind setup and a ready-to-use project skeleton with a defined src layout (components/, layouts/, pages/, styles/, consts.ts).
  • Directory structure guidance and restructuring workflows (archive old work, extract components, move head into BaseHead.astro, keep constants in src/consts.ts).
  • Reusable template-driven scaffold that can be applied to fresh projects or reorganizations to maintain consistency and speed.

Quick Start

Copy the template from assets/template into your project, replace the placeholders with your site details, then run bun install and start the dev server.

Frequently Asked Questions about scaffold-astro

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

FAQPage Schema
How do I structure an Astro project with Bun and Tailwind?

Scaffold an Astro project using a template that enforces a Bun-only workflow and a defined src layout. This provides directory organization, component extraction, and Tailwind setup to standardize new or existing sites.

Can I restructure an existing Astro project without starting over?

Yes, you can restructure an existing Astro project by applying the scaffold template. This workflow archives old work, extracts components, moves head tags into BaseHead.astro, and consolidates constants in src/consts.ts.

What is the best way to organize Astro components and layouts?

The best way to organize Astro components is using a template-driven src layout that separates components, layouts, pages, and styles. This enforces conventions for assets and scripts to maintain scalable site architecture.

Do I need to use Bun for my Astro project setup?

Yes, the template enforces a Bun-only workflow for Astro project setup. You must run bun install and use Bun to start the dev server to maintain the prescribed conventions and directory structure.

What limitations exist when standardizing an Astro project structure?

A limitation of standardizing an Astro project structure is the strict Bun-only workflow requirement, excluding npm or yarn. Users must also conform to the specific src directory layout and prescribed asset conventions.