Skill Installer 用于帮助用户安装 Codex 技能（skills）。默认安装来源为 https://github.com/openai/skills/tree/main/skills/.curated，用户也可以提供其他位置。实验性技能位于 https://github.com/openai/skills/tree/main/skills/.experimental，可用相同方式安装。
用途
该工具主要解决 Codex 技能的发现与安装问题：当用户询问有哪些可安装的技能、想安装某个精选技能，或想从某个 GitHub 仓库（含私有仓库）安装技能时使用。
主要能力
- 列出技能：当用户询问有哪些可用技能，或未指定具体操作时，列出可安装技能，并标注哪些已安装。默认列出 .curated 列表，可通过 --path skills/.experimental 列出实验性技能。
- 从精选列表安装：当用户提供技能名称时，从精选列表安装。
- 从其他仓库安装：当用户提供 GitHub 仓库或路径（包括私有仓库）时，从该位置安装。
- 支持一次安装多个技能：多个 --path 值可在一次运行中安装多个技能，每个技能默认以路径的 basename 命名，除非提供 --name。
使用方式
根据任务使用相应的辅助脚本：
- scripts/list-skills.py：打印技能列表并标注已安装项。
- scripts/list-skills.py --format json：以 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）。
- 选项：--ref <ref>（默认 main）、--dest <path>、--method auto|download|git。
沟通方式
列出技能时，根据用户请求的上下文，大致按以下格式输出。如果用户询问实验性技能，则从 .experimental 而非 .curated 列出，并相应标注来源：
""" Skills from {repo}:
skill-1
skill-2 (already installed)
... Which ones would you like installed? """
安装技能后，告知用户："Restart Codex to pick up new skills."
注意事项
- 精选列表通过 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。