Skill管理
Skill 是一组写给 AI 的任务说明和参考资料,以文件夹的形式保存:入口文件 SKILL.md 写明这个 Skill 适用于什么任务、应该按什么步骤完成,同一文件夹中还可以放参考文档、配置样例等文件。在对话中选用某个 Skill 后,AI 会按其中的说明完成任务。
Skill 有两个管理入口,数据都只保存在当前浏览器中:
| 入口 | 打开方式 | 主要用途 |
|---|---|---|
| 侧边栏「Skill 技能」面板 | 点击侧边栏会话栏中的「Skill 技能」 | 查看已有 Skill,从本地目录或 GitHub 导入,删除导入的 Skill,设置 Auto 模式 |
| 配置页「Skill 管理」 | 在配置页左侧导航中选择「Skill 管理」 | 新建 Skill,编辑 SKILL.md 与其他文件,重命名、删除,恢复内置 Skill,导入导出备份 |
Skill 的组成
一个 Skill 对应一个文件夹,例如:
weekly-report/
├── SKILL.md # 入口文件,必须有
└── references/
└── template.md # 参考文件,可选SKILL.md 由两部分组成:开头 --- 之间的基本信息,以及之后的正文。
---
name: weekly-report
description: 根据本周的提交记录与任务列表,按团队模板生成周报
---
# 周报生成
1. 先读取 references/template.md 中的周报模板。
2. 按模板的栏目整理本周完成的工作……| 部分 | 说明 |
|---|---|
name | Skill 名称,在输入框中通过 /名称 选用。在配置页编辑时,名称与文件夹名保持一致 |
description | Skill 的用途。Auto 模式下 AI 会参考这段描述判断是否选用该 Skill,建议写清适用的任务和场景 |
| 正文 | AI 执行任务时遵循的说明,不能为空。可以在正文中引用同一文件夹中的其他文件 |
与 Agent Skills 规范的差异
Skill 的文件夹结构与 SKILL.md 格式遵循 Agent Skills 规范,按规范编写的 Skill 可以直接导入。扩展与规范有以下差异:
| 项目 | Agent Skills 规范 | 本扩展 |
|---|---|---|
| 名称可用的字符 | 只能包含小写字母、数字和中划线 | 新建时可以使用大小写字母、数字、下划线和中划线;导入时不检查字符 |
| 名称与文件夹名 | 必须一致 | 导入时不要求一致 |
| 基本信息中的属性 | 除 name、description 外,还可以填写 license、compatibility、metadata、allowed-tools | 只保留 name、description、metadata 和 homepage,其他属性在导入或保存后被丢弃 |
| 脚本 | 可以在 scripts/ 中放置供 AI 执行的脚本 | AI 只能读取 Skill 中的文件,不会执行脚本 |
需要在其他支持该规范的工具中使用同一个 Skill 时,名称请只使用小写字母、数字和中划线,并与文件夹名保持一致。
在对话中使用 Skill
下图对比三种选用方式对连续几条消息的影响,操作步骤见后面两个小节。
手动选择 Skill

- 在侧边栏输入框中输入
/,候选列表会列出/Auto · 自动选择 Skill和全部 Skill。继续输入名称可以筛选。 - 选择一个 Skill,输入框上方出现带「Skill」字样的标签。
- 输入任务内容并发送。
手动选择只对接下来发送的这一条消息生效。不想使用已选的 Skill 时,点击标签右侧的关闭按钮。

让 AI 自动选择(Auto 模式)
Auto 模式下,AI 会根据你的消息从候选 Skill 中自动选择合适的 Skill。有两种开启方式:
- 只对一条消息生效:在输入框中输入
/并选择/Auto · 自动选择 Skill,然后发送消息。 - 对之后的每条消息生效:打开「Skill 技能」面板,开启「默认启用 Auto 模式」。之后当前会话与新会话中发送的消息都会自动选择 Skill。
开启 Auto 模式后,输入框上方显示 Auto 标签:
- 点击标签上的设置按钮,可以调整候选范围和数量。
- 默认启用 Auto 模式时,点击标签上的关闭按钮只让本次消息不使用 Skill,下一条消息仍会自动选择。
Auto 模式有两项设置:
| 设置项 | 说明 |
|---|---|
| 候选 Skill | AI 只会从勾选的 Skill 中选择。从未调整过时,全部 Skill 都是候选 |
| 最多选择数量 | 每条消息最多选用几个 Skill,默认 1 个,不能超过候选 Skill 的数量 |
设置的生效范围取决于修改入口:
- 在「Skill 技能」面板中点击「默认启用 Auto 模式」旁的「配置」,修改的是默认设置。
- 默认启用 Auto 模式时,在输入框的 Auto 标签上修改,同样修改默认设置。
- 通过
/Auto只为一条消息开启 Auto 模式时,在标签上修改只影响这条消息。
导入 Skill
在侧边栏打开「Skill 技能」面板,点击「导入 Skill」,可以从两种来源导入。导入成功后提示「Skill 导入成功」,Skill 立即出现在列表中。

