要彻底清除codex中某个skill,必须精准定位其物理路径(用户级~/.codex/skills、项目级./.codex/skills或共享目录如~/.agents/skills),直接删除文件夹或重命名为xxx.disabled停用,并清除~/.codex/node_modules和.cache缓存后重启codex。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想彻底清除 Codex 中某个已安装的 Skill,避免它继续被加载、触发或引发冲突,必须精准定位其物理存放位置并执行删除操作,不能只靠界面点击或命令行“卸载”就以为完成。
先确认 Skill 的真实安装路径
Codex 不会把所有 Skill 统一放在一个地方。它可能存在于:【~/.codex/skills】(用户级)、【项目根目录/.codex/skills】(本地级),或通过软链接指向 【~/.agents/skills】 等共享目录。不先搞清路径,删错位置会导致 Skill 仍在生效,或误删其他工具的技能。
打开终端,执行:
Windows PowerShell:Get-ChildItem $env:USERPROFILE\.codex\skills
macOS/Linux:ls ~/.codex/skills
若该目录为空或不存在,说明当前 Codex 并未在用户级安装任何 Skill——它很可能走的是项目级或共享目录路径,需切换到对应项目文件夹再查 .codex/skills,或检查 ~/.agents/skills 是否被 symlink 引用。
方法一:直接删除物理文件夹(适用于明确无用的 Skill)
第一步:进入目标 Skill 所在目录
例如,你要删的 Skill 名叫 git-helper,且它位于 ~/.codex/skills/git-helper,则执行:
Windows:cd %USERPROFILE%\.codex\skills
macOS/Linux:cd ~/.codex/skills
第二步:执行删除命令
Windows(PowerShell):rmdir /s /q git-helper
macOS/Linux:rm -rf git-helper
【注意:此操作不可逆,删除前请确认该 Skill 未被其他项目或脚本硬编码调用】
方法二:停用而非删除(推荐用于不确定是否依赖的 Skill)
方法二的操作本质是重命名,让 Codex 启动时自动跳过该目录:
将 git-helper 文件夹重命名为 git-helper.disabled。
这一步操作起来很简单,直接在文件资源管理器或终端里改名就行,不需要重启 Codex,下次启动即生效。
后续若需恢复,只需把 .disabled 后缀去掉,名称还原为 git-helper 即可。
同步清理运行时缓存(关键收尾动作)
Codex 在首次加载 Skill 时会生成缓存文件,即使你删掉了源目录,这些缓存仍可能让旧逻辑残留运行。必须手动清除:
Windows:删除 %USERPROFILE%\.codex\node_modules 和 %USERPROFILE%\.codex\.cache
macOS/Linux:删除 ~/.codex/node_modules 和 ~/.codex/.cache
删完后,重启 Codex CLI 或桌面客户端,执行 codex list-skills(如有该命令)或观察启动日志,确认目标 Skill 不再出现在加载列表中。











