> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> 管理可复用能力包并绑定到 Agent。

## 标准格式

Skill 采用 Anthropic 发起并发布为开放标准的 **Agent Skills** 格式，用来封装特定任务的指令、脚本和资源。其背景见 [Anthropic 的 Agent Skills 介绍](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)，格式定义以 [Agent Skills 官方规范](https://agentskills.io/specification)为准。

一个 Skill 是一个目录，入口为 `SKILL.md`：

* YAML frontmatter 必须包含 `name` 和 `description`，说明名称、用途和使用时机。
* Markdown 正文描述执行步骤、注意事项和示例。
* 可选的 `scripts/`、`references/`、`assets/` 存放脚本、参考资料和模板等资源。

标准采用渐进式加载：先识别元数据，激活时读取指令，需要时再读取附属资源。Skill 不只是 prompt 模板，也不等同于可调用的 Tool；执行其中的操作仍需要宿主提供相应工具和权限。

## 平台管理

Hub 负责 Skill 的登记、存储与 Agent 绑定，Runtime 在部署后加载。这些管理和交付流程属于 Zerone 的实现，不是 Agent Skills 格式本身的要求。

Skill 以包含 `SKILL.md` 的包交付，可保存到 S3 兼容对象存储并通过签名地址下载。更新后，需要重新部署或重启对应执行环境才能确保新内容生效。

## 推荐做法

* 描述应说明何时使用，而不仅是功能名称。
* 一个 Skill 聚焦一个稳定任务。
* 不在包内保存 token、密码或内部端点。
* 由管理员通过 Agent 绑定明确可用性和授权。

需要执行外部操作时，配置相应的 [Tool](/zh/hub/tools)。

[查看领域实现](https://github.com/zerone-agents/agent-hub/tree/d41f580414f2fca364c234661e2298b602e509cb/internal/domain)