从本地目录导入
- 选择「从本地目录导入」。
- 选择 Skill 所在的文件夹,该文件夹中需要包含
SKILL.md。 - 浏览器可能会询问是否允许读取该文件夹中的文件,确认即可。文件只在本地读取,不会上传到服务器。
从 GitHub 导入
- 选择「从 GitHub 导入」。
- 粘贴 Skill 目录的链接,格式为
https://github.com/<用户或组织>/<仓库>/tree/<分支或标签>/<Skill 目录>。 - 点击「从 GitHub 导入」。导入过程中可以点击「取消导入」中止。
只支持 github.com 上公开仓库的 HTTPS 目录链接,链接指向的目录中需要包含 SKILL.md。仓库首页或单个文件的链接无法导入。
导入规则
- 导入后的 Skill 名称取自
SKILL.md中的name,与文件夹名无关。 - 名称不能是
Auto,也不能与内置 Skill 同名,否则导入失败。 - 名称与已导入的 Skill 相同时,导入的内容会整体替换原有的 Skill:原有 Skill 中有、导入内容中没有的文件会被删除,不会再次确认。需要保留原有内容时,请先在配置页导出备份。
- 导入过程中发现的非致命问题会提示「导入过程中发现 N 个警告」,Skill 仍会导入。
配置页的「导入备份」对同名 Skill 的处理方式不同,按文件路径合并,见下文 导入备份。两种方式的对比如下:
删除与编辑导入的 Skill
「Skill 技能」面板的列表中,每个 Skill 显示名称、描述和资源文件数量:
- 删除:只有导入或新建的 Skill 显示此按钮。点击后浏览器会弹出确认框,确认后删除。标有「内置」的 Skill 不能删除。
- 编辑:打开配置页的「Skill 管理」,并直接打开该 Skill 的
SKILL.md。
在配置页编辑 Skill
配置页「Skill 管理」的顶部是「新建 Skill」「导入备份」「导出备份」三个按钮;下方左侧是「Skill 列表」,以文件树形式列出全部 Skill 及其文件,右侧是编辑区。
文件树中每一行右侧的「…」按钮汇总了该行可用的操作,按钮中的菜单项随文件类型变化。

