Skip to content

Skill管理 ​

Skill 是一组写给 AI 的任务说明和参考资料,以文件夹的形式保存:入口文件 SKILL.md 写明这个 Skill 适用于什么任务、应该按什么步骤完成,同一文件夹中还可以放参考文档、配置样例等文件。在对话中选用某个 Skill 后,AI 会按其中的说明完成任务。

Skill 有两个管理入口,数据都只保存在当前浏览器中:

入口打开方式主要用途
侧边栏「Skill 技能」面板点击侧边栏会话栏中的「Skill 技能」查看已有 Skill,从本地目录或 GitHub 导入,删除导入的 Skill,设置 Auto 模式
配置页「Skill 管理」在配置页左侧导航中选择「Skill 管理」新建 Skill,编辑 SKILL.md 与其他文件,重命名、删除,恢复内置 Skill,导入导出备份

Skill 的组成 ​

一个 Skill 对应一个文件夹,例如:

text
weekly-report/
├── SKILL.md            # 入口文件,必须有
└── references/
    └── template.md     # 参考文件,可选

SKILL.md 由两部分组成:开头 --- 之间的基本信息,以及之后的正文。

markdown
---
name: weekly-report
description: 根据本周的提交记录与任务列表,按团队模板生成周报
---

# 周报生成

1. 先读取 references/template.md 中的周报模板。
2. 按模板的栏目整理本周完成的工作……
部分说明
nameSkill 名称,在输入框中通过 /名称 选用。在配置页编辑时,名称与文件夹名保持一致
descriptionSkill 的用途。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 ​

下图对比三种选用方式对连续几条消息的影响,操作步骤见后面两个小节。

消息 1消息 2消息 3在 Auto 标签上改设置,改的是
手动选择 Skill输入 / 后选择一个 Skill
所选 Skill
不使用
不使用
没有 Auto 标签
输入 /Auto选择 /Auto · 自动选择 Skill
自动选择
不使用
不使用
只改这一条消息
默认启用 Auto 模式在「Skill 技能」面板中开启
自动选择
不使用本条点了标签上的关闭
自动选择
默认设置与面板「配置」相同
前两行按「默认启用 Auto 模式」关闭的情况绘制,消息 2、消息 3 都没有再选择 Skill。

手动选择 Skill ​

在输入框中选择 Skill
  1. 在侧边栏输入框中输入 /,候选列表会列出 /Auto · 自动选择 Skill 和全部 Skill。继续输入名称可以筛选。
  2. 选择一个 Skill,输入框上方出现带「Skill」字样的标签。
  3. 输入任务内容并发送。

手动选择只对接下来发送的这一条消息生效。不想使用已选的 Skill 时,点击标签右侧的关闭按钮。

选择 Skill

让 AI 自动选择(Auto 模式) ​

Auto 模式下,AI 会根据你的消息从候选 Skill 中自动选择合适的 Skill。有两种开启方式:

  • 只对一条消息生效:在输入框中输入 / 并选择 /Auto · 自动选择 Skill,然后发送消息。
  • 对之后的每条消息生效:打开「Skill 技能」面板,开启「默认启用 Auto 模式」。之后当前会话与新会话中发送的消息都会自动选择 Skill。

开启 Auto 模式后,输入框上方显示 Auto 标签:

  • 点击标签上的设置按钮,可以调整候选范围和数量。
  • 默认启用 Auto 模式时,点击标签上的关闭按钮只让本次消息不使用 Skill,下一条消息仍会自动选择。

Auto 模式有两项设置:

设置项说明
候选 SkillAI 只会从勾选的 Skill 中选择。从未调整过时,全部 Skill 都是候选
最多选择数量每条消息最多选用几个 Skill,默认 1 个,不能超过候选 Skill 的数量

设置的生效范围取决于修改入口:

  • 在「Skill 技能」面板中点击「默认启用 Auto 模式」旁的「配置」,修改的是默认设置。
  • 默认启用 Auto 模式时,在输入框的 Auto 标签上修改,同样修改默认设置。
  • 通过 /Auto 只为一条消息开启 Auto 模式时,在标签上修改只影响这条消息。

导入 Skill ​

在侧边栏打开「Skill 技能」面板,点击「导入 Skill」,可以从两种来源导入。导入成功后提示「Skill 导入成功」,Skill 立即出现在列表中。

Skill 技能面板

从本地目录导入 ​

  1. 选择「从本地目录导入」。
  2. 选择 Skill 所在的文件夹,该文件夹中需要包含 SKILL.md。
  3. 浏览器可能会询问是否允许读取该文件夹中的文件,确认即可。文件只在本地读取,不会上传到服务器。

从 GitHub 导入 ​

  1. 选择「从 GitHub 导入」。
  2. 粘贴 Skill 目录的链接,格式为 https://github.com/<用户或组织>/<仓库>/tree/<分支或标签>/<Skill 目录>。
  3. 点击「从 GitHub 导入」。导入过程中可以点击「取消导入」中止。

只支持 github.com 上公开仓库的 HTTPS 目录链接,链接指向的目录中需要包含 SKILL.md。仓库首页或单个文件的链接无法导入。

导入规则 ​

  • 导入后的 Skill 名称取自 SKILL.md 中的 name,与文件夹名无关。
  • 名称不能是 Auto,也不能与内置 Skill 同名,否则导入失败。
  • 名称与已导入的 Skill 相同时,导入的内容会整体替换原有的 Skill:原有 Skill 中有、导入内容中没有的文件会被删除,不会再次确认。需要保留原有内容时,请先在配置页导出备份。
  • 导入过程中发现的非致命问题会提示「导入过程中发现 N 个警告」,Skill 仍会导入。

