用途:Skill Installer 帮助把 Codex 技能安装到 $CODEX_HOME/skills。默认来源为 https://github.com/openai/skills/tree/main/skills/.curated,用户也可提供其它位置;实验性技能位于 https://github.com/openai/skills/tree/main/skills/.experimental,可按同样方式安装。位于 skills/.system 的技能已预装,无需安装。
主要能力:按任务使用辅助脚本。列出技能:当用户询问有哪些可用技能,或未指定操作时使用;默认列出 .curated,询问实验性技能时可传 --path skills/.experimental。按名称从精选列表安装。当用户提供 GitHub 仓库/路径(含私有仓库)时从其它仓库安装。脚本包括 scripts/list-skills.py(打印带已安装标注的技能列表,支持 --format json)和 scripts/install-skill-from-github.py(支持 --repo <owner>/<repo> --path <path/to/skill> 或 --url 形式)。脚本需联网,沙箱运行时需请求提权。
行为与选项:默认对公开 GitHub 仓库直接下载;若因鉴权/权限错误失败,回退到 git 稀疏检出。目标技能目录已存在时中止。安装到 $CODEX_HOME/skills/<skill-name>(默认 ~/.codex/skills)。多个 --path 可一次安装多个技能,名称取自路径 basename,除非提供 --name。选项:--ref <ref>(默认 main)、--dest <path>、--method auto|download|git。
限制与说明:精选列表通过 GitHub API 获取,若不可用会报错退出。私有仓库可通过现有 git 凭据或可选的 GITHUB_TOKEN/GH_TOKEN 访问。git 回退先试 HTTPS 再试 SSH。已安装标注来自 $CODEX_HOME/skills。安装完成后应告知用户技能将在下一轮可用。