新建 Skill
- 点击「新建 Skill」。
- 输入名称。名称只能包含字母、数字、下划线和中划线,不能与已有 Skill 重名。
- 点击「创建 Skill」。扩展会生成一份
SKILL.md模板并在右侧打开。 - 填写描述和正文,然后保存。
编辑与保存
点击文件树中的文件,即可在右侧打开编辑:
- Markdown 文件(
.md)可以在「可视化编辑」与「源码编辑」之间切换。可视化编辑提供标题、加粗、列表、代码块等格式按钮;源码编辑直接修改 Markdown 原文。 SKILL.md在可视化编辑模式下,正文上方显示「基本信息」,可以修改描述。名称不在这里修改,需要在文件树中重命名 Skill。- 其他文件(如
.json、.yaml)以纯文本方式编辑。
编辑区右上角显示保存状态:「已保存」「未保存」「保存中…」或「保存失败」。修改内容后状态变为「未保存」,此时点击「保存」,或按 Ctrl+S(macOS 为 ⌘S)保存;状态为「已保存」时「保存」按钮不可点击。保存失败时状态下方会显示原因,「保存」按钮变为「重试」。
保存后,已打开的侧边栏会自动重新加载 Skill,不需要刷新。之后发送的消息使用新内容。
有未保存的修改时,切换文件、关闭文件、删除或导入备份前,会弹出「保存对 <文件名> 的修改?」,可以选择「保存并继续」「不保存并继续」或「取消」。直接关闭或刷新配置页时,浏览器也会提示有未保存的内容。
SKILL.md 的格式有误时,文件会以源码编辑模式打开,并在编辑区顶部提示原因。常见的保存失败原因如下:
| 提示 | 处理方式 |
|---|---|
| SKILL.md 的正文不能为空 | 在基本信息之后补充正文 |
| SKILL.md 的属性名不能重复 | 删除开头 --- 之间重复的属性 |
| 解析 Skill 失败:… | 检查开头 --- 之间的格式是否正确 |
添加文件与文件夹
在 Skill 或其中某个文件夹所在行打开「…」菜单,选择「新建文件」或「新建文件夹」:
| 对象 | 命名规则 |
|---|---|
| 文件 | 只能包含字母、数字、下划线、中划线和点号;扩展名限 .md、.json、.xml、.txt、.yaml、.yml、.js |
| 文件夹 | 只能包含字母、数字、下划线和中划线 |
文件路径连同 Skill 文件夹和文件名在内最多 5 层,例如 my-skill/a/b/c/guide.md。同一目录下不能有同名的文件或文件夹。
新建的空文件夹在刷新页面后会消失;放入文件后,文件夹会随文件一起保存。
重命名与删除
在「…」菜单中选择「重命名」或「删除」。Skill 所在行显示为「重命名 Skill」「删除整个 Skill…」。
- 删除前会弹出确认框,显示将删除的文件数量。删除后无法撤销。
SKILL.md是 Skill 的入口文件,不能单独重命名或删除。要移除整个 Skill,请在 Skill 所在行选择「删除整个 Skill…」。
修改与恢复内置 Skill
内置 Skill 随扩展提供。你可以修改其中的文件,也可以在其中添加新文件,但有以下限制:
- 修改过的内置文件在文件树中显示「已修改」标记。保存的内容与原文完全相同时,视为未修改。
- 内置 Skill 本身及其自带的文件、包含自带文件的文件夹,都不能重命名或删除。你在内置 Skill 中新增的文件,以及只包含新增文件的文件夹,可以重命名或删除。
- 在修改过的文件上选择「恢复内置默认」,该文件恢复为原文。在内置 Skill 所在行选择「恢复全部内置默认」,该 Skill 下的全部修改与新增文件都会被移除。
备份与恢复
Skill 不包含在「数据管理」的会话备份中,需要在本页单独备份。备份文件是 zip 压缩包,导出和导入都在浏览器本地完成。
导出备份
点击「导出备份」,浏览器会下载 skills-backup-<日期>.zip,例如 skills-backup-2026-11-01.zip。压缩包中每个 Skill 对应一个顶层文件夹,包含全部 Skill 文件,内置 Skill 的文件也在其中。
导入备份
- 点击「导入备份」,选择
.zip文件。 - 导入成功后提示「成功导入 N 个文件」。
导入按文件路径合并:
| 情况 | 结果 |
|---|---|
| 备份中的文件与现有文件路径相同 | 用备份中的内容覆盖现有文件 |
| 备份中的文件在现有 Skill 中不存在 | 添加该文件 |
| 现有文件在备份中不存在 | 保持不变,不会被删除 |
压缩包根目录下的文件,或路径中含有 ..、以 / 开头的条目 | 跳过,提示中会注明跳过的数量 |
压缩包的顶层应当是 Skill 文件夹,每个文件夹中包含 SKILL.md。只要其中一个 Skill 无法解析,整个导入都会取消,提示中会写明出错的 Skill 名称与原因,现有数据保持不变。
数据保存位置
导入、新建和修改过的 Skill 都保存在当前浏览器的扩展本地存储中,不会上传到服务器。卸载扩展会清除这些数据;换浏览器或换设备前,请先导出备份,再在新环境中导入。
常见问题
输入「/」后没有看到某个 Skill,怎么办?
打开「Skill 技能」面板,确认该 Skill 在列表中。如果是刚在配置页新建的 Skill,确认已经保存。候选列表会按输入的文字筛选,可以删除 / 后的内容再看。
修改了 Skill,为什么对话结果没有变化?
确认编辑区显示「已保存」。保存后,之后发送的消息才会使用新内容,已经发出的消息不受影响。
从 GitHub 导入失败,怎么办?
按以下顺序检查:
- 链接是否为目录链接,格式为
https://github.com/<用户或组织>/<仓库>/tree/<分支或标签>/<Skill 目录>。仓库首页或单个文件的链接无法导入。 - 仓库是否公开,链接指向的目录中是否直接包含
SKILL.md。 - 当前网络能否访问 GitHub。网络受限时,可以先把该目录下载到本地,再使用「从本地目录导入」。
导入时提示与内置 Skill 重名,怎么办?
把 SKILL.md 中的 name 改成其他名称后重新导入。
为什么某个 Skill 没有「删除」按钮?
标有「内置」的 Skill 随扩展提供,不能删除。如果修改过它,可以在配置页的文件树中选择「恢复全部内置默认」撤销修改。
再次导入同名 Skill 后,原来的内容不见了?
从「Skill 技能」面板导入同名 Skill 时,新内容会覆盖原有内容。如果之前导出过备份,可以在配置页通过「导入备份」恢复。
相关链接
- 界面说明:侧边栏「Skill 技能」按钮与输入区的位置。
- 数据管理:会话备份与恢复。
- 模型设置:Skill 的执行效果也取决于所选模型。
- Agent Skills 规范:
SKILL.md全部属性的定义与编写建议。