Back to Details

skills-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skills CLI

Skills CLI

Use this skill to help users work with the open Agent Skills ecosystem through the 
skills
CLI.
使用本skill帮助用户通过
skills
CLI操作开放的Agent Skills生态系统。

Overview

概述

The 
skills
CLI is the package manager for installable Agent Skills. Use it to discover skills, install them with the right flags, and manage them after installation.
Examples below use 
bunx skills
, but 
npx skills
is the same workflow if Bun is not available in the user's environment.
Always prefer the current CLI syntax:
bash
bunx skills add <source> --skill <name>
Do not use older 
owner/repo@skill-name
examples.
skills
CLI是可安装Agent Skills的包管理器。使用它可以发现skills，通过正确的参数安装它们，并在安装后进行管理。
以下示例使用
bunx skills
，如果用户环境中没有Bun，
npx skills
的使用流程完全相同。
请始终使用当前CLI语法：
bash
bunx skills add <source> --skill <name>
请勿使用旧版的
owner/repo@skill-name
示例。

When to Use

使用场景

Use this skill when the user:
  • asks "find a skill for X", "is there a skill for X", or "how do I do X" and X sounds like a reusable workflow
  • asks "can you do X" and X sounds like a specialized capability that may already exist as a skill
  • wants help with 
    bunx skills
    , 
    npx skills
    , 
    skills.sh
    , skill package installation, or 
    skills-lock.json
  • wants to install a skill for a specific agent such as Codex or OpenCode
  • wants to list, check, update, remove, restore, sync, back up, or initialize installed skills
  • wants help searching for workflows, tools, templates, or domain-specific capabilities such as design, testing, deployment, documentation, or code review
Do not use this skill when the user already has a local skill and wants help writing or improving its contents. In that case, use a skill-authoring workflow instead.
在以下场景下使用本skill：
  • 用户询问“为X找一个skill”、“有没有针对X的skill”或“我该如何做X”，且X听起来是可复用的工作流
  • 用户询问“你能做X吗”，且X听起来是可能已作为skill存在的特定能力
  • 用户需要关于
    bunx skills
    、
    npx skills
    、
    skills.sh
    、skill包安装或
    skills-lock.json
    的帮助
  • 用户想要为特定agent（如Codex或OpenCode）安装skill
  • 用户想要列出、检查、更新、移除、恢复、同步、备份或初始化已安装的skills
  • 用户需要帮助搜索工作流、工具、模板或特定领域的能力，如设计、测试、部署、文档或代码评审
当用户已有本地skill并需要帮助编写或改进其内容时，请勿使用本skill，此时应使用skill创作工作流。

Discovery Workflow

发现工作流

When a user needs a skill, follow this sequence:
  1. Identify the domain and task. Examples: React performance, PR review, changelog generation, PDF extraction. Also judge whether the task is common enough that a reusable skill is likely to exist.
  2. Check skills.sh first. Prefer well-known, well-installed skills when the domain is already covered there.
  3. If the leaderboard does not clearly answer the need, search with:
bash
bunx skills find <query>
  1. Verify quality before recommending anything:
    • install count: prefer skills with 1K+ installs and be cautious with anything under 100
    • source reputation: prefer official or well-established maintainers such as 
      openai
      , 
      anthropics
      , 
      microsoft
      , or similarly trusted publishers
    • repository quality: check the source repository and treat skills from repos with fewer than 100 stars skeptically
  2. Present the options clearly. Include the skill name, what it helps with, the install count and source, why it looks trustworthy, the install command, and a link to learn more on 
    skills.sh
    .
  3. Offer installation help if the user wants to proceed.
  4. If nothing fits, say so directly, help with the task using your general capabilities, and mention that the user can create their own package with 
    bunx skills init
    .
