managing-skills

通过 `npx skills` CLI 管理 Agent 技能。处理从 GitHub 仓库安装技能、搜索可用技能、检查更新以及更新已安装的技能。

<quick_start> 确定用户想要执行的操作，并运行相应命令。始终添加 --yes 以跳过确认。除非另有说明，默认在项目级别安装，并使用当前 Agent 类型。

主要命令：

npx skills add {source} --yes --agent {agent-type}
npx skills find {keyword} --yes
npx skills check --yes
npx skills update --yes
npx skills add --list --yes

</quick_start>

检测当前运行的 Agent。将其映射到正确的 `--agent` 标志值：

Agent	标志值
Amp	amp
Claude Code	claude-code
Cline	cline
Codex	codex
Continue	continue
Cursor	cursor
Gemini CLI	gemini-cli
GitHub Copilot	github-copilot
Goose	goose
Kilo Code	kilo
Kiro CLI	kiro-cli
OpenCode	opencode
Qwen Code	qwen-code
Roo Code	roo
Trae	trae
Windsurf	windsurf

如果不确定，请检查配置目录（例如 .claude/、.codex/、.cursor/）。 只有在用户明确要求时，才添加其他 Agent 类型（例如“为所有 Agent 安装”或“也为 codex 安装”）。 </agent_type>

<install_scope>

• 项目级（默认）：安装到当前项目中的 ./<agent>/skills/。
• 全局（-g）：安装到 ~/<agent>/skills/。只有用户提到“全局”“在全局范围内”或“用于所有项目”时才使用。 </install_scope>

用户说：安装、添加、获取、设置技能 1. 确定技能来源。支持： - `owner/repo` — 安装仓库中的所有技能 - 指向仓库、目录或 SKILL.md 文件的完整 GitHub/GitLab URL（例如 `https://github.com/owner/repo/tree/main/skills/foo`） - 本地文件系统路径 - 对于包含多个技能的仓库，使用 `-s skill-name` 按名称选装特定技能 2. 确定范围：项目级（默认）或全局（`-g`）。 3. 确定目标 Agent 类型。 4. 运行： ```bash npx skills add {source} --yes --agent {agent-type} ``` 如果是全局安装，添加 `-g`。如果目标是多个 Agent，添加多个 `--agent` 标志。 “安装 vercel-labs/skills 技能” → `npx skills add vercel-labs/skills --yes --agent claude-code`

“只从该仓库安装 managing-skills 技能” → npx skills add vercel-labs/skills --yes -s managing-skills --agent claude-code

“安装此技能：github.com/owner/repo/tree/main/skills/foo” → npx skills add https://github.com/owner/repo/tree/main/skills/foo --yes --agent claude-code

“为所有 Agent 全局安装 foo/bar” → npx skills add foo/bar --yes -g --all

用户说：查找、搜索、发现、寻找、浏览技能 1. 如果用户提供了关键词，直接传入。 2. 运行： ```bash npx skills find {keyword} --yes ``` 3. 向用户展示结果。如果用户选定一项，则执行安装操作。 用户说：检查更新、我的技能是否都是最新版本 运行： ```bash npx skills check --yes ``` 报告哪些技能有可用更新。如果发现更新，询问用户是否要更新。 用户说：更新技能、升级技能 运行： ```bash npx skills update --yes ``` 报告更新了哪些内容。 用户说：列出技能、显示已安装的技能、我有哪些技能 运行： ```bash npx skills add --list --yes ``` - 始终使用 `--yes` 跳过确认提示。 - 默认使用项目级范围，除非用户明确要求全局安装。 - 默认仅使用当前 Agent 类型。只有用户提出要求时才添加其他 Agent。 - 如果命令失败，显示错误输出并建议解决方法（例如检查来源 URL 或网络连接）。 - 安装后确认成功，并说明技能的安装位置。 - 请求的技能操作已成功完成。 - 已向用户显示操作结果确认信息。 - 范围和 Agent 目标符合用户意图（项目级/全局，且 Agent 正确）。