skills关于目录位置对AI工具影响的理解；如何下载skill；如何判断skill位置是否合理；skill怎么放；skill放哪里；skill是什么；

VS Code Copilot Agent Skills 完全理解

整理自实际踩坑经验，2026-03-04

一、什么是 Skill

Skill 是放在项目目录下的 .md 文件，VS Code 在启动 Copilot Agent 时会自动读取并注入到 AI 的上下文中，让 AI 获得额外的领域知识和行为指导。

.agents/skills/
└── my-skill/
└── SKILL.md ← AI 会读这个

SKILL.md 的基本格式：

```skill
—
name: skill-name
description: 用一句话描述这个 skill 的用途（AI 用这个判断何时触发）
—

# Skill 正文
…具体知识和指导内容…
```

二、各 AI 工具对应的 Skills 目录

数据来源：github.com/vercel-labs/skills 官方 README（2026-03-04）

使用 .agents/skills/ 的工具（通用组）

以下工具共用 .agents/skills/ 作为项目级目录，这也是推荐的通用目录：

使用专属目录的工具

⚠️ 注意区分 .agents/skills/（复数，Copilot 等通用）和 .agent/skills/（单数，Antigravity 专用）

结论：只维护 .agents/skills/ 就能覆盖 GitHub Copilot、Cline、Cursor、Amp、Codex、Gemini CLI、OpenCode 等主流工具。

三、两种创建 Skill 的方式

方式一：手动创建（推荐，精准控制）

直接在 .agents/skills/<skill-name>/SKILL.md 创建文件即可，只对 Copilot 等通用工具生效，不产生多余目录。

方式二：npx skills add（批量安装，多工具生效）

# 从 skills.sh 生态搜索
npx skills find <关键词>

# 安装（带 -y 跳过确认）
npx skills add <owner/repo@skill-name> -y

# 仅安装到指定工具（不加 -y，手动勾选）
npx skills add <owner/repo@skill-name>

-y 的作用： 跳过交互式工具选择界面，按检测结果全选默认工具。

不加 -y 时： 会弹出勾选界面，可以手动选择只安装给哪些工具。

四、npx skills add 的目录检测逻辑

npx skills add 会扫描项目根目录，根据已存在的目录特征判断安装了哪些工具：

检测到什么就往对应目录装一份，所以项目里有这些目录就会触发"多目录安装"。

五、文件存放关系（真实文件 vs 符号链接）

.agents/skills/find-skills/SKILL.md ← 真实文件（唯一）
↑
├─ .claude/skills/find-skills/SKILL.md (symlink)
├─ .continue/skills/find-skills/SKILL.md (symlink)
└─ .windsurf/skills/find-skills/SKILL.md (symlink)

其他工具目录里的文件是符号链接，不是副本，不浪费磁盘空间。 修改 .agents/skills/ 里的文件，所有工具同步生效。

六、Copilot 注入 Skill 的时机

Copilot 不是每次都读取完整 SKILL.md，而是两步走：

所以 description 写得准确很关键，它决定了 AI 何时使用这个 skill。

七、常用命令速查

# 搜索 skill
npx skills find <关键词>

# 安装（交互式，手动勾选目标工具）
npx skills add <owner/repo@skill-name>

# 安装（跳过确认，全选检测到的工具）
npx skills add <owner/repo@skill-name> -y

# 安装到指定工具（不弹选择界面）
npx skills add <owner/repo@skill-name> -a github-copilot -y

# 安装到全局（所有项目可用）
npx skills add <owner/repo@skill-name> -g -y

# 仅安装指定 skill（同一仓库有多个 skill 时）
npx skills add <owner/repo> –skill <skill-name>

# 列出仓库中所有可用 skill（不安装）
npx skills add <owner/repo> –list

# 查看已安装的 skill
npx skills list

# 检查 skill 更新
npx skills check

# 更新所有 skill
npx skills update

# 删除 skill
npx skills remove <skill-name>

# 创建新 skill 模板
npx skills init <skill-name>

# 浏览 skill 生态
# https://skills.sh/

-a 参数的 agent 名称对照

八、最佳实践

九、参考链接

Skills 生态

官方 Skill 仓库（可直接 npx skills add）

各工具官方 Skills 文档