crosskill Skill:一次编写编译到8大AI编码工具的技能同步神器
如果你同时用 Claude Code、Cursor、Codex、Windsurf 和 Aider,你大概率已经掉进了技能文件的地狱——每个工具的规则文件格式不同、路径不同,却要做同一件事,结果是 copy-paste 四散,一改全忘。
crosskill 要终结这个局面:写一次 SKILL.md,自动编译到 8 个主流 AI 编码工具,让技能库真正成为可移植的资产,而不是维护噩梦。
功能与设计原则
crosskill 是一个技能编译工具,核心理念是「一次编写,随处运行」。它不替代 SKILL.md 格式,而是建立在这套格式之上的编译层:用户编写 .skill.md 源文件,crosskill 将其编译成各目标平台所需的格式(.claude/skills/*.md、.cursor/rules/*.mdc、AGENTS.md、.windsurf/rules.md、.aider.conf.yml 等),同时内置 drift-gate,确保已编译的文件永远与源文件保持同步。
设计原则:
– 零锁定:输出的是标准 SKILL.md 格式,不引入任何专有语法
– 可验证:内置 crosskill check 命令,CI 和 pre-commit 钩子可在任何漂移发生时报错
– 开发者优先:无账户、无密钥、无 Docker,npm 安装即用
认可度
crosskill 目前处于早期传播阶段(GitHub 仓库 2026 年 8 月创建),在社交媒体上主要通过开发者社区口碑传播。Web Playground(crosskill.dev)提供了免安装的在线体验,降低了试用门槛。随着多工具并用成为资深 AI 编程用户的常态,这类工具的需求正在快速增长。
链接
GitHub:https://github.com/alkhunizan/crosskill
原作者
alkhunizan(GitHub),项目以 MIT 许可证开源,提供 CLI 和桌面应用两种使用方式。
详细介绍
AI 编码工具的生态正在快速分化。Claude Code、Cursor、Codex(AGENTS.md)、Windsurf、Aider、OpenCode、Gemini CLI、Copilot、Continue——每个工具都用自己定义的规则/技能文件格式来扩展默认行为。问题是:同一套最佳实践(比如 code-review 清单或 git-commit 规范),要分别在 8 个地方维护 8 份副本,改一处漏七处,是常态。
crosskill 的解法是引入一个中间层 .skill.md 源文件格式,在其中用标准化的指令描述技能的编译规则,然后通过 crosskill build 一次性生成所有目标格式的输出。每个输出文件都标注 GENERATED 声明,任何人手动编辑都会被 crosskill check 在 CI/pre-commit 阶段拦截,从而把「多工具同步」从靠自觉变成靠机制保证。
支持的目标平台(8 个):
– Claude Code(.claude/skills/)
– Cursor(.cursor/rules/)
– Codex(AGENTS.md)
– Windsurf(.windsurf/rules.md)
– Aider(.aider.conf.yml)
– OpenCode(.opencode/skills/)
– Gemini CLI
– Copilot / Continue
核心特点
- 零门槛 Web 体验:访问 crosskill.dev,在线粘贴技能源码,立即查看所有平台的编译输出,无需安装
- 一键初始化:
npx crosskill init在当前仓库搭建目录结构,零配置 - 编译 + drift-gate 二合一:
crosskill build生成所有目标文件;crosskill check验证是否漂移,CI 友好 - 快照测试:
crosskill test(带-u更新快照)记录当前输出,防止未来意外变更 - 原生桌面应用:Tauri 2 构建的 crosskill.app 提供键盘驱动的编辑器 + Watch 模式(文件变更自动重编译)
- 安全默认:pre-commit 钩子自动安装,运行 drift-gate 和敏感信息扫描
使用方法
安装(CLI):
npx crosskill init # 在仓库初始化 crosskill 目录结构
# 编辑 ./crosskill/code-reviewer.skill.md
npx crosskill build # 编译到所有目标平台
npx crosskill lint # 语法检查
npx crosskill check # drift-gate:报告任何漂移
桌面应用(跨平台):
# 下载 crosskill.app(Windows/macOS/Linux)
# 打开应用 → 选择工作目录 → 编辑 .skill.md 文件
# 开启 Watch 模式:文件保存即自动重编译
适用场景与目标用户
适用场景:
– 团队在多个 AI 编程工具间切换,需要统一技能标准
– 个人有多设备/多工具环境,希望技能库同步一致
– 维护一个对外共享的技能库,希望一次发布覆盖所有主流平台
目标用户:
– AI 编程工具的重度用户(同时使用 2 个以上编码 Agent)
– 团队技术负责人,需要在多人之间统一代码规范和审核流程
– 技能开发者,目标是让一套技能资产覆盖最多的终端用户
输入与输出案例
输入(.skill.md 源文件):
# code-reviewer.skill.md
name: Code Reviewer
description: Perform a structured code review before approving changes.
## Process
1. Read the diff carefully
2. Check for security issues
3. Verify test coverage
4. Approve or request changes
输出(crosskill build 后的多个文件):
– .claude/skills/code-reviewer.md — Claude Code 格式
– .cursor/rules/code-review.mdc — Cursor 格式
– AGENTS.md — Codex 格式
– .windsurf/rules.md — Windsurf 格式
所有文件自动生成,内容一致,任何手动编辑都会被 crosskill check 拦截报错。
评论区
登录后可评论。