Agent Skills 怎么用?Claude Code / Codex 安装目录、触发方式实操(已交给 Linux 基金会 AAIF)

10 月 22 日 Agent Skills 交给 Linux 基金会旗下 AAIF,一个 skill 可在多家客户端通用。本文给出 Claude Code Skill 与 Codex Skill 的安装目录、触发方式,同一个 SKILL.md 两边实测结果,以及装第三方 skill 前要检查什么。

9 分钟阅读
Agent Skills 怎么用?Claude Code / Codex 安装目录、触发方式实操(已交给 Linux 基金会 AAIF)

10-22 新闻:Agent Skills 交给了 Linux 基金会旗下的 AAIF

2026 年 10 月 22 日,Anthropic 宣布把 Agent Skills 标准捐给 Linux 基金会旗下的 Agentic AI Foundation(AAIF),也就是此前接收 MCP 的那个基金会。

Anthropic 原文:「More than 70 agent platforms, including ChatGPT, Cursor, GitHub Copilot, and VS Code, have integrated Agent Skills since we published the standard in December 2025.」「So far, 1 million skills have been published and nearly 280 million installed.」出处:Anthropic:Donating Agent Skills to the Agentic AI Foundation。

这次转交的东西和接下来的计划,原文都写得很具体:

  • 转交内容:「the Agent Skills name and logo, the GitHub organization, and the agentskills.io domain」,也就是名字和 logo、GitHub 组织、agentskills.io 域名。
  • 不用加入 AAIF 也能继续用:「You can continue to use the standard or contribute to it without joining the AAIF.」
  • 路线图:「a roadmap covering versioned releases, a formal proposal process, and security guidance for people who write and install skills」,即版本化发布、正式提案流程,以及给写 skill 和装 skill 的人的安全指南。

同一天 AAIF 还宣布了另外 3 个新项目:OpenAI 的 Open Responses、Hugging Face 的 OpenEnv、阿里巴巴的 OpenSandbox(Linux 基金会公告)。

对用户意味着什么

一句话:skill 不绑定某一家客户端。 你写好或装好的一个 skill 文件夹,换到另一个支持 Agent Skills 的工具里照样能用。标准交给中立基金会以后,后续怎么改由社区和多家公司一起定,不由某一家说了算。

Linux 基金会公告原文:Agent Skills 让「specialized know-how portable across agent products and platforms」。

下面这篇就讲怎么用:Skill 装在哪、怎么触发,以及同一个 skill 放进 Claude Code 和 Codex 的实测结果。想自己写一个 Skill,看《怎么写 SKILL.md:把重复工作流沉淀成自己的 Skill》。

Skill 是什么

Skill 就是一个装着 SKILL.md 的文件夹,里面写好「什么时候用、怎么做」,智能体遇到匹配的任务就自己读进来照着做。

Anthropic 原文:「A skill is a folder containing a SKILL.md file that teaches an agent a specific task or domain, along with any scripts or reference material it needs.」

平时智能体只看每个 Skill 的名字和描述,真正用到时才加载全文,所以装几个 Skill 不会把上下文塞满。

先把客户端接好

Skill 只是给智能体的说明书,干活的还是模型。先把客户端接到 AICodeWith,配置写在全局文件里,所有项目通用。

创建 API Key →

Claude Code:打开全局 ~/.claude/settings.json,在 env 里填上(ANTHROPIC_BASE_URL 不带 /v1):

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

Codex:打开全局 ~/.codex/config.toml,写入:

toml
model_provider = "aicodewith"
model = "gpt-6.1-sol"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "sk-你的Key"
改完重开终端,能正常对话就说明接通了。Claude Code 的字段说明见《Claude Code 如何接入第三方 API》,Codex 见《Codex config.toml 配置指南》。

Skill 装在哪个目录

装 Skill 就是把 Skill 文件夹放进对应目录。每个 Skill 一个文件夹,文件夹里必须有 SKILL.md:

text
~/.claude/skills/
└── summarize-changes/
    ├── SKILL.md
    └── scripts/      (可选,放脚本)

各工具读取的位置:

工具个人(所有项目可用)项目(提交到仓库,团队共享)
Claude Code~/.claude/skills/<名字>/SKILL.md.claude/skills/<名字>/SKILL.md
Codex~/.agents/skills/<名字>/SKILL.md.agents/skills/<名字>/SKILL.md
Cursor~/.cursor/skills/ 或 ~/.agents/skills/.cursor/skills/ 或 .agents/skills/
Claude Code 官方文档原文:Personal 位置是「~/.claude/skills/<skill-name>/SKILL.md」,适用于「All your projects on this machine」。出处:Claude Code Docs:Skills。
Codex 官方文档原文:USER 位置是「$HOME/.agents/skills」;仓库里「Codex scans .agents/skills in every directory from your current working directory up to the repository root」。出处:OpenAI:Build skills。

