skills-cli

使用此技能通过 skills CLI 帮助用户使用开放的 Agent Skills 生态系统。

概述

skills CLI 是用于安装 Agent Skills 的包管理器。使用它来发现技能、使用合适的标志安装技能，并在安装后管理技能。

以下示例使用 bunx skills；如果用户的环境中没有 Bun，npx skills 的工作流相同。

始终优先使用当前 CLI 语法：

bunx skills add <source> --skill <name>

不要使用较旧的 owner/repo@skill-name 示例。

适用场景

用户遇到以下情况时使用此技能：

• 询问“有没有适用于 X 的技能？”“有没有 X 技能？”或“如何完成 X？”，且 X 听起来像一种可复用的工作流
• 询问“你能完成 X 吗？”，且 X 听起来像一种可能已有对应技能的专门能力
• 需要有关 bunx skills、npx skills、skills.sh、技能包安装或 skills-lock.json 的帮助
• 想要为 Codex 或 OpenCode 等特定 Agent 安装技能
• 想要列出、检查、更新、移除、恢复、同步、备份或初始化已安装的技能
• 想要搜索工作流、工具、模板或特定领域的能力，例如设计、测试、部署、文档编写或代码审查

当用户已有本地技能，且想要编写或改进其内容时，不要使用此技能。这种情况下，请改用技能创作工作流。

发现工作流

当用户需要技能时，按以下顺序操作：

1. 确定领域和任务。 示例：React 性能优化、PR 审查、更新日志生成、PDF 提取。 同时判断此任务是否足够常见，以至于可能已有可复用的技能。
2. 先查看 skills.sh。 如果该领域已有相关技能，优先选择知名且安装量高的技能。
3. 如果排行榜无法明确满足需求，使用以下命令搜索：

bunx skills find <query>

1. 推荐前先验证质量：
   • 安装量：优先选择安装量超过 1K 的技能；对安装量低于 100 的技能保持谨慎
   • 来源信誉：优先选择 openai、anthropics、microsoft 等官方或成熟维护者，以及同样值得信赖的发布者
   • 仓库质量：检查源代码仓库；对来自星标数少于 100 的仓库的技能保持谨慎
2. 清晰地介绍各个选项。 包括技能名称、用途、安装量和来源、可信的原因、安装命令，以及在 skills.sh 上了解详情的链接。
3. 如果用户想继续，请提供安装帮助。
4. 如果没有合适的技能，直接说明，并使用通用能力帮助用户完成任务；同时告知用户可以使用 bunx skills init 创建自己的包。

安装速查

常见来源

# GitHub shorthand
bunx skills add xixu-me/skills

# Full GitHub URL
bunx skills add https://github.com/xixu-me/skills

# Direct path to one skill inside a repo
bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli

# GitLab URL
bunx skills add https://gitlab.com/org/repo

# Any git URL
bunx skills add [email protected]:owner/repo.git

# Local package path
bunx skills add ./my-local-skills

常见安装模式

# List skills in a package without installing
bunx skills add <source> --list

# Install one skill
bunx skills add <source> --skill skills-cli

# Install multiple skills
bunx skills add <source> --skill pr-review --skill commit

# Install globally
bunx skills add <source> --skill skills-cli -g -y

# Install to a specific agent
bunx skills add <source> --skill skills-cli -a codex -y

# Install all skills to all agents
bunx skills add <source> --all

# Install all skills to one agent
bunx skills add <source> --skill '*' -a codex -y

# Copy files instead of symlinking
bunx skills add <source> --skill skills-cli -a codex --copy -y

安装方式

用户选择安装方式时：

• 符号链接是默认方式，通常也是最佳选择，因为更新会集中管理
• --copy 会创建独立副本；当不支持符号链接或使用符号链接不方便时，可将其作为备用方式

如果用户只是要求安装技能，除非其提到 CI 打包、可移植性、文件系统限制，或明确要求复制，否则优先使用默认的符号链接工作流。

重要标志

标志	用途
--skill <name>	安装一个或多个指定名称的技能
-a, --agent <agent>	指定目标 Agent，例如 codex
-g, --global	安装到用户级，而非项目级
-y, --yes	跳过提示
--list	列出包中可用的技能
--copy	复制而非创建符号链接
--all	所有技能安装到所有 Agent 的简写形式

管理已安装的技能

使用以下命令进行日常维护：

# List installed skills
bunx skills ls
bunx skills ls -g
bunx skills ls -a codex
bunx skills ls --json

