skills-cli

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

概述

skills CLI是可安装Agent技能的包管理器。使用它来发现技能、使用正确的标志安装它们，并在安装后管理它们。

以下示例使用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提取。
   同时判断任务是否足够常见，以至于可能存在可重用的技能。
2. 首先检查skills.sh。
   当领域已被覆盖时，优先选择知名且安装量高的技能。
3. 如果排行榜不能明确回答需求，使用以下命令搜索：

bunx skills find <query>

4. 在推荐之前验证质量：
   • 安装量：优先选择安装量超过1000的技能，对低于100的技能保持谨慎
   • 来源信誉：优先选择官方或信誉良好的维护者，如openai、anthropics、microsoft或类似可信发布者
   • 仓库质量：检查源代码仓库，对星标少于100的仓库中的技能持怀疑态度
5. 清晰呈现选项。
   包括技能名称、用途、安装量和来源、为何看起来可信、安装命令以及skills.sh上的了解更多链接。
6. 如果用户想继续，提供安装帮助。
7. 如果没有合适的技能，直接说明，使用你的通用能力帮助完成任务，并提及用户可以使用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打包、可移植性、文件系统限制或明确要求副本，否则优先使用默认的符号链接工作流。

重要标志

标志	用途
--skill <name>	安装一个或多个指定技能
-a, --agent <agent>	针对特定代理，如codex
-g, --global	在用户范围而非项目范围安装
-y, --yes	跳过提示
--list	列出包中可用技能
--copy	复制而非符号链接
--all	所有技能安装到所有代理的简写

管理已安装技能

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

# 列出已安装技能
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

常见技能类别

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

类别	示例查询
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。
• 首先检查热门来源。许多强大的技能来自知名发布者。
• 如果第一次搜索太宽泛，按领域加任务缩小范围。

常见错误

• 推荐搜索结果中的技能而不检查其是否成熟。
• 当用户要求特定代理时忘记指定-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