几点要知道:

  • 同名 Skill 在 Claude Code 里,个人目录优先于项目目录
  • Codex 会从当前目录一路往上找 .agents/skills,直到仓库根目录
  • Cursor 兼容读取 ~/.claude/skills/ 和 ~/.codex/skills/,所以给 Claude Code 装的 Skill,Cursor 里也能直接用
  • Claude Code 和 Codex 都会自动发现新装的 Skill;Codex 没刷出来就重启一下
只想一份 Skill 多个工具共用,可以放在一个地方,再用软链接(symlink)挂到其他工具的目录。Claude Code、Codex 官方文档都写明支持软链接的 Skill 文件夹。

两种装法:插件市场和直接解压

方式一:从插件市场装(Claude Code)。Anthropic 官方的文档类 Skill(xlsx、docx、pptx、pdf)就是这么装的,在终端运行:

bash
claude plugin marketplace add anthropics/skills
claude plugin install document-skills@anthropic-agent-skills

方式二:下载解压到 Skill 目录。拿到一个 Skill 压缩包,解压到 ~/.claude/skills/<名字>/,看到里面有 SKILL.md 就算装好。

Codex 里可以用自带的安装器,比如安装 Linear 的 Skill:

text
$skill-installer linear

怎么触发 Skill

自动触发:直接说需求。智能体会拿你的话去对比每个 Skill 的 description,对得上就自动加载。比如装了 xlsx Skill 后说"帮我把这张 Excel 清洗一下",它就会用上。

手动调用:

  • Claude Code:输入 /Skill名字,比如 /summarize-changes;后面可以带参数
  • Codex:输入 $ 选 Skill,或者运行 /skills 查看和选择
  • Cursor:在 Agent 对话里输入 / 搜索 Skill 名字
不想让智能体自己乱用某个 Skill(比如部署、发消息这类有副作用的),Claude Code 和 Cursor 在 SKILL.md 头部加 disable-model-invocation: true,之后只能手动调用。Codex 用 Skill 目录下的 agents/openai.yaml,设置 policy.allow_implicit_invocation: false。

查看已经装了哪些:Claude Code 里可以直接问"What skills are available?",或运行 /skills;Cursor 在侧边栏 Customize → Skills 里看。

实测:同一个 skill 放进 Claude Code 和 Codex

为了确认「一个 skill 两边通用」,我们写了一个最小 skill:release-note-stamp。它的 description 写的是「写发版说明(release note、更新日志、changelog)时使用」,正文要求第一行固定输出一个标记 【RN-STAMP-7Q】。只要回复里出现这个标记,就说明 skill 真的被加载了。

SKILL.md 全文:

markdown
---
name: release-note-stamp
description: 写发版说明(release note、更新日志、changelog)时使用。把用户描述的改动整理成固定格式的中文发版说明。
---

按下面格式输出发版说明,不要输出别的内容:

第一行固定写:【RN-STAMP-7Q】
第二行写:版本类型:修复 / 新功能 / 优化(三选一)
第三行写:一句话说明改动,不超过 30 个字

把同一个文件夹分别复制到两个目录:

bash
cp -r release-note-stamp ~/.claude/skills/
cp -r release-note-stamp ~/.agents/skills/

然后两边都用同一句话,不点名 skill、不加斜杠命令:

text
帮我给这次改动写一条发版说明:修复了登录页按钮错位。

测试环境:Claude Code 2.1.308、Codex CLI 0.162.1,都按上面的全局配置接 AI Code With,各用一个干净的独立 HOME。

Claude Code(claude -p)Codex(codex exec)
是否识别 skill识别识别
是否自动触发自动触发,没用斜杠命令自动触发,没用 $
怎么加载的调用内置的 Skill 工具,参数是 release-note-stamp先用 shell 读了 ~/.agents/skills/release-note-stamp/SKILL.md
输出是否按格式是是
耗时5.4 秒6.6 秒

两边的最终输出完全一样:

text
【RN-STAMP-7Q】
版本类型:修复
修复登录页按钮错位问题

Claude Code 的运行记录里,工具调用是这样的(截取):

json
{"name":"Skill","input":{"skill":"release-note-stamp","args":"修复了登录页按钮错位"}}

Codex 的运行记录里,先说了一句再读文件(截取,路径换成了 ~):

text
我先读取发版说明格式要求,再按项目约定整理成一条中文说明。
exec
/bin/bash -lc "sed -n '1,240p' ~/.agents/skills/release-note-stamp/SKILL.md"

再用一句和发版无关的话「1+1 等于几?只回答数字。」做对照,两边都只回答了 2,没有输出标记,说明不会乱触发。Claude Code 用时 2.5 秒,Codex 8.1 秒。

