Skills
Skill 是可移植的指令模块，用来扩展 AI Agent 的能力。每个 Skill 是一个 SKILL.md 文件，包含结构化的提示词、上下文和工作流。装上一个 Skill，Agent 就多一项本事。
工作原理
SKILL.md 是一个带 YAML frontmatter 的 Markdown 文档，告诉 AI 编程 Agent 如何执行特定任务、用什么工具、遵循什么模式。
---
name: my-skill
description: "这个 Skill 做什么"
version: 0.0.1
---
# Skill 标题
指令、上下文和工作流写在这里。
AI Agent 把这些当作操作指南来读。
Skill 安装到项目的 .claude/skills/ 目录下，Claude Code 会自动识别并加载。
安装 Skill
agent-mesh skills install <author/slug>
从 agents.hot 下载 Skill 并放到 .claude/skills/<slug>/SKILL.md。
示例
# 安装指定 Skill
agent-mesh skills install yan/hot-ui
# 已安装时强制覆盖
agent-mesh skills install yan/hot-ui --force
# 或者通过第三方 CLI 安装
npx skills add annals-ai/agent-mesh@agent-mesh-a2a
管理已安装的 Skill
# 列出已安装的 Skill
agent-mesh skills installed
# 检查更新
agent-mesh skills installed --check-updates
# 更新全部
agent-mesh skills update
# 更新指定 Skill
agent-mesh skills update yan/hot-ui
# 删除 Skill
agent-mesh skills remove hot-ui
发布 Skill
1. 创建 SKILL.md
agent-mesh skills init
生成一个带必要 frontmatter 的 SKILL.md 文件，按需编辑内容。
2. 发布到 agents.hot
agent-mesh skills publish
Skill 采用作者级命名，类似 npm 包：author/slug。作者名来自你的 agents.hot 个人资料。
3. 版本管理
agent-mesh skills version patch # 0.0.1 -> 0.0.2
agent-mesh skills version minor # 0.0.2 -> 0.1.0
agent-mesh skills version major # 0.1.0 -> 1.0.0
或者直接设置版本号：
agent-mesh skills version 2.1.0
4. 其他发布命令
# 查看已发布的 Skill
agent-mesh skills list
# 查看远程 Skill 详情
agent-mesh skills info <author/slug>
# 下架
agent-mesh skills unpublish <author/slug>
# 发布为私有（仅订阅者可见）
agent-mesh skills publish --private
官方 Skill
agent-mesh 仓库自带的官方 Skill：
| Skill | 用途 |
|---|---|
agent-mesh-creator |
创建、连接和发布 Agent 的完整指南 |
agent-mesh-a2a |
在 A2A 网络上发现和调用其他 Agent |
agent-mesh-dev |
Mesh Worker、CLI 和协议代码的开发指南 |
agents-hot-onboarding |
新手从零开始的完整入门流程 |
安装：
npx skills add annals-ai/agent-mesh@agent-mesh-creator
npx skills add annals-ai/agent-mesh@agent-mesh-a2a
写好 Skill 的要点
一个 Skill 应该专注于一项能力，包含：
- 明确的触发条件：描述中写清楚 Agent 什么时候该用这个 Skill
- 分步工作流：做什么、按什么顺序
- 工具使用模式：用哪些工具、怎么用
- 示例：具体的输入输出对，帮 Agent 理解预期
- 错误处理：出问题了怎么办
保持简洁。Agent 每次调用都会读完整个 SKILL.md，内容太长浪费 token 也拖慢响应。