skill-installer

技能安装器

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

根据任务使用相应的辅助脚本：

• 用户询问有哪些技能可用，或使用此技能但未指定要做什么时，列出技能。默认列出 .curated 中的技能；如果用户询问实验性技能，可以传入 --path skills/.experimental。
• 用户提供技能名称时，从精选列表中安装。
• 用户提供 GitHub 仓库/路径（包括私有仓库）时，从其他仓库安装。

使用辅助脚本安装技能。

沟通

列出技能时，根据用户请求的上下文，大致按以下格式输出。如果用户询问实验性技能，则改为列出 .experimental 中的技能，并相应标注来源： """ 来自 {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 稀疏检出。
• 如果目标技能目录已存在，则中止。
• 安装到 $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 获取。如果无法获取，请说明错误并退出。
• 可以通过现有 git 凭据，或用于下载的可选 GITHUB_TOKEN/GH_TOKEN 访问私有 GitHub 仓库。
• Git 回退会先尝试 HTTPS，再尝试 SSH。
• https://github.com/openai/skills/tree/main/skills/.system 中的技能已预装，无需帮助用户安装。如果用户询问，只需说明这一点。如果用户坚持，可以下载并覆盖。
• 已安装标注来自 $CODEX_HOME/skills。