很多人不知道：Claude Code 其实不太懂 Astro

我见过太多人装了 Claude Code，觉得「搞定了，以后写代码就它了」。然后一让它搭 Astro 博客——出来的结构用的是老版本的 Content Collections 配置，i18n 路由乱写，部署脚本塞的是 Heroku。

原因很简单：Claude Code 默认是框架无关的，它不会自动知道你用的是哪个框架、哪个版本、哪个最佳实践。

Publishing Astro Websites Agentic Skill 就是来解决这个问题的。

这是专门给 Claude Code 装上的「Astro 静态网站」专家模式，来自 Spillwave Solutions 团队（MIT 协议），GitHub 31 颗星。作者 Richard Hightower 是老牌 Java/JVM 技术作者，社区里有点名气。

它到底教 Claude 什么

内容层（Content Collections）：覆盖 Legacy Patterns 和 Astro 5.0 全新的 Content Layer API——这是最近才有的东西，大多数 skill 根本没跟进。

语法高亮和代码展示：Shiki 配置、Expressive Code 集成、Astro 里写技术文档的人会常用。

图表集成：Mermaid、PlantUML，以及暗色模式主题处理。写技术博客的刚需。

站内搜索：Pagefind 的细粒度配置和权重控制，比 Fuse.js 更适合静态站。

国际化（i18n）：Astro 路由层的 i18n 配置和翻译缺失时的 fallback 逻辑。

版本化文档：Starlight 框架的使用、多版本文档模式。

部署：Firebase、Netlify、Vercel、GitHub Pages、GCS + Cloud CDN——你用哪个它都知道怎么配。

性能优化：Prefetching、Critical CSS（astro-critters）、局部水合。

测试：Vitest 组件测试、Playwright E2E、链接检查。

一句话概括

它把 Astro 官方文档 + 社区最佳实践压缩成了一个 Skill 文件，让 Claude 在 Astro 项目里不再「盲写」。

安装方式

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

或者作为 Git submodule 加入：

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

装完之后直接说「帮我创建一个 Astro 博客」「帮我部署到 Vercel」「配置一下内容集合」就行。

适合谁

用 Astro 做技术博客、文档站、产品页面的开发者。已经用 Claude Code 写前端但感觉它对 Astro 框架「一知半解」的，这个 Skill 值得装上。

GitHub：https://github.com/SpillwaveSolutions/publishing-astro-websites-agentic-skill

GitHub: https://github.com/SpillwaveSolutions/publishing-astro-websites-agentic-skill