快速答案
最快答案
在 Codex 对话框输入
$skill-installer,告诉它要安装的 Skill 名称或仓库地址;安装完成后如果没有出现,重启 Codex 再检查 Skills 列表。
大多数人只需要第一种
内置安装器适合新手和精选 Skill,操作最简单。
仓库安装已有 GitHub 地址时,让安装器从仓库获取。
手动放入目录适合自己开发或已经拿到完整 Skill 文件夹。
让 Skill Installer 自动安装
步骤 1
新建一个 Codex 对话
在输入框中键入 $,查看是否能找到 skill-installer。
步骤 2
说清楚要安装什么
可以提供精选 Skill 名称,也可以直接给出可信仓库的地址。
步骤 3
确认安装结果
等待 Codex 完成安装,再从侧边栏的 Skills 或输入框的 Skill 列表中检查。
可直接复制:请使用 $skill-installer 帮我安装「Skill 名称」。安装完成后,告诉我安装位置、调用名称,以及是否需要重启 Codex。
从可信仓库安装 Skill
把仓库地址和目标 Skill 的路径一起交给安装器,不必自己猜应该复制哪些文件。
示例:请使用 $skill-installer 从这个仓库安装 Skill:这里粘贴仓库地址。安装前先检查 SKILL.md 和 scripts 中是否存在高风险操作,确认后再安装。
注意
安全提醒:Skill 可能包含脚本、工具调用和权限要求。来源不明时,先检查
SKILL.md、scripts/及它会访问的数据,不要直接运行陌生脚本。
把完整 Skill 文件夹放到正确位置
一个 Skill 至少应包含 SKILL.md。个人 Skill 通常放到用户目录,项目专用 Skill 则放进项目目录。
个人 Skill~/.agents/skills/技能名/
当前项目项目/.agents/skills/技能名/
必需文件技能名/SKILL.md
提示
项目 Skill 适合跟随项目一起使用;个人 Skill 适合在多个项目中复用。不要只复制一个零散的说明文件,要保留 Skill 的完整目录结构。
Skill 没有显示怎么办?
- 先重启 Codex,让它重新发现刚安装的 Skill。
- 确认文件夹内存在名为
SKILL.md的主说明文件。 - 检查是不是多套了一层目录,例如
技能名/技能名/SKILL.md。 - 项目 Skill 要在对应项目中打开,换到别的项目可能不会出现。
安装前后最容易混淆的地方
安装 Skill 后会自动运行吗?
不会无条件自动运行。Codex 会根据 Skill 描述和你的任务决定是否调用,你也可以在提示词中用 $skill-name 明确指定。
所有 Skill 都要装到全局目录吗?
不需要。只服务某个项目的 Skill 更适合放进该项目的 .agents/skills,方便团队和项目一起维护。
安装后找不到,是不是安装失败?
不一定。先重启 Codex,并确认目录和 SKILL.md 文件名正确,再判断是否需要重新安装。