首页 / AI工具 / 如何让 Skill 同时跑在 Cursor、Codex 和 Claude Code 里?方法是什么?
AI工具

如何让 Skill 同时跑在 Cursor、Codex 和 Claude Code 里?方法是什么?

如何让 Skill 同时跑在 Cursor、Codex 和 Claude Code 里?方法是什么?

工具会变,经验别被工具锁住

AI 编程工具迭代很快,Cursor、Codex、Claude Code 各有优势。但你花时间写的 Skill 却容易被单个工具绑定。把经验固化成可复用的 Skill,而不是把它们锁在某一个编辑器里,才是长期有效的做法。

三个平台其实在靠近同一种东西

Cursor 的 Rules、Codex 的 Instructions、Claude Code 的 Skills,本质都是把重复性指令、检查清单、代码规范封装起来。它们正在向统一的方向靠近,Skill 文件结构也越来越相似。这意味着今天写好的内容,明天换工具也能继续使用。

一份可移植 Skill 应该长什么样

一个通用的 Skill 通常是单个文件夹,里面放 SKILL.md 文件。内容以纯文本指令和 checklist 为主,避免硬编码具体工具名称。目录结构建议统一放在 ~/skills-shared/,再通过软链接分发到不同工具。

Cursor 里不要只靠一条长规则

Cursor 支持 Rules,但把所有内容塞进一条长规则容易超出上下文限制。更好的方式是把不同场景拆成独立 Skill 文件,再通过 .cursorrules 引用需要的 Skill。这样既保持简洁,又能按需加载。

Codex 里把 .agents 当作一等入口

Codex 会扫描 ~/.codex/skills/ 和 .agents/skills/ 目录。把 Skill 放在这两个位置,Codex 能自动识别。建议优先使用 .agents/skills/,这样项目级 Skill 也能方便管理。

Claude Code 的 Skill 目录结构

Claude Code 默认读取 ~/.claude/skills/。同样支持软链接,因此可以把核心 Skill 统一存放在共享目录,再分别链接到三个工具的对应路径。

Skill 同时软链到多个目录

实际操作中可以用一条命令实现多端复用:

ln -s ~/skills-shared/commit-msg-zh ~/.claude/skills/commit-msg-zh
ln -s ~/skills-shared/commit-msg-zh ~/.codex/skills/commit-msg-zh
ln -s ~/skills-shared/commit-msg-zh ~/.cursor/rules/commit-msg-zh

90% 的纯指令型 Skill 都能直接复用,涉及具体工具调用的 Skill 则需要单独适配。

把 Skill 拆成两类更稳妥

纯指令型 Skill(代码规范、提交信息格式、审查 checklist)可以一次编写多处使用。带工具调用的 Skill(文件读取、子进程执行)建议为每个工具单独维护一份,避免触发名和路径差异导致失败。目前推荐的比例是 60% 纯指令型,40% 工具适配型。

用 MCP 进一步打通平台

SkillDeck 这类工具把本地 SKILL.md 扫描后,通过 MCP 协议暴露给不同 Agent。支持 compact、guided、active 三种模式,能让 Skill 在 Cursor、Codex、Claude Code 之间实现动态发现和按需加载,而不需要手动复制文件。

Skills CLI 安装与管理

开放生态的 Skill 可以通过 npx skills 命令安装:

npx skills find react performance
npx skills add owner/repo -s skill-name -g -y

加 -g 参数安装到全局目录,不加则安装到项目级 .agents/skills/。这样既能快速获取社区 Skill,也能统一管理本地 Skill。

把经验变成基础设施

Skill 的核心价值不是属于某个工具,而是把个人或团队的经验固化下来。一次编写、软链接分发、按需加载,让同一套工作流在 Cursor、Codex、Claude Code 中保持一致。这才是真正让 Skill 跑在多个平台上的实用方法。

分享到: 微博