SpillwaveSolutions

Publishing Astro Websites Agentic Skill — Documentation skill for Claude Code

Documentation community

A comprehensive Claude Code skill for building and deploying static websites with the Astro framework.

How to install Publishing Astro Websites Agentic Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open SpillwaveSolutions/publishing-astro-websites-agentic-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Publishing Astro Websites Agentic Skill does

A comprehensive Claude Code skill for building and deploying static websites with the Astro framework. Covers SSG, Content Collections, Markdown/MDX, Mermaid diagrams, Pagefind search, i18n, and deployment to Firebase/Netlify/Vercel.

Alternatives in Documentation

Doc Co-authoring — Guide users through structured workflow for co-authoring documentation 94.1k ★
Notion Research Documentation — Research Notion content and synthesize findings into structured briefs 14.6k ★
Hyperresearch — Agent-driven research knowledge base 2.4k ★

README

Publishing Astro Websites - Claude Code Agentic Skill

A comprehensive Claude Code skill for building and deploying static websites with the Astro framework.

Overview

This skill provides guidance for Astro static site generation (SSG), covering:

Content Collections - Legacy patterns, Content Layer API (Astro 5.0), Custom Loaders
Syntax Highlighting - Shiki configuration, Transformers, Expressive Code
Diagram Integration - Mermaid, PlantUML, dark mode theming strategies
Client-Side Search - Pagefind (granular controls, weighting), Fuse.js comparison
Versioned Documentation - Starlight framework, multi-version patterns
Internationalization - i18n routing, fallback logic for missing translations
Common Patterns - Pagination, tag archives, RSS feeds, forms, JSON-LD, dark mode
Performance - Prefetching, Critical CSS (astro-critters), partial hydration
Testing - Vitest component testing, Playwright E2E, link checking
Deployment - Firebase, Netlify, Vercel, GitHub Pages, GCS + Cloud CDN

Installation

Clone this repository into your Claude Code skills directory:

cd ~/.claude/skills
git clone https://github.com/SpillwaveSolutions/publishing-astro-websites-agentic-skill.git

Or add as a Git submodule to your existing skills:

git submodule add https://github.com/SpillwaveSolutions/publishing-astro-websites-agentic-skill.git

Usage

Once installed, Claude Code will automatically use this skill when you ask about:

"Create an Astro site"
"Deploy Astro to Firebase"
"Set up content collections"
"Add Mermaid diagrams to Astro"
"Configure Astro i18n"
"Build a static blog"
"Astro markdown setup"

Structure

publishing-astro-websites-agentic-skill/
├── .claude-plugin/
│   └── marketplace.json
├── publishing-astro-websites/
│   ├── SKILL.md
│   └── references/
│       ├── deployment-platforms.md
│       └── markdown-deep-dive.md
├── .gitignore
└── README.md