wehub/skillhub-080-skills-cli
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
main
skillhub-080-skills-cli/SKILL.md
T
wehub-skill-sync b5a4a8ffa9 chore: import zh skill skills-cli
2026-07-13 21:36:12 +08:00

10 KiB
Raw Permalink Blame History

name, description
name description
skills-cli 当用户询问如何发现、安装、列出、检查、更新、移除、备份、恢复、同步或初始化 Agent Skills，提及 `bunx skills`、`npx skills`、`skills.sh` 或 `skills-lock.json`，询问"找一个做 X 的 skill"，或希望借助可安装技能扩展 Agent 能力时，使用本技能。

使用本技能帮助用户通过 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 的 skill"、"有没有做 X 的 skill"或"如何做 X"，且 X 听起来像是一个可复用的工作流
  • 询问"你能做 X 吗"，且 X 听起来像是一种可能已存在对应技能的专门能力
  • 希望获得有关 bunx skills、npx skills、skills.sh、技能包安装或 skills-lock.json 的帮助
  • 希望为特定 Agent（如 Codex 或 OpenCode）安装技能
  • 希望列出、检查、更新、移除、恢复、同步、备份或初始化已安装的技能
  • 希望获得搜索工作流、工具、模板或领域特定能力（如设计、测试、部署、文档或代码审查）的帮助

当用户已有本地技能并希望编写或改进其内容时，不要使用本技能。此时应使用技能创作工作流。

发现工作流

当用户需要某个技能时，按照以下顺序进行：

  1. 确定领域和任务。 示例：React 性能、PR 审查、变更日志生成、PDF 提取。 同时判断该任务是否足够常见，很可能已有可复用的技能存在。
  2. 首先查看 skills.sh。 如果该领域已有覆盖，优先选择知名度高、安装量大的技能。
  3. 如果排行榜无法明确满足需求，使用以下命令搜索：
bunx skills find <query>
  1. 在推荐任何内容之前先验证质量：
    • 安装量：优先选择安装量在 1K+ 的技能，对低于 100 的技能要谨慎
    • 来源信誉：优先选择官方或成熟维护者，如 openai、anthropics、microsoft 或类似的可信发布者
    • 仓库质量：检查源代码仓库，对 stars 数少于 100 的仓库中的技能保持怀疑态度
  2. 清晰呈现选项。 包括技能名称、它做什么、安装量和来源、为何看起来可信、安装命令，以及前往 skills.sh 了解更多信息的链接。
  3. 如果用户希望继续，提供安装帮助。
  4. 如果没有找到合适的技能，直接说明，利用你的通用能力帮助用户完成任务，并提及用户可以使用 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

# 安装到指定 Agent
bunx skills add <source> --skill skills-cli -a codex -y

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

# 将所有技能安装到一个 Agent
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> 针对特定 Agent，例如 codex
-g, --global 安装在用户作用域而非项目作用域
-y, --yes 跳过提示
--list 列出包中可用的技能
--copy 复制而非符号链接
--all 将所有技能安装到所有 Agent 的简写

管理已安装的技能

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

# 列出已安装的技能
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 中的技能同步到 Agent 目录
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> 安装它。

如果用户提到了目标 Agent 或作用域，将其包含在命令中。示例：

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。
  • 先查看热门来源。许多优秀技能来自成熟发布者。
  • 如果首次搜索范围太广，通过领域加任务进行缩小。

常见错误

  • 推荐搜索结果中的技能前，未检查其是否看起来足够成熟。
  • 用户指定了特定 Agent 时，忘记指定 -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
Reference in New Issue View Git Blame Copy Permalink