plugins/astro-expert/skills/astro-6/SKILL.md
Expert Astro 6 framework — routing, output modes, middleware, Vite Environment API, Rust compiler, Content Security Policy, Live Collections, Fonts API. Use when building Astro sites, configuring output, or upgrading from Astro 5.
npx skillsauth add fusengine/agents astro-6Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Production-ready web framework for content-driven sites with unified dev runtime and Islands Architecture.
Before ANY implementation, use TeamCreate to spawn 3 agents:
After implementation, run fuse-ai-pilot:sniper for validation.
| Feature | Benefit |
|---------|---------|
| Unified Dev Runtime | Dev matches production — fewer "works in dev, breaks in prod" bugs |
| Vite Environment API | Exact production runtime during development |
| Rust Compiler | Faster .astro file compilation, replaces Go compiler |
| Live Content Collections | Real-time data from external sources |
| Built-in Fonts API | Zero-config font loading with performance optimization |
| CSP Support | Built-in Content Security Policy nonce management |
| Cloudflare Workers | First-class support with workerd runtime in dev |
| Mode | Description | Use Case |
|------|-------------|----------|
| static (default) | All pages prerendered at build | Blogs, docs, marketing |
| server | All pages rendered on demand | Apps, dashboards, auth |
| hybrid | Mix static + on-demand | Most production sites |
src/pages/ maps directly to URLs[slug].astro, [...all].astroexport const prerender = false/true.ts/.js files in src/pages/ for API routes| Need | Reference | |------|-----------| | Initial setup | installation.md | | Routing patterns | routing.md | | Output configuration | output-modes.md | | Middleware setup | middleware.md | | astro.config.ts | config.md | | New Astro 6 features | new-features.md | | Full project setup | templates/basic-setup.md | | Config examples | templates/config-example.md |
output: 'static' by default — Add server only when neededprerender — Fine-grained control in hybrid modetesting
Copy self-audit and ban-lists — filler verbs/hype adjectives, slop placeholder names, fake-precise numbers, Title Case headlines, humor in error copy ('Oops!'), em-dash crutch, one copy register per page.
development
Logged-in web apps — dashboards, auth flows, settings, onboarding, data tables, command palettes, modals, toasts. Register `product`: density and glance-speed over marketing polish, no hero/CTA-tricks, every data surface covers empty/loading/error explicitly, tables and dataviz follow preattentive-processing rules.
development
Marketing sites, landing pages, campaign pages — register `brand` (design IS the product). Structure comes from the register's POV + a macrostructure pick, never from copying an inspiration site's section flow. Hero discipline, deviated section order, asymmetric grids, and a silhouette lookalike-test gate before ship.
development
Token-strategy core — OKLCH color rules, neutral tinting, accent-commitment levels, type scale, 8pt spacing grid, touch targets, and the canonical output format of design-system.md (the file the harness gates on). This is routing step 1 of design-method/SKILL.md — read it before design-web/design-webapp/design-ios/design-android, before picking or auditing a single color/type/spacing value.