技能安装器Skill skill-installer

---

名称: skill-installer 描述: 将Codex技能安装到$CODEX_HOME/skills中，可以从curated列表或GitHub仓库路径安装。当用户询问可安装技能列表、安装curated技能或从其他仓库（包括私有仓库）安装技能时使用。 元数据: 简短描述: 从openai/skills或其他仓库安装curated技能

技能安装器

帮助安装技能。默认情况下，这些来自 https://github.com/openai/skills/tree/main/skills/.curated，但用户也可以提供其他位置。实验性技能位于 https://github.com/openai/skills/tree/main/skills/.experimental，可以以相同方式安装。

根据任务使用辅助脚本：

• 当用户询问可用内容或用户使用此技能而未指定操作时，列出技能。默认列表是.curated，但当用户询问实验性技能时，可以传递--path skills/.experimental。
• 当用户提供技能名称时，从curated列表安装。
• 当用户提供GitHub仓库/路径（包括私有仓库）时，从其他仓库安装。

使用辅助脚本安装技能。

通信

当列出技能时，根据用户请求的上下文输出大约如下。如果用户询问实验性技能，从.experimental而不是.curated列出，并相应标记来源： “”" 来自{repo}的技能：

1. skill-1
2. skill-2 (已安装)
3. … 您想安装哪些？ “”"

安装技能后，告诉用户：“重启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 sparse checkout。
• 如果目标技能目录已存在，则中止。
• 安装到$CODEX_HOME/skills/<skill-name>（默认为~/.codex/skills）。
• 多个--path值在一次运行中安装多个技能，每个技能以路径基名命名，除非提供--name。
• 选项：--ref <ref>（默认main），--dest <path>，--method auto|download|git。

注释

• Curated列表通过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。