适用于 VS Code 中的 Copilot agent mode；官方页面未说明统一最低客户端版本。Agent Customizations 编辑器标为 Preview。未安装或实机测试；技能脚本与外部依赖须单独审查。
準備
- 已安装 VS Code，并能在其中使用 GitHub Copilot Chat 的 Agent mode；官方指南未列出统一的最低 VS Code 版本号。
- 准备 Skills-SI 市场中目标技能的条目；下载前确认作者、许可证、来源及其引用的脚本和外部依赖。
- 决定安装范围：只对当前仓库生效，或放入用户目录供多个项目共用。
導入と利用手順
- 01
准备：确认 Agent mode 与安装范围
确认 Copilot Chat 可用，并选择 Agent mode；Skills 的官方支持范围包含 VS Code agent mode。决定采用项目级或用户级目录。VS Code 的 Agent Customizations 编辑器目前标为 Preview，但它不是使用技能的唯一方式。MCP 服务器、提示词或自定义指令不等同于 Agent Skill。
根拠と出典SKILL.md + resources動作確認手順・フォルダーの概念図。公式画面ではありません。 - 02
从 Skills-SI 本站下载目标包
从本站对应技能条目的下载入口获取其 ZIP 包。核对条目所示作者、许可及来源；本站下载不代表 GitHub 或上游作者背书，也不能替代安全审查。
根拠と出典SKILL.md + resources動作確認手順・フォルダーの概念図。公式画面ではありません。 - 03
解压并检查完整目录
解压 ZIP 后找到技能自己的完整文件夹，不能只拷贝 SKILL.md。检查 SKILL.md 的 YAML 元数据和说明，并阅读其中引用的脚本、示例、资源及外部依赖；对来历不明或行为不清的脚本不要运行。
解压后的完整技能目录（保留 SKILL.md 及包内配套文件）根拠と出典解压后的完整技能目录（保留 SKILL.md 及包内配套文件）動作確認手順・フォルダーの概念図。公式画面ではありません。 - 04
复制到 VS Code 支持的位置
将完整技能文件夹放入所选位置：仓库内的 .github/skills/，或用户主目录下的 ~/.copilot/skills/。每项技能应有独立子目录；SKILL.md 的 name 必须与父目录名相同，名称只用小写字母、数字和连字符。不要把旧的 chat.agentSkillsLocations 自定义位置误当作通用发现路径；官方说明该设置已弃用且仅供 Local agent 使用。
项目级：<仓库>/.github/skills/<技能名>/；用户级：~/.copilot/skills/<技能名>/根拠と出典项目级：<仓库>/.github/skills/<技能名>/；用户级：~/.copilot/skills/<技能名>/動作確認手順・フォルダーの概念図。公式画面ではありません。 - 05
调用并完成首次练习
在 Copilot Chat 输入 /skills 打开技能配置菜单；默认情况下，技能可作为斜杠命令使用，也可由 Copilot 按描述自动选择。若该技能设置 user-invocable: false，则不会出现在斜杠菜单，应以与其 description 匹配的请求测试自动加载。可用虚构的 15 分钟项目协调会纪要，要求适用的会议整理技能提取决定、行动项和负责人；不要输入真实客户资料。
目标技能目录内的 SKILL.md/skills；如技能允许用户调用，则用 /<技能名> 调用根拠と出典目标技能目录内的 SKILL.md動作確認手順・フォルダーの概念図。公式画面ではありません。 - 06
验证加载与输出
确认配置菜单或斜杠菜单能发现技能，检查其名称和说明，再用匹配技能描述的虚构请求观察回答是否遵循说明。若技能依赖其他文件，确认 SKILL.md 使用相对路径引用它们。对生成内容及任何建议执行的脚本仍需人工检查；单次回答不能证明技能在所有情境下都会自动触发。
项目级：<仓库>/.github/skills/<技能名>/SKILL.md；或用户级：~/.copilot/skills/<技能名>/SKILL.md/skills根拠と出典项目级：<仓库>/.github/skills/<技能名>/SKILL.md；或用户级：~/.copilot/skills/<技能名>/SKILL.md動作確認手順・フォルダーの概念図。公式画面ではありません。 - 07
禁用或卸载
卸载时关闭 Copilot Chat 对目标技能的使用，并从其原安装位置移除该技能的整个子目录；项目级只影响该仓库，用户级影响使用该用户目录的项目。删除前确认路径和备份需要保留的本地改动；不要删除父级 skills 目录或其他技能。
删除目标技能子目录：<仓库>/.github/skills/<技能名>/ 或 ~/.copilot/skills/<技能名>/根拠と出典删除目标技能子目录：<仓库>/.github/skills/<技能名>/ 或 ~/.copilot/skills/<技能名>/動作確認手順・フォルダーの概念図。公式画面ではありません。
練習と合格基準
对虚构的 15 分钟项目协调会纪要使用适用的会议整理技能，要求输出决定、行动项和负责人；检查是否依据技能说明组织内容。
- 输入 /skills 查看技能配置菜单；默认可调用技能也可在聊天输入 /<技能名>，但 user-invocable: false 的技能不显示在斜杠菜单。
- 检查 SKILL.md 的 name 与技能父目录同名，且 description 描述了能力和适用场景。
- 用符合技能用途的虚构输入检查输出；复核其是否遵循说明及是否正确引用配套资源。
- 人工审阅技能所含脚本及 Copilot 提出的操作；不要仅凭技能被发现或一次输出判断安全、正确或始终自动触发。
無効化と削除
- 确认技能实际装在项目级还是用户级目录。
- 备份需保留的修改，然后移除对应的整个技能子目录，而不是只删 SKILL.md。
- 回到 VS Code 的 /skills 菜单或以聊天确认不再发现该技能；若仍在其他支持目录存在，检查并移除那一份。
トラブル対応
技能未出现在 / 菜单或配置菜单。
确认它位于官方支持的项目级或用户级目录，技能文件名为 SKILL.md；再核对 YAML frontmatter、必需的 name/description，以及 name 与父目录是否匹配。检查 user-invocable 是否设为 false；该设置会隐藏斜杠命令。
Copilot 没有自动使用技能。
让请求与 description 中的能力和触发情境相符；确认 disable-model-invocation 未设为 true。需要手动调用时，检查 user-invocable 设置及技能名。
技能读取不到附带模板或资源。
确保完整目录已复制，而不只是 SKILL.md；检查说明里的相对路径是否正确，并确认所引用文件确实在该目录中。
技能建议运行脚本，或执行步骤出现权限提示。
先人工阅读脚本及其依赖，只在理解并信任后才考虑运行；不要为省去确认而预先批准 shell/bash。可跳过脚本，并手动完成安全的说明性步骤。
旧配置位置的技能未被发现。
迁移到官方文档列出的支持位置；VS Code 文档注明 chat.agentSkillsLocations 已弃用且仅用于 Local agent，不能据此假定其他 agent 会发现该目录。
根拠と出典
- https://code.visualstudio.com/docs/copilot/customization/agent-skills
VS Code 官方正文：Agent Skills 的支持范围、项目级与用户级目录、SKILL.md 格式、/skills 与斜杠调用、自动加载、资源引用、设置限制及安全注意事项。
- https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
GitHub 官方正文：Agent Skills 在 VS Code agent mode 等产品中的支持，以及项目技能和个人技能的目录范围。
- https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills
GitHub 官方正文：技能目录与 SKILL.md 结构、完整目录及附带资源、脚本授权风险；用于交叉核验，不将 GitHub CLI 或 MCP 当作技能本身。