> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 创建 Skill
> 从成功任务中沉淀或与 QoderWork 对话共创自定义 Skill。
除使用现成 Skill 外，也可创建自定义技能，将个人经验和最佳实践沉淀复用。
## 从满意的任务中沉淀
当 QoderWork 出色完成了一项任务时，直接在对话中要求沉淀：
> 这次任务完成得很好，请把刚才的工作流程沉淀为一个 skill，方便以后复用
QoderWork 会回顾对话过程，提炼关键步骤、格式要求和判断标准，生成结构化的 Skill 文件。确认保存后，下次遇到类似任务即可复用。无需提前规划，在实际工作中发现「值得固化」的做法时再行动即可。
## 与 QoderWork 对话共创
有明确的工作流程想要自动化时，可通过设置面板发起共创对话：
1. 在左侧导航的「**扩展**」→「**技能**」页面，点击**通过 QoderWork 创建**。
2. 用自然语言描述需求，例如「我每周需要把 Slack 中的项目讨论整理成周报，格式包含进展、风险和下周计划三个部分」。
3. QoderWork 根据描述自动生成结构化的 Skill 文件，供确认和调整。确认后即保存到本地，后续可直接使用。
这种方式适合不想接触技术细节的用户——只需描述需求，QoderWork 完成文件编写。
## Skill 文件格式
每个 Skill 本质上是一个 `SKILL.md` 文件，使用 YAML 前置元数据 + Markdown 正文格式：
```markdown theme={null}
---
name: my-skill
description: 一句话描述这个 Skill 的用途和触发条件
version: 1.0.0
---
# 技能名称
## 步骤
1. 第一步
2. 第二步
## 常见陷阱
- 需要避免的常见错误
## 验证
如何确认 Skill 执行成功。
```
关键字段说明：
| 字段 | 必填 | 说明 |
| :------------ | :- | :----------------------------------- |
| `name` | 是 | 技能名称——小写字母、数字和连字符 |
| `description` | 是 | 触发描述——QoderWork 根据此字段判断何时自动调用该 Skill |
| `version` | 否 | 语义化版本号 |
`description` 字段至关重要——它决定了 QoderWork 能否准确识别何时使用你的 Skill。描述越具体、包含的触发关键词越多，自动触发的精度就越高。
## 测试你的 Skill
创建完成后，建议通过以下步骤验证：
1. **新建一个对话**，用自然语言描述一个应该触发该 Skill 的任务。
2. **检查是否自动触发**——如果没有，可能需要优化 `description` 中的关键词。
3. **检查输出格式**——确保输出符合预期的步骤和格式要求。
4. **尝试边界情况**——用不同的措辞描述同一类任务，确认触发的稳定性。
## 下一步
浏览、安装和分享技能
官方与社区推荐的技能合集
通过技能扩展 QoderWork 的能力