名称: skill-installer 描述: 从策划列表或GitHub仓库路径安装Codex技能到$CODEX_HOME/skills。当用户询问可安装技能列表、安装策划技能或从其他仓库(包括私有仓库)安装技能时使用。 元数据: 简短描述: 从openai/skills或其他仓库安装策划技能
技能安装器
帮助安装技能。默认情况下,这些技能来自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}的技能:
- skill-1
- skill-2 (已安装)
- … 您想安装哪些? “”"
安装技能后,告诉用户:“重启Codex以获取新技能。”
脚本
所有这些脚本都使用网络,因此在沙盒中运行时,运行时请求升级。
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稀疏检出。
- 如果目标技能目录已存在,则中止。
- 安装到
$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。