install-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

install-skills

Install skills project-locally so the repository, not the operator's global environment, owns the shared workflow catalog.

在项目本地安装Skills，使仓库而非操作者的全局环境拥有共享工作流目录。

Preflight

前置检查

Read repository guidance first:
```
AGENTS.md
```
,
```
CLAUDE.md
```
if present, and any docs governing agent skills or shared tooling.
Inspect the current catalog if present:
bash
```
test -f skills-lock.json && npm_config_ignore_scripts=true npx --yes skills@latest list --json
```
If the repository exposes a wrapper such as
```
pnpm skills:list
```
, use that instead of the raw CLI list command.
Resolve the requested source and skill names. If the source contents or requested skill names are ambiguous, list before installing:
bash
```
npm_config_ignore_scripts=true npx --yes skills@latest add <source> --list
```

先阅读仓库指南：若存在
```
AGENTS.md
```
、
```
CLAUDE.md
```
以及任何管理Agent技能或共享工具的文档，请优先阅读。
检查当前已有的技能目录（若存在）：
bash
```
test -f skills-lock.json && npm_config_ignore_scripts=true npx --yes skills@latest list --json
```
如果仓库提供了诸如
```
pnpm skills:list
```
的封装脚本，请使用该脚本而非原生CLI列表命令。
确认请求的源和技能名称。若源内容或请求的技能名称不明确，请在安装前先列出可用技能：
bash
```
npm_config_ignore_scripts=true npx --yes skills@latest add <source> --list
```

Install

安装步骤

Run installs from the repository root. Do not use

--global

Canonical single-source install:

bash

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-name> --agent '*' --yes

For multiple skills from the same source, repeat

--skill

values as separate arguments after one flag:

bash

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-a> <skill-b> --agent '*' --yes

For all skills from a source, prefer an explicit all-agent install:

bash

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill '*' --agent '*' --yes

Use a pinned source when reproducibility matters:

bash

npm_config_ignore_scripts=true npx --yes skills@latest add owner/repo#<git-ref> --skill <skill-name> --agent '*' --yes

从仓库根目录执行安装操作。请勿使用

--global

参数。

标准单源安装命令：

bash

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-name> --agent '*' --yes

若要从同一源安装多个技能，可在

--skill

参数后重复添加技能名称作为独立参数：

bash

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-a> <skill-b> --agent '*' --yes

若要安装某一源下的所有技能，建议使用显式的全Agent安装命令：

bash

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill '*' --agent '*' --yes

当需要确保可复现性时，请使用固定版本的源：

bash

npm_config_ignore_scripts=true npx --yes skills@latest add owner/repo#<git-ref> --skill <skill-name> --agent '*' --yes

Patina Sources

Patina源

For Patina Project marketplace skills, use

patinaproject/skills

as the source and install only the requested skills unless the user explicitly asks for all.

Active Patina scaffold defaults are:

```
scaffold-repository
```
```
using-github
```
```
new-branch
```
```
develop-issue
```
```
finish-pr
```
```
review-code
```
```
install-skills
```

对于Patina Project市场中的技能，请使用

patinaproject/skills

作为源，且仅安装请求的技能，除非用户明确要求安装全部。

当前Patina脚手架默认包含以下技能：

```
scaffold-repository
```
```
using-github
```
```
new-branch
```
```
develop-issue
```
```
finish-pr
```
```
review-code
```
```
install-skills
```

Verify

验证安装

After installing, prove what changed:

bash

npm_config_ignore_scripts=true npx --yes skills@latest list --json
git status --short

If the repository exposes wrapper scripts, also run:

bash

pnpm skills:list

Report the installed skills, the source used, and the changed lockfile or agent overlay paths. Stop before committing unless the user asked you to finish the branch.

安装完成后，验证变更内容：

bash

npm_config_ignore_scripts=true npx --yes skills@latest list --json
git status --short

如果仓库提供了封装脚本，还需运行：

bash

pnpm skills:list

报告已安装的技能、使用的源，以及变更的锁定文件或Agent覆盖路径。除非用户要求完成分支操作，否则请勿提交变更。