面向 Halo 开发者的 Agent Skills 合集，帮助 AI Agent 辅助开发主题、插件及其他 Halo 生态组件。
Agent Skills 是结构化的知识包，为 AI Agent（如 Cursor、Codex 等）提供特定领域的深度上下文。每个 skill 包含：
SKILL.md入口文件，包含快速参考和开发工作流指南references/目录，存放聚焦、简洁的参考文档assets/目录，提供开箱即用的起始模板
通过 Skills CLI 安装：
# 全局安装（在所有项目中可用）
npx skills add halo-dev/dev-skills@halo-theme-dev -g
# 或仅安装到当前项目
npx skills add halo-dev/dev-skills@halo-theme-dev从零开始构建完整 Halo 主题所需的一切。
涵盖内容：
- 主题目录结构及
theme.yaml/settings.yaml配置 - Thymeleaf layout fragment 与模板路由
- 模板变量与 Finder API 使用
- 静态资源管理及通过
vite-plugin-halo-theme进行 Vite 集成 - 使用 FormKit Schema 构建主题设置表单
- 模型元数据（Annotations）——定义与读取自定义字段
- 自定义模板标签（
halo:comment、halo:footer）
起始模板（位于 assets/ 目录）：
| 模板 | 说明 |
|---|---|
theme-minimal/ |
无需构建工具，使用 Thymeleaf layout fragment 的最小主题 |
theme-vite/ |
完整 Vite 工程，集成 vite-plugin-halo-theme、partials 布局复用，支持 TailwindCSS |
skills/
└── <skill-name>/
├── SKILL.md # 入口文件，优先阅读
├── agents/
│ └── openai.yaml # Skill 元信息
├── references/ # 参考文档
└── assets/ # 起始模板与示例
如需新增 skill，可参考现有 skill 的目录结构进行创建。
- Halo — 开源 CMS
- Halo 开发者文档 — 官方文档
- theme-starter — 最小主题模板
- theme-vite-starter — 基于 Vite 的主题模板