当用户需要skill时，请遵循以下步骤：
  1. 确定领域和任务。 示例：React性能优化、PR评审、变更日志生成、PDF提取。 同时判断该任务是否足够常见，大概率存在可复用的skill。
  2. 首先查看skills.sh。 当该领域已有覆盖时，优先选择知名、安装量高的skills。
  3. 如果排行榜无法明确满足需求，使用以下命令搜索：
bash
bunx skills find <query>
  1. 在推荐前验证质量：
    • 安装量：优先选择安装量1K+的skills，对安装量低于100的保持谨慎
    • 来源可信度：优先选择官方或知名维护者，如
      openai
      、
      anthropics
      、
      microsoft
      或其他可信发布者
    • 仓库质量：检查源仓库，对星数少于100的仓库中的skill保持怀疑
  2. 清晰呈现选项。 包含skill名称、适用场景、安装量和来源、可信原因、安装命令，以及
    skills.sh
    上的详情链接。
  3. 如果用户需要，提供安装帮助。
  4. 如果没有合适的skill，直接告知用户，使用通用能力帮助完成任务，并提及用户可以使用
    bunx skills init
    创建自己的包。

Installation Quick Reference

安装速查指南

Common sources

常见来源

bash
undefined
bash
undefined

GitHub shorthand

GitHub简写

bunx skills add xixu-me/skills
bunx skills add xixu-me/skills

Full GitHub URL

完整GitHub URL

bunx skills add https://github.com/xixu-me/skills
bunx skills add https://github.com/xixu-me/skills

Direct path to one skill inside a repo

仓库内单个skill的直接路径

bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli
bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli

GitLab URL

GitLab URL

bunx skills add https://gitlab.com/org/repo
bunx skills add https://gitlab.com/org/repo

Any git URL

任意Git URL

bunx skills add git@github.com:owner/repo.git
bunx skills add git@github.com:owner/repo.git

Local package path

本地包路径

bunx skills add ./my-local-skills
undefined
bunx skills add ./my-local-skills
undefined

Common install patterns

常见安装模式

bash
undefined
bash
undefined

List skills in a package without installing

列出包内可用skill但不安装

bunx skills add <source> --list
bunx skills add <source> --list

Install one skill

安装单个skill

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

Install multiple skills

安装多个skills

bunx skills add <source> --skill pr-review --skill commit
bunx skills add <source> --skill pr-review --skill commit

Install globally

全局安装

bunx skills add <source> --skill skills-cli -g -y
bunx skills add <source> --skill skills-cli -g -y

Install to a specific agent

为特定agent安装

bunx skills add <source> --skill skills-cli -a codex -y
bunx skills add <source> --skill skills-cli -a codex -y

Install all skills to all agents

为所有agent安装所有skills

bunx skills add <source> --all
bunx skills add <source> --all

Install all skills to one agent

为单个agent安装所有skills

bunx skills add <source> --skill '*' -a codex -y
bunx skills add <source> --skill '*' -a codex -y

Copy files instead of symlinking

复制文件而非创建符号链接

bunx skills add <source> --skill skills-cli -a codex --copy -y
undefined
bunx skills add <source> --skill skills-cli -a codex --copy -y
undefined

Installation methods

安装方式

When the user is choosing how to install:
  • symlink is the default and usually the best choice because updates stay centralized
  • --copy
    creates independent copies and is the fallback when symlinks are unsupported or inconvenient
If the user only asks to install a skill, prefer the default symlink workflow unless they mention CI packaging, portability, filesystem restrictions, or explicitly ask for copies.
当用户选择安装方式时：
  • 符号链接是默认方式，通常是最佳选择，因为更新会集中进行
  • --copy
    会创建独立副本，是符号链接不支持或不方便时的备选方案
如果用户仅要求安装skill，优先使用默认的符号链接工作流，除非用户提到CI打包、可移植性、文件系统限制或明确要求复制。

Important flags

重要参数

