# 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:
```bash
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:
```bash
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
```
## Requirements
- Claude Code CLI
- Node.js 18+ (for Astro projects)
## License
MIT
## Author
Richard Hightower - [SpillwaveSolutions](https://github.com/SpillwaveSolutions)