# Check for updates
bunx skills check

# Update installed skills
bunx skills update

# Remove installed skills
bunx skills remove my-skill
bunx skills remove my-skill -a codex
bunx skills remove -g my-skill
bunx skills remove --all

# Initialize a new skill package
bunx skills init
bunx skills init my-skill

# Restore from skills-lock.json
bunx skills experimental_install

# Sync node_modules skills into agent directories
bunx skills experimental_sync
bunx skills experimental_sync -a codex -y

当用户要求初始化技能时，说明他们想要哪种方式：

• 使用 bunx skills init 在当前目录中创建 SKILL.md
• 使用 bunx skills init <name> 创建一个包含 SKILL.md 的新子目录

相关工具：Skills Vault

如果用户希望在不同机器或团队之间以声明式方式备份和还原已安装的技能，请使用 Skills Vault。

Skills Vault 是 skills 生态系统的独立 CLI 配套工具。它不是可通过 skills add 安装的技能来源。当用户希望将已安装的技能快照保存到清单中、预览还原命令，或在其他地方重现相同配置时，请使用它。

常用的配套命令：

# Back up installed skills into skvlt.yaml
bunx skvlt backup

# Preview a restore
bunx skvlt restore --dry-run

# Restore everything from the manifest
bunx skvlt restore --all

# Diagnose the local environment
bunx skvlt doctor

当用户明确希望使用可移植的清单工作流、在不同机器间备份和还原，或与团队共享已安装技能配置时，优先使用此工具，而不是 skills experimental_*。

推荐格式

推荐技能时，回答要具体且可安装。

使用类似以下的结构：

I found a skill that should fit.

Skill: <skill-name>
Why it matches: <one sentence>
Source: <owner/repo or URL>
Quality check: <install count / source reputation / repository confidence note>
Install:
bunx skills add <source> --skill <skill-name> [optional flags]
Learn more: https://skills.sh/<publisher>/<package>/<skill-name>

If you want, I can install it for <agent-or-scope>.

如果用户提到了目标 Agent 或范围，请将其包含在命令中。例如：

bunx skills add <source> --skill <skill-name> -a codex -y
bunx skills add <source> --skill <skill-name> -g -y

示例：

I found a skill that might help.

Skill: screenshot
Why it matches: it focuses on OS-level desktop and window screenshot capture.
Source: openai/skills
Quality check: high install volume, trusted publisher, and a widely used source repository.
Install:
bunx skills add openai/skills --skill screenshot
Learn more: https://skills.sh/openai/skills/screenshot

常见技能类别

当用户的措辞比较模糊时，可将其对应到可能的类别：

类别	示例查询
Web 开发	react、nextjs、typescript、css、tailwind
测试	testing、jest、playwright、e2e
DevOps	deploy、docker、kubernetes、ci-cd
文档	docs、readme、changelog、api-docs
代码质量	review、lint、refactor、best-practices
设计	ui、ux、design-system、accessibility
效率	workflow、automation、git

搜索技巧

• 使用具体关键词。react testing 比单独搜索 testing 更好。
• 尝试其他说法。如果搜索 deploy 无果，可尝试 deployment 或 ci-cd。
• 优先查看热门来源。许多优质技能来自成熟的发布者。
• 如果首次搜索范围太广，可结合领域和任务缩小范围。

常见错误

• 未检查技能是否来自可靠来源，就根据搜索结果进行推荐。
• 用户指定了某个 Agent，却忘记添加 -a <agent>。
• 将 bunx skills find --help 当作真正的帮助命令。请使用 bunx skills --help 查看命令帮助。
• 一次不理想的关键词搜索无结果，就断定不存在相关技能。请先尝试更具体或相近的查询。

故障排除

如果用户遇到错误或难以理解的结果：

• “No skills found”——建议换用更合适的查询词，查看 skills.sh，或直接提供帮助并提及 bunx skills init
• 自动化或 CI 中出现交互式提示——添加 -y
• 安装范围不正确——在项目级安装和 -g 之间切换
• 符号链接问题——使用 --copy 重试
• 不确定软件包包含哪些内容——运行 bunx skills add <source> --list
• 不确定安装状态——运行 bunx skills ls 或 bunx skills ls --json
• 需要在不同机器间进行可移植的备份或还原——提及 Skills Vault 及其 backup / restore --dry-run 工作流

如果不确定具体的标志，请使用：

bunx skills --help