配置页的「导入备份」对同名 Skill 的处理方式不同,按文件路径合并,见下文 导入备份。两种方式的对比如下:

导入前已有的 weekly-report
SKILL.md旧
references/template.md旧
references/old.md旧
导入的内容(name 同为 weekly-report)
SKILL.md新
references/template.md新
导入内容相同,入口不同,结果不同
「Skill 技能」面板 · 导入 Skill从本地目录或 GitHub 导入
SKILL.md已覆盖
references/template.md已覆盖
references/old.md已删除
整体替换导入内容中没有的文件会被删除
配置页「Skill 管理」· 导入备份选择 .zip 备份文件
SKILL.md已覆盖
references/template.md已覆盖
references/old.md保留
按文件路径合并备份中没有的文件保持不变
被「导入 Skill」删除的文件,可以用之前导出的备份,通过「导入备份」恢复。

删除与编辑导入的 Skill ​

「Skill 技能」面板的列表中,每个 Skill 显示名称、描述和资源文件数量:

  • 删除:只有导入或新建的 Skill 显示此按钮。点击后浏览器会弹出确认框,确认后删除。标有「内置」的 Skill 不能删除。
  • 编辑:打开配置页的「Skill 管理」,并直接打开该 Skill 的 SKILL.md。

在配置页编辑 Skill ​

配置页「Skill 管理」的顶部是「新建 Skill」「导入备份」「导出备份」三个按钮;下方左侧是「Skill 列表」,以文件树形式列出全部 Skill 及其文件,右侧是编辑区。

文件树中每一行右侧的「…」按钮汇总了该行可用的操作,按钮中的菜单项随文件类型变化。

Skill 管理整页

新建 Skill ​

  1. 点击「新建 Skill」。
  2. 输入名称。名称只能包含字母、数字、下划线和中划线,不能与已有 Skill 重名。
  3. 点击「创建 Skill」。扩展会生成一份 SKILL.md 模板并在右侧打开。
  4. 填写描述和正文,然后保存。

编辑与保存 ​

点击文件树中的文件,即可在右侧打开编辑:

  • 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 下的全部修改与新增文件都会被移除。
文件树(示例结构)类型「…」菜单中可用的操作
example-skill/内置新建文件新建文件夹恢复全部内置默认
SKILL.md内置已修改恢复内置默认
references/含内置文件新建文件新建文件夹
guide.md内置无。修改并保存后出现「恢复内置默认」
my-note.md新增重命名删除
drafts/只含新增文件新建文件新建文件夹重命名删除
todo.md新增重命名删除
「恢复全部内置默认」只在内置 Skill 有修改或新增文件时出现,会撤销全部修改并移除全部新增文件。

备份与恢复 ​

Skill 不包含在「数据管理」的会话备份中,需要在本页单独备份。备份文件是 zip 压缩包,导出和导入都在浏览器本地完成。

导出备份 ​

点击「导出备份」,浏览器会下载 skills-backup-<日期>.zip,例如 skills-backup-2026-11-01.zip。压缩包中每个 Skill 对应一个顶层文件夹,包含全部 Skill 文件,内置 Skill 的文件也在其中。

导入备份 ​

  1. 点击「导入备份」,选择 .zip 文件。
  2. 导入成功后提示「成功导入 N 个文件」。

导入按文件路径合并:

情况结果
备份中的文件与现有文件路径相同用备份中的内容覆盖现有文件
备份中的文件在现有 Skill 中不存在添加该文件
现有文件在备份中不存在保持不变,不会被删除
压缩包根目录下的文件,或路径中含有 ..、以 / 开头的条目跳过,提示中会注明跳过的数量

压缩包的顶层应当是 Skill 文件夹,每个文件夹中包含 SKILL.md。只要其中一个 Skill 无法解析,整个导入都会取消,提示中会写明出错的 Skill 名称与原因,现有数据保持不变。

数据保存位置 ​

导入、新建和修改过的 Skill 都保存在当前浏览器的扩展本地存储中,不会上传到服务器。卸载扩展会清除这些数据;换浏览器或换设备前,请先导出备份,再在新环境中导入。

常见问题 ​

输入「/」后没有看到某个 Skill,怎么办? ​

打开「Skill 技能」面板,确认该 Skill 在列表中。如果是刚在配置页新建的 Skill,确认已经保存。候选列表会按输入的文字筛选,可以删除 / 后的内容再看。

修改了 Skill,为什么对话结果没有变化? ​

确认编辑区显示「已保存」。保存后,之后发送的消息才会使用新内容,已经发出的消息不受影响。

从 GitHub 导入失败,怎么办? ​

按以下顺序检查:

  1. 链接是否为目录链接,格式为 https://github.com/<用户或组织>/<仓库>/tree/<分支或标签>/<Skill 目录>。仓库首页或单个文件的链接无法导入。
  2. 仓库是否公开,链接指向的目录中是否直接包含 SKILL.md。
  3. 当前网络能否访问 GitHub。网络受限时,可以先把该目录下载到本地,再使用「从本地目录导入」。

导入时提示与内置 Skill 重名,怎么办? ​

把 SKILL.md 中的 name 改成其他名称后重新导入。

为什么某个 Skill 没有「删除」按钮? ​

标有「内置」的 Skill 随扩展提供,不能删除。如果修改过它,可以在配置页的文件树中选择「恢复全部内置默认」撤销修改。

再次导入同名 Skill 后,原来的内容不见了? ​

从「Skill 技能」面板导入同名 Skill 时,新内容会覆盖原有内容。如果之前导出过备份,可以在配置页通过「导入备份」恢复。

相关链接 ​