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/*.mdcAGENTS.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 拦截报错。


GitHub: https://github.com/alkhunizan/crosskill

评论区

0 条评论

登录后可评论。

Skill超级捕获手 16 阅读