# Skill介绍
#### 什么是Skill
在AgentArts平台上，Skill可以将过去分散在不同文档、代码片段或零散笔记中的隐性知识，以显性化和结构化的方式组织起来，使AI能够按需、稳定地执行专业任务。您可以将Skill看作是开发者的工具箱，将积累的技术经验和最佳实践打包成技能包，使AI成为您专业领域的专家。与一次性使用的提示词不同，Skill是可以保存、复用和优化的任务解决方案，使AI不仅能理解您的指令，更能掌握您的方法。当一个任务的处理流程相对固定、可重复操作，并且需要一致和可靠的输出时，可以将其封装为Skill，供通用智能体使用。
例如，假设您是一名软件开发工程师，经常需要进行代码审查。您可以将代码审查的最佳实践和常见检查点整理成一个Skill包，包括代码风格检查、逻辑错误检测、性能优化建议等。这样，每次进行代码审查时，AI可以自动应用这些技能，确保审查过程的一致性和可靠性。
![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
本功能仅在贵阳一区域（Region）提供。
当前版本仅支持Skill的导入、管理和浏览，暂不支持在智能体中调用使用。后续版本将逐步开放智能体集成能力。请关注最新动态公告。
#### Skill的工作机制
**Skill**是一种遵循统一规范的文件夹结构，清晰地定义了完成特定任务所需的标准作业流程（SOP）、方法论和参考模板。为了提高对话效率，智能体不会一次性加载Skill的全部内容，而是通过"按需加载"机制，在对话过程中动态判断哪些Skill与当前任务相关，并仅加载完成任务所需的必要信息，从而避免上下文窗口过载。
一个标准的Skill文件夹通常包含以下核心组成部分：
- **SKILL.md** ：必需文件
  - **描述**：这是Skill的核心元数据文件和使用说明书，用于向智能体说明该Skill的名称、用途以及操作指南。
  
  - **功能**：智能体在启动时会优先加载该文件的元数据信息，以便在需要时快速判断是否调用该Skill，并确定如何调用。
   
- **scripts/目录：**
  - **描述**：存放可执行的代码文件，用于完成具体的计算任务。
  
  - **功能**：这些脚本文件包含明确的逻辑和算法，使智能体能够执行特定的操作，确保任务的确定性和可重复性。
   
- **references/目录：**
  - **描述**：存放与Skill相关的参考资料，包括第三方API文档、设计规范、测试报告等。
  
  - **功能**：这些文档为智能体提供背景信息和上下文支持，帮助其更好地理解任务需求并优化执行过程。
   
- **assets/目录：**
  - **描述**：存放Skill所需的静态资源和模板文件，例如配置模板、音视频文件等。
  
  - **功能**：这些资源文件为智能体提供执行任务所需的额外信息和素材，确保任务执行的准确性和高效性。
   
通过清晰的文件夹结构和按需加载机制，Skill能够帮助智能体在对话场景中灵活扩展功能，从通用助手快速转变为特定领域的专家。
 #### Skill的制品包规范
Skill制品包为ZIP格式，遵循[Agent Skills Standard](https://agentskills.io/specification)，以SKILL.md为核心清单文件。
1. **目录结构**
   制品包内部的目录结构示例如下：
   ```
   skill-package.zip
   └──skill-package
      ├── SKILL.md              # 技能清单文件（必需，YAML frontmatter + Markdown）
      ├── scripts/              # 可执行脚本目录
      │   ├── main.py           # 入口文件
      │   └── ...
      ├── references/           # 参考文档（可选）
      │   └── REFERENCE.md
      └── assets/               # 静态资源（可选，模板、图片等）
   ```
   
2. **SKILL.md清单文件格式** ：
   SKILL.md完全遵循[Agent Skills Standard](https://agentskills.io/specification)规范。由YAML frontmatter（元数据头）和Markdown（正文描述）两部分组成。必须包含name和description字段， 且name不可修改。
   ```
   ---
   name: skill-creator
   description: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
   license: Complete terms in LICENSE.txt
   ---
   # 此处为 Markdown 正文内容
   ...
   ```
   
3. **元数据字段定义**
   以下为SKILL.md文件中YAML frontmatter的字段详细说明（遵循Agent Skills Standard）：
   表1**元数据字段定义** 
   | 字段            | 是否必需 | 说明                                                                                                                                                                                                                                                                                                                                                                                          |
   |:---|:---|:---|
   | name          | 是    | 技能唯一标识。 - 最长64字符（NFKC归一化后）。  - 仅允许Unicode字母、数字、连字符。  - 必须全小写；不能以连字符开头或结尾；不允许连续连字符。   |
   | description   | 是    | 技能描述。 - 最长1024字符。  - 需清晰描述技能功能及触发条件。                                                                                                                               |
   | license       | 否    | 许可证名称或文件引用（例如LICENSE.txt）。                                                                                                                                                                                                                                                                                                                                                                  |
   | allowed-tools | 否    | 允许该技能调用的工具列表。                                                                                                                                                                                                                                                                                                                                                                               |
   | metadata      | 否    | 扩展元数据，支持任意键值对（如author、version等）。                                                                                                                                                                                                                                                                                                                                                            |
   | compatibility | 否    | 运行环境要求。 - 数据类型须为字符串。  - 最长500字符。                                                                                                                                |
      
   
 
#### Skill与其他资源的区别
在AgentArts中，Skill是一种专为增强智能体能力设计的标准化组件，包含指令文档、元数据配置和执行脚本等要素，能够为智能体注入特定领域的专业能力、流程规范和经验法则。为了更好地理解Skill与其他资源的区别，以下是对Skill与提示词、工作流、插件、MCP和知识库的详细分析：
表2Skill与其他资源的区别 
| **对比项** | **Skill的定义与特点**               | **对比项的定义与特点**                |
|:---|:---|:---|
| 提示词     | 提供特定领域的专业能力与方法，按需触发，用于完成具体任务。 | 定义智能体的全局人设和工作方式，持续生效，影响输出风格。 |
| 工作流     | 灵活的操作说明书，允许自主决策，不固定执行路径。      | 预设的固定流程，明确步骤顺序，适用于自动化任务。     |
| 插件      | 封装使用策略，指导何时何地使用插件。            | 负责调用外部API，处理技术接入。            |
| MCP     | 指导如何使用MCP提供的接口完成任务。           | 提供能力调用接口，访问外部服务。             |
| 知识库     | 提供标准操作流程（SOP）与最佳实践，处理明确问题更高效。 | 存储文档与素材内容，适合信息检索与内容补充类场景。    |
   
在AgentArts中，Skill是一种强大的工具，通过将隐性知识显性化、结构化，使智能体能够稳定、高效地执行专业任务。Skill与提示词、工作流、插件、MCP和知识库在功能和应用场景上各有侧重，但它们共同构成了智能体的综合能力体系，使智能体能够在不同场景下灵活、高效地完成任务。
#### Skill的类型
根据Skill的提供者和使用范围，Skill可分为以下类型：
表3Skill的类型 
| **服务**    | **技能类型**  | **说明**                                                                                                                                                                                                |
|:---|:---|:---|
| AgentArts | 资产广场Skill | 由AgentArts开发和维护的编程技能，通过资产广场面向所有用户开放。在对话中，AgentArts会按需自动调用官方Skill完成任务。                                                                                                                                 |
| AgentArts | 组件库Skill  | AgentArts支持用户手动上传的技能，这些技能仅限您个人使用。技能的范畴广泛，不仅限于编程，还包括语言、沟通、管理、技术、创意、商业、个人发展、专业、生活和社交技能等。                                                                                                                |
| AgentArts | 组件库Skill  | 注意： 请您注意，"第三方技能"来源于第三方服务商提供，当您使用第三方服务商提供的技能时，您应严格遵守第三方的相关协议。您理解并同意，第三方服务商提供的技能可能存在风险，我们无法对其做出任何形式的保证。请您在使用前审慎考量并评估其风险。 AgentArts支持导入通过第三方工具生成的资源包，或存储在OBS服务中的资源包。 |
   
#### 资产广场Skill
AgentArts通过资产广场Skill页签，与开发者共同构建技能生态系统。Skill使用者则可以根据自身需求，从广场中挑选合适的Skill进行使用。"Skill"页面集中展示了平台精选的各类技能工具，如[图1]所示。这些技能功能丰富，覆盖通用工具、效率提升、自动化处理、设计与可视化、内容创作等多个实用领域，能够有效扩展智能体的应用能力。用户可根据实际业务需求，灵活调用和组合各类技能，以提升工作效率和实现业务目标。
图1Skill   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549875.png "点击放大")