用途:将 Claude Code 技能转换为可在 OpenAI Codex、Google Gemini CLI、Google Antigravity 和 Cursor 上使用的版本,同时尽量保持质量并遵循各平台最佳实践。
主要能力:读取源 SKILL.md 并解析 frontmatter,识别技能复杂度层级(1-4),清点 scripts/、references/、agents/、子技能等文件,识别 .mcp.json;分析平台兼容性,区分可直接迁移字段、需适配字段和仅 Claude 支持的字段;按目标平台生成转换结果;对生成结果做校验;输出转换报告;在 --target all 时自动生成 install-multiplatform.sh,可自动检测当前智能体平台并安装到正确技能路径,也支持 --platform 显式选择。
使用方式:先做干跑分析:python scripts/convert_skill.py <path> --dry-run --target all;再执行转换:python scripts/convert_skill.py <path> --target codex,gemini,antigravity,cursor --output dist/;如需转换 MCP 配置:python scripts/convert_skill.py <path> --target all --output dist/ --include-mcp;随后逐个校验:python scripts/validate_skill.py dist/codex/<skill-name>/ 等。
平台差异:allowed-tools 在 Codex 受支持,在 Gemini/Antigravity 和 Cursor 需移除;context: fork、model selection 在各目标平台均无对应;hooks 在 Codex 仅 1 个事件,Gemini 部分支持,Cursor 为 6 个事件(beta);Task delegation 在 Codex 和 Gemini/Antigravity 需拆分为独立技能,Cursor 可用 Background Agents(Ultra plan);/slash commands 在 Codex 用 $mention 语法,Gemini/Antigravity 和 Cursor 用基于描述的激活。
适用场景:需要把已有 Claude Code 技能复用到其他智能体平台,或需要批量生成多平台技能包与安装脚本时。
限制:Tier 3 多技能仅部分转换,路由需手动处理;Tier 4 生态级技能需人工审查,子智能体委派需按平台适配;Claude 独有特性需按平台手动调整。平台路径与配置文件:Claude Code 为 .claude/skills/、CLAUDE.md、JSON;Codex 为 .agents/skills/、AGENTS.md、TOML;Gemini CLI 为 .gemini/skills/、GEMINI.md、JSON;Antigravity 为 .agent/skills/、GEMINI.md、JSON;Cursor 为 .cursor/skills/、.cursor/rules/*.mdc、JSON。完整平台规范见 references/platforms.md。