Codex技能配置需将含SKILL.md的合规文件夹放入~/.codex/skills/路径并刷新:SKILL.md须含name和description字段,文件夹名仅限英文小写字母与短横线;路径不存在需手动创建;缓存未清会导致技能不显示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Mac上为Codex配置Skill,核心是把合法Skill包放进正确路径并触发识别,不是靠点击安装按钮或联网下载——路径错、文件结构缺、缓存未清,技能就永远不显示。
确认Skill包是否合规
打开你拿到的Skill压缩包,解压后检查根目录下【必须存在SKILL.md文件】,且该文件不能是空的,至少包含name和description字段。如果只有.py或.js文件,没有SKILL.md,Codex会直接忽略整个文件夹。
再检查文件夹名:不能含空格、中文、特殊符号(如$、#、括号),推荐用纯英文小写字母+短横线,例如test-case-generator。
找到Mac上的skills目录
打开终端,执行以下命令直接进入目标路径:
cd ~/.codex/skills
如果提示“No such file or directory”,说明目录还没创建,手动建一个:
mkdir -p ~/.codex/skills
这一步不能跳过。Codex不会自动创建skills文件夹,也不会在首次启动时帮你生成默认结构。
放入Skill文件夹
把解压好的完整Skill文件夹(比如test-case-generator),拖进刚刚打开的~/.codex/skills/目录里。
注意:不是把.zip包放进去,也不是只放SKILL.md,而是整个带SKILL.md的文件夹原样复制过去。
完成后,终端执行ls ~/.codex/skills查看,应能看到你的文件夹名,且里面包含SKILL.md。
刷新并验证Skill是否生效
方法一:打开Codex App → 点击左侧边栏「Skills」→ 右上角点击「刷新」图标(两个循环箭头)。
方法二:在任意对话框中输入 $skill list,回车。如果看到你的Skill名字出现在列表中,说明已加载成功。
若仍不显示,执行以下命令清除缓存再试:
rm -rf ~/.codex/cache && rm -rf ~/.codex/webviewCache


