FlagUse
--skill <name>
install one or more named skills
-a, --agent <agent>
target specific agents such as 
codex
-g, --global
install at user scope instead of project scope
-y, --yes
skip prompts
--list
list available skills in a package
--copy
copy instead of symlink
--all
shorthand for all skills to all agents
参数用途
--skill <name>
安装一个或多个指定名称的skills
-a, --agent <agent>
针对特定agent，如
codex
-g, --global
在用户范围而非项目范围安装
-y, --yes
跳过提示
--list
列出包内可用的skills
--copy
复制文件而非创建符号链接
--all
为所有agent安装所有skills的简写

Managing Installed Skills

管理已安装的Skills

Use these commands for ongoing maintenance:
bash
undefined
使用以下命令进行日常维护：
bash
undefined

List installed skills

列出已安装的skills

bunx skills ls bunx skills ls -g bunx skills ls -a codex bunx skills ls --json
bunx skills ls bunx skills ls -g bunx skills ls -a codex bunx skills ls --json

Check for updates

检查更新

bunx skills check
bunx skills check

Update installed skills

更新已安装的skills

bunx skills update
bunx skills update

Remove installed skills

移除已安装的skills

bunx skills remove my-skill bunx skills remove my-skill -a codex bunx skills remove -g my-skill bunx skills remove --all
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

初始化新的skill包

bunx skills init bunx skills init my-skill
bunx skills init bunx skills init my-skill

Restore from skills-lock.json

从skills-lock.json恢复

bunx skills experimental_install
bunx skills experimental_install

Sync node_modules skills into agent directories

将node_modules中的skills同步到agent目录

bunx skills experimental_sync bunx skills experimental_sync -a codex -y

When the user asks to initialize a skill, explain whether they want:

- `bunx skills init` to create `SKILL.md` in the current directory
- `bunx skills init <name>` to create a new subdirectory containing `SKILL.md`
bunx skills experimental_sync bunx skills experimental_sync -a codex -y

当用户询问初始化skill时，说明他们的需求：

- `bunx skills init`在当前目录创建`SKILL.md`
- `bunx skills init <name>`创建包含`SKILL.md`的新子目录

Related Tool: Skills Vault

相关工具：Skills Vault

If the user wants declarative backup and restore of installed skills across machines or teams, use Skills Vault.
Skills Vault is a separate CLI companion for the 
skills
ecosystem. It is not a 
skills add
installable skill source. Use it when the user wants to snapshot installed skills into a manifest, preview restore commands, or reproduce the same setup elsewhere.
Common companion commands:
bash
undefined
如果用户需要跨机器或团队对已安装的skills进行声明式备份和恢复，请使用Skills Vault。
Skills Vault是
skills
生态系统的独立CLI配套工具，它不是可通过
skills add
安装的skill源。当用户明确需要可移植的清单工作流、跨机器备份恢复或团队共享已安装的skill配置时，使用本工具。
常用配套命令：
bash
undefined

Back up installed skills into skvlt.yaml

将已安装的skills备份到skvlt.yaml

bunx skvlt backup
bunx skvlt backup

Preview a restore

预览恢复操作

bunx skvlt restore --dry-run
bunx skvlt restore --dry-run

Restore everything from the manifest

从清单恢复所有内容

bunx skvlt restore --all
bunx skvlt restore --all

Diagnose the local environment

诊断本地环境

bunx skvlt doctor

Prefer this tool over `skills experimental_*` when the user explicitly wants a portable manifest workflow, cross-machine backup and restore, or team-sharing of installed skill setups.
bunx skvlt doctor

当用户明确需要可移植的清单工作流、跨机器备份恢复或团队共享已安装的skill配置时，优先使用本工具而非`skills experimental_*`命令。

Recommendation Format

推荐格式

When recommending a skill, keep the answer concrete and installable.
Use a structure like this:
text
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>.
If the user mentions a target agent or scope, include it in the command. Examples:
bash
bunx skills add <source> --skill <skill-name> -a codex -y
bunx skills add <source> --skill <skill-name> -g -y
Example:
text
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
推荐skill时，请保持回答具体且可直接安装。
使用如下结构：
text
我找到了一个符合需求的skill。