两边加载 skill 的方式不一样:Claude Code 走专门的 Skill 工具,Codex 是像读普通文件一样用 shell 读 SKILL.md。所以在 Codex 里,如果沙箱或权限设置不允许读这个目录,skill 就用不上;在 Claude Code 里看运行记录有没有 Skill 工具调用,就能确认有没有用上。
这次的 skill 很小,只有一个 SKILL.md,两边都能直接自动触发。我们在《Claude Code / Codex 用 Godot 做游戏》里测过一个带路由的大型技能包,那次 Claude Code 要先用 /router 才会加载,Codex 能自动加载。所以 skill 越复杂,越要在自己用的客户端里实测一次触发。

实战案例一:xlsx Skill 清洗乱表格

装好 document-skills 后,在表格所在目录启动 claude,一句话说清要求:保留原始数据、新建清洗后的 sheet、汇总用真实的 SUMIFS 公式。Claude Code 会自动用上 xlsx Skill,我们实测一张故意弄乱的销售表 61.5 秒完成,汇总全是能自动重算的 Excel 公式。

完整提示词和结果见《AI 处理 Excel:一句话清洗乱表格,自动生成 SUMIFS 汇总公式》。

实战案例二:invoice-organizer 整理发票

这个 Skill 用的是第二种装法:从 SkillHub 下载压缩包,解压到 ~/.claude/skills/invoice-organize/。之后对 Claude Code 说"用 invoice-organizer 整理这个文件夹的发票",它会把 XML 电子发票整理成 Excel 台账,顺带查重和校验金额。我们用 6 张发票实测 63 秒完成,揪出了一对重复发票和一张金额多算 0.50 元的发票。

详细步骤见《Claude Code 发票 Skill 实测:用 invoice-organizer 自动整理发票》。

装第三方 skill 前要检查什么

skill 不只是一段说明,里面可以带脚本,智能体会照着执行。装别人的 skill 之前,至少看这几件事:

  1. 看 scripts/ 里写了什么。 把每个脚本打开读一遍,看不懂的不要装。
  2. 找联网和删文件的命令。 在 skill 文件夹里搜一下 curl、wget、rm -rf、ssh、nc 这类命令,以及往陌生地址发数据的代码。
  3. 看 SKILL.md 有没有让智能体做额外的事。 比如读取 ~/.ssh、环境变量、密钥文件,或者「顺便」执行别的命令。
  4. 看来源。 优先用官方仓库或你认识的作者发布的 skill,看提交记录和 star 历史,来路不明的压缩包不要直接解压进 skill 目录。

可以先用这条命令粗筛一遍(把路径换成你下载的 skill 文件夹):

bash
grep -rnE "curl|wget|rm -rf|ssh |nc |base64|\.ssh|API_KEY|TOKEN" ./some-skill/

有命中不代表一定有问题,但每一处都要看懂它在做什么。

这不是假设的风险。据报道,JFrog 的《2026 软件供应链安全报告》追踪到 969 个携带高危载荷的恶意 AI agent skill(WebProNews;JFrog 新闻稿原文是「identifying 969 carrying high-impact payloads」,JFrog)。

AAIF 的路线图里也专门列了「security guidance for people who write and install skills」,后续有正式的安全指南发布,可以关注 agentskills.io。

Codex 里运行 skill 带的命令时,网络和文件权限受沙箱控制,见《Codex 联网与执行安全》。

常见问题

Skill 和 CLAUDE.md 有什么区别?

CLAUDE.md 每次对话都会整份加载,适合放"事实",比如项目用什么框架。Skill 平时只加载名字和描述,用到才读全文,适合放"流程",比如发布步骤、检查清单。

装了 Skill 但它不触发怎么办?

先确认 Skill 能被看到(Claude Code 问"What skills are available?",Codex 运行 /skills)。看得到但不自动触发,多半是 description 没写到你常说的词,可以先手动调用,再去改描述。描述怎么写见《怎么写 SKILL.md》。

同一个 Skill 能同时给 Claude Code 和 Codex 用吗?

能。两边都遵循 Agent Skills 标准,SKILL.md 只写 name 和 description 等标准字段,就能通用。放进各自的目录,或用软链接共用一份。

Codex 里怎么临时关掉一个 Skill?

在 ~/.codex/config.toml 里加一段,然后重启 Codex:

toml
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Skill 装多了会拖慢速度吗?

每个 Skill 的名字和描述会一直在上下文里。Claude Code 可以运行 /skill-doctor 看每个 Skill 占多少上下文、用得多不多,把不用的关掉。

Agent Skills 交给 AAIF 以后,原来的 skill 还能用吗?

能。Anthropic 原文写明「You can continue to use the standard or contribute to it without joining the AAIF.」,SKILL.md 的写法没有因为这次转交而改变。

Claude Code 和 Codex 的 skill 目录一样吗?

不一样。Claude Code 个人目录是 ~/.claude/skills/,Codex 是 ~/.agents/skills/。同一个 skill 文件夹放进两边各自的目录(或用软链接)就能共用,我们实测两边都能自动触发。

更多 Codex 专属细节,可以看《Codex Skills 怎么用?从 SKILL.md 到触发验证》。

相关阅读

资料来源