技能安装器
帮助安装技能。默认情况下,这些技能来自 https://github.com/openai/skills/tree/main/skills/.curated,但用户也可以提供其他位置。实验性技能位于 https://github.com/openai/skills/tree/main/skills/.experimental,可以通过相同方式安装。
根据任务使用辅助脚本:
- 当用户询问可用的技能,或使用此技能而未指定具体操作时,列出技能。默认列表为
.curated,但用户询问实验性技能时可以传递--path skills/.experimental。 - 当用户提供技能名称时,从精选列表中安装。
- 当用户提供 GitHub 仓库/路径(包括私有仓库)时,从该仓库安装。
使用辅助脚本安装技能。
沟通
列出技能时,根据用户请求的上下文,大致输出如下内容。如果用户询问实验性技能,则从 .experimental 而不是 .curated 列出,并相应标注来源:
来自 {repo} 的技能:
1. skill-1
2. skill-2(已安装)
3. ...
您想安装哪些?
安装技能后,告知用户该技能将在下一次对话回合中可用。
脚本
所有这些脚本都需要网络连接,因此在沙箱中运行时,在执行前请求提升权限。
scripts/list-skills.py(打印技能列表,包含已安装标注)scripts/list-skills.py --format json- 示例(实验性列表):
scripts/list-skills.py --path skills/.experimental scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>- 示例(实验性技能):
scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>
行为与选项
- 默认对于公共 GitHub 仓库采用直接下载。
- 如果下载因认证/权限错误而失败,则回退到 Git sparse checkout。
- 如果目标技能目录已存在,则中止操作。
- 安装到
$CODEX_HOME/skills/<skill-name>(默认为~/.codex/skills)。 - 多个
--path值可以一次安装多个技能,除非提供--name,否则每个技能以路径的基本名称命名。 - 选项:
--ref <ref>(默认main),--dest <path>,--method auto|download|git。
注意事项
- 精选列表通过 GitHub API 从
https://github.com/openai/skills/tree/main/skills/.curated获取。如果无法获取,解释错误并退出。 - 私有 GitHub 仓库可通过现有的 Git 凭证或可选的
GITHUB_TOKEN/GH_TOKEN(用于下载)访问。 - Git 回退首先尝试 HTTPS,然后尝试 SSH。
- 位于 https://github.com/openai/skills/tree/main/skills/.system 的技能是预安装的,因此无需帮助用户安装这些技能。如果用户询问,只需解释这一点。如果用户坚持,可以下载并覆盖。
- 已安装标注来自
$CODEX_HOME/skills。