使用 npx skills 工具来彻底解决不同 AI 智能体（如 Claude Code 或 Kimi）技能碎片化问题

如果你在电脑上运行了多个 AI 智能体（Agent）或 CLI 工具——无论是 Hermes、Claude Code、Codex、Antigravity、Kimi 还是其他受支持的工具，你可能都遇到过一个极其令人沮丧的问题：技能碎片化（skills fragmentation）。每个智能体或 CLI 都会维护自己独立的 skills 文件夹，这会导致重复安装、版本偏差以及极高的管理维护成本。

在日常使用 AI 智能体的过程中，我们经常会遇到以下痛点：

• 重复安装：为一个智能体安装了新技能后，还必须为其他智能体一次又一次地重复安装。
• 版本偏差（Version Drift）：在某个智能体中定制或修复了某个技能，却忘记同步更新其他智能体，导致不同的智能体表现出不一致的行为。
• 技能管理混乱：必须逐个翻看系统里每个智能体的 skills 文件夹，才能知道到底安装了哪些技能。

由 Vercel 推出的开源 CLI 工具 npx skills 完美地解决了这个问题。它允许你建立并管理一个统一的、中央化的 skills 文件夹，并无缝共享给所有的智能体。你可以前往 npx skills 的 GitHub 仓库了解更多信息。

技能一元化管理

这个方案的核心概念非常简单：如果我们把每个智能体的 skills 文件夹都指向同一个物理文件夹，那么碎片化问题就会迎刃而解。

当你使用 npx skills CLI 安装技能时，该技能会被下载到你电脑上的中央统一文件夹（~/.agents/skills）。接着，CLI 会自动在各个智能体的 skills 文件夹中创建软链接（Symlink，即指向实际文件夹的快捷方式），直接导向该中央文件夹。

例如，当 Claude Code 在 ~/.claude/skills/ 中寻找技能时，它会被透明地重定向到 ~/.agents/skills。只要你对中央文件夹中的技能进行任何微调，所有智能体都会立刻同步应用。无需手动复制，无需编写同步脚本，更不会浪费任何硬盘空间。

安装 npx skills 并添加技能

运行以下命令来开始并添加我们的第一个技能：

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

CLI 会询问是将此配置应用于特定项目还是全局（globally）。我们通常推荐选择 global（全局），以便所有受支持的智能体都能访问它：

接下来，请务必选择 Symlink 以确保唯一可信数据源（Single Source of Truth）：

完成后，我们可以验证该技能是否已经正确安装在中央统一文件夹 ~/.agents/skills 中：

打开 Kimi CLI（或任何其他智能体），你会发现 excalidraw-diagram 技能已经立即可用！

从零开始创建技能

如果你想自建专属技能，可以使用 Anthropic 的 skill-creator 工具。通过以下命令进行安装：

npx skills add https://github.com/anthropics/skills --skill skill-creator

现在，在 Kimi 或任何其他智能体中，输入以下提示词（Prompt）：

Use the skill-creator to help me build a skill for creating a product landing page

Kimi 或你的智能体会自动识别 skill-creator 并引导你一步步完成创建过程：

其他实用的 npx skills 命令

以下是一些常用的便捷命令：

• npx skills ls -g：列出所有全局安装的技能
• npx skills update：仅需一条命令即可将所有技能一键更新到最新版本
• npx skills remove：以交互式的方式卸载/移除某个技能

请参阅 npx skills 的 GitHub 仓库以获取更多命令和参考文档。

进阶玩法：结合 Git 管理

由于现在所有的技能都集中在一个地方（~/.agents/skills），我们可以将其初始化为一个 Git 仓库，并推送到 GitHub 或 GitLab 进行备份与版本控制。

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

这样，我们就拥有了技能修改的完整历史记录。万一某次更新破坏了功能，我们可以非常轻松地回滚（Rollback）。此外，如果你有多台电脑（例如笔记本和台式机），只需运行一次快速的 git pull，即可在不同设备间无缝同步所有技能。

几点注意事项（安全与风险）

• 兼容性差异：并非所有的智能体平台都完全支持所有功能（例如自定义钩子 custom hooks 或特定的授权工具）。某个技能在 A 智能体上运行顺畅，在 B 智能体上可能会遇到功能限制。
• 来源可信度：请务必只从信任的来源安装技能。
• 运行前代码审查：如果你使用的是自定义或第三方的技能，在授权智能体运行 it 之前，请务必先审查其代码文件（尤其是 scripts/ 文件夹下的内容）。
• 最小权限原则：尽量不要给技能授予超出其核心功能所需的工具权限或系统访问权限。
• 切勿硬编码敏感信息：千万不要在技能文件中直接写入 API 密钥（API Keys）或其他敏感凭证。

使用 npx skills 建立“唯一可信数据源”后，我们的团队彻底摆脱了版本混乱和重复配置的烦恼。强烈建议你尝试一下——随着技能库的不断丰富， AI 智能体的能力也将迎来爆发式增长！