Skill: <skill-name>
匹配原因：<一句话说明>
来源：<owner/repo或URL>
质量验证：<安装量/来源可信度/仓库可信度说明>
安装命令：
bunx skills add <source> --skill <skill-name> [可选参数]
了解更多：https://skills.sh/<publisher>/<package>/<skill-name>

如果需要，我可以为<agent或范围>安装它。
如果用户提到了目标agent或范围，请在命令中包含。示例：
bash
bunx skills add <source> --skill <skill-name> -a codex -y
bunx skills add <source> --skill <skill-name> -g -y
示例：
text
我找到了一个可能有帮助的skill。

Skill: screenshot
匹配原因：专注于系统级桌面和窗口截图捕获。
来源：openai/skills
质量验证：安装量高、发布者可信、仓库被广泛使用。
安装命令：
bunx skills add openai/skills --skill screenshot
了解更多：https://skills.sh/openai/skills/screenshot

Common Skill Categories

常见Skill类别

When the user's wording is vague, map it to likely categories:
CategoryExample queries
Web Development
react
, 
nextjs
, 
typescript
, 
css
, 
tailwind
Testing
testing
, 
jest
, 
playwright
, 
e2e
DevOps
deploy
, 
docker
, 
kubernetes
, 
ci-cd
Documentation
docs
, 
readme
, 
changelog
, 
api-docs
Code Quality
review
, 
lint
, 
refactor
, 
best-practices
Design
ui
, 
ux
, 
design-system
, 
accessibility
Productivity
workflow
, 
automation
, 
git
当用户的表述模糊时，将其映射到可能的类别：
类别示例查询
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

Search Tips

搜索技巧

  • Use specific keywords. 
    react testing
    is better than just 
    testing
    .
  • Try alternative terms. If 
    deploy
    fails, try 
    deployment
    or 
    ci-cd
    .
  • Check popular sources first. Many strong skills come from established publishers.
  • If the first search is too broad, narrow by domain plus task.
  • 使用具体关键词。
    react testing
    比仅
    testing
    更好。
  • 尝试替代术语。如果
    deploy
    搜索无果，试试
    deployment
    或
    ci-cd
    。
  • 首先检查热门来源。很多优质skills来自知名发布者。
  • 如果第一次搜索结果太宽泛，通过“领域+任务”缩小范围。

Common Mistakes

常见错误

  • Recommending a skill from search results without checking whether it looks established.
  • Forgetting to specify 
    -a <agent>
    when the user asked for one particular agent.
  • Treating 
    bunx skills find --help
    like a real help command. Use 
    bunx skills --help
    for command help instead.
  • Assuming no skill exists after one weak search term. Try a more specific or adjacent query first.
  • 未检查是否成熟就推荐搜索结果中的skill。
  • 当用户指定了某个agent时，忘记添加
    -a <agent>
    参数。
  • 将
    bunx skills find --help
    当作真正的帮助命令。应使用
    bunx skills --help
    获取命令帮助。
  • 一次搜索结果不理想就假设不存在相关skill。先尝试更具体或相近的关键词。

Troubleshooting

故障排除

If the user hits an error or confusing result:
  • "No skills found" - suggest a better query, check skills.sh, or help directly and mention 
    bunx skills init
  • interactive prompts in automation or CI - add 
    -y
  • wrong installation scope - switch between project install and 
    -g
  • symlink issues - retry with 
    --copy
  • uncertainty about available package contents - run 
    bunx skills add <source> --list
  • uncertainty about installed state - run 
    bunx skills ls
    or 
    bunx skills ls --json
  • portable backup or restore across machines - mention Skills Vault and its 
    backup
    / 
    restore --dry-run
    workflow
When you are unsure about exact flags, use:
bash
bunx skills --help
如果用户遇到错误或困惑的结果：
  • “未找到skills” - 建议更好的查询词，查看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
    工作流
当你不确定具体参数时，使用：
bash
bunx skills --help