skills-cli

name: skills-cli
description: 当用户要求发现、安装、列出、检查、更新、移除、备份、恢复、同步或初始化代理技能时，请提及`bunx skills`、`npx skills`、`skills.sh`或`skills-lock.json`，当用户询问“find a skill for X”或希望扩展代理能力以使用可安装技能时使用。

使用此技能来帮助用户通过 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）安装技能
• 希望列出、检查、更新、移除、恢复、同步、备份或初始化已安装的技能
• 希望获得关于搜索工作流、工具、模板或特定领域能力（如设计、测试、部署、文档或代码审查）的帮助

当用户已经有一个本地技能并希望帮助编写或改进其内容时，请勿使用此技能。在这种情况下，请改用技能编写工作流。

发现工作流

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

1. 确定领域和任务。

示例：React 性能、PR 审查、变更日志生成、PDF 提取。

同时判断该任务是否足够常见，以至于可能存在可复用的技能。

1. 首先检查 skills.sh。

如果该领域已有知名且安装量高的技能，则优先选择它们。

1. 如果排行榜没有明确回答需求，则使用以下命令搜索：

bunx skills find <query>

1. 在推荐任何内容前验证质量：

• 安装量：优先选择安装量超过 1K 的技能，对低于 100 的保持谨慎
• 来源信誉：优先选择官方或知名维护者，如 openai、anthropics、microsoft 或类似可信发布者
• 仓库质量：检查源码仓库，对 star 数低于 100 的仓库中的技能持怀疑态度

1. 清晰地展示选项。

包括技能名称、它能帮助解决的问题、安装量和来源、为何看起来可信、安装命令以及 skills.sh 上的了解更多链接。

1. 如果用户想要继续，提供安装帮助。
2. 如果没有合适的技能，直接说明，使用你的通用能力帮助完成任务，并提及用户可以使用 bunx skills init 创建自己的包。

安装快速参考

常见来源

# GitHub 简写
bunx skills add xixu-me/skills

# 完整的 GitHub URL
bunx skills add https://github.com/xixu-me/skills

# 仓库内某个技能的直接路径
bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli

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

# 任意 git URL
bunx skills add git@github.com:owner/repo.git

# 本地包路径
bunx skills add ./my-local-skills

常见安装模式

# 列出包中的技能但不安装
bunx skills add <source> --list

# 安装一个技能
bunx skills add <source> --skill skills-cli

# 安装多个技能
bunx skills add <source> --skill pr-review --skill commit

# 全局安装
bunx skills add <source> --skill skills-cli -g -y

# 安装到特定代理
bunx skills add <source> --skill skills-cli -a codex -y

# 将所有技能安装到所有代理
bunx skills add <source> --all

# 将所有技能安装到一个代理
bunx skills add <source> --skill '*' -a codex -y

# 复制文件而非创建符号链接
bunx skills add <source> --skill skills-cli -a codex --copy -y

安装方法

当用户选择安装方式时：

• 默认使用符号链接，通常是最佳选择，因为更新保持集中
• --copy 创建独立副本，是当符号链接不受支持或不方便时的备选方案

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

重要标志

管理已安装技能

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

# 列出已安装的技能
bunx skills ls
bunx skills ls -g
bunx skills ls -a codex
bunx skills ls --json

# 检查更新
bunx skills check

# 更新已安装的技能
bunx skills update

# 移除已安装的技能
bunx skills remove my-skill
bunx skills remove my-skill -a codex
bunx skills remove -g my-skill
bunx skills remove --all

# 初始化一个新的技能包
bunx skills init
bunx skills init my-skill

# 从 skills-lock.json 恢复
bunx skills experimental_install

# 将 node_modules 中的技能同步到代理目录
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 可安装的技能来源。当用户想要快照已安装技能到清单、预览恢复命令或在其他地方重现相同设置时使用。

常用配套命令：

# 将已安装的技能备份到 skvlt.yaml
bunx skvlt backup

# 预览恢复
bunx skvlt restore --dry-run

# 从清单恢复所有内容
bunx skvlt restore --all

# 诊断本地环境
bunx skvlt doctor

当用户明确想要可移植的清单工作流、跨机器备份和恢复，或者在团队间共享已安装技能配置时，优先使用此工具而非 skills experimental_*。

推荐格式

当推荐技能时，确保答案具体且可安装。

使用如下结构：

我找到了一个可能适合的技能。

技能名称：<skill-name>
匹配原因：<一句话>
来源：<owner/repo 或 URL>
质量检查：<安装量 / 来源信誉 / 仓库信心备注>
安装命令：
bunx skills add <source> --skill <skill-name> [可选标志]
了解更多：https://skills.sh/<publisher>/<package>/<skill-name>

如果您愿意，我可以为 <agent-or-scope> 安装它。

如果用户提到了目标代理或范围，请在命令中包含它。例如：

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

示例：

我找到了一个可能有所帮助的技能。

技能名称：screenshot
匹配原因：它专注于操作系统级别的桌面和窗口截图捕获。
来源：openai/skills
质量检查：高安装量、可信发布者、广泛使用的源码仓库。
安装命令：
bunx skills add openai/skills --skill screenshot
了解更多：https://skills.sh/openai/skills/screenshot

常见技能类别

当用户的措辞模糊时，将其映射到可能的类别：

搜索提示

• 使用具体的关键词。react testing 比仅用 testing 更好。
• 尝试替代术语。如果 deploy 失败，试试 deployment 或 ci-cd。
• 首先检查流行的来源。许多强大的技能来自成熟的发布者。
• 如果第一次搜索过于宽泛，通过领域加任务来缩小范围。

常见错误

• 不检查技能是否看起来成熟就推荐搜索结果中的技能。
• 当用户要求特定代理时，忘记指定 -a <agent>。
• 将 bunx skills find --help 视为真正的帮助命令。应使用 bunx skills --help 获取命令帮助。
• 仅凭一个弱的搜索词就假定没有技能存在。先尝试更具体或相邻的查询。

故障排除

如果用户遇到错误或令人困惑的结果：

• “未找到技能” - 建议更好的查询、检查 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