SuperAPI AI 工具集

skill-installer

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:帮助用户把技能安装到 Codex 或 Claude Code。默认来源为 https://github.com/openai/skills/tree/main/skills/.curated,实验性技能位于 https://github.com/openai/skills/tree/main/skills/.experimental,也可由用户提供其他位置。

主要能力:列出可用技能(默认 .curated,可传 --path skills/.experimental 查看实验技能);按技能名从 curated 列表安装;从其他 GitHub 仓库或路径(含私有仓库)安装;一次运行可安装多个技能。

使用方式:先选择安装目标。Codex 使用脚本默认目标 $CODEX_HOME/skills 或 ~/.codex/skills,除非用户明确要求 Codex 系统刷新且当前工作流允许,否则不要覆盖 .system 技能。Claude Code 需传 --dest ~/.claude/skills;列出时传 --installed-root ~/.claude/skills 以反映 Claude 的安装根目录。共享目录仅在仓库维护策略授权导入时才写入规范父目录。

脚本:scripts/list-skills.py(打印技能列表并标注已安装),支持 --format json、--installed-root ~/.claude/skills、--path skills/.experimental;scripts/install-skill-from-github.py 支持 --repo <owner>/<repo> --path <path/to/skill> 或 --url https://github.com/<owner>/<repo>/tree/<ref>/<path>。选项包括 --ref(默认 main)、--dest、--method auto|download|git。脚本使用网络,沙箱中运行需申请提权。

行为:公开仓库默认直接下载,遇认证或权限错误回退到 git sparse checkout;目标技能目录已存在则中止;默认安装到 $CODEX_HOME/skills/<skill-name>;多个 --path 可一次安装多个技能,名称取路径 basename,除非提供 --name。私有仓库可用现有 git 凭据或 GITHUB_TOKEN/GH_TOKEN。.system 技能已预装,无需安装。

限制与注意:安装前应审查源技能的激活边界、脚本、凭据和宿主假设;把 Codex 专用技能装到 Claude 不会让 Codex 原生工具可用。curated 列表通过 GitHub API 获取,不可用时需说明错误并退出。本技能不要求 MCP,无 MCP 时依赖本地说明、捆绑资源、标准 shell 或编辑器工具及直接验证。不要声称使用了宿主未暴露的 MCP 操作。