mcpField
S
skill-forge-convert

skill-forge-convert

github.com/agricidanielAgent 工作流18639 次安装29 周前更新
代码仓库

关于 skill-forge-convert

skill-forge-convert 是用于将 Claude Code Skill 转换为多个平台格式的 Skill，面向需要跨平台部署 Skill 的开发者。它提供兼容性分析、转换、校验和部署报告，并可处理 MCP 配置。

主要功能

  1. 01分析 Skill 复杂度与平台兼容性
  2. 02转换为 Codex、Gemini、Antigravity 和 Cursor
  3. 03支持转换 MCP 配置
  4. 04校验各平台生成结果
  5. 05生成多平台安装脚本

适用场景

  1. 01将 Claude Code Skill 移植到其他平台
  2. 02检查转换前的平台兼容性
  3. 03转换并校验 MCP 配置

MCP 相关

可在转换时纳入 MCP 配置，并将其适配到目标平台的配置格式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agricidaniel/skill-forge --skill skill-forge-convert

安装后在 Claude Code 中输入/skill-forge-convert确认已加载。

详细介绍

技能转换 — 多平台

将 Claude Code 技能转换为可在 OpenAI Codex、Google Gemini CLI、Google Antigravity 和 Cursor 上运行的版本，同时保持质量并遵循各平台的最佳实践。

流程

步骤 1：读取源技能
  1. 读取源 SKILL.md 并解析前置元数据
  2. 检测技能复杂度级别（1-4）
  3. 列出所有文件：scripts/、references/、agents/、子技能
  4. 检查是否存在 MCP 配置（.mcp.json）
步骤 2：分析平台兼容性

先运行试运行分析：

python scripts/convert_skill.py <path> --dry-run --target all

查看兼容性报告：

  • 可移植字段：直接迁移（名称、描述、许可证）
  • 可适配字段：需要针对平台进行处理
  • 仅 Claude 支持的字段：将移除并发出警告
步骤 3：转换为目标平台

运行转换：

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
步骤 4：处理仅 Claude 支持的功能

以下功能需要针对各平台手动适配：

Claude 功能CodexGemini/AntigravityCursor
allowed-tools支持移除；所有工具均可用移除；没有对应功能
context: fork没有对应功能没有对应功能没有对应功能
hooks1 个事件（通知）部分支持（CLI）6 个事件（测试版）
model 选择没有对应功能没有对应功能没有对应功能
Task 委派拆分为独立技能拆分为独立技能后台 Agent（Ultra 计划）
/slash 命令$mention 语法基于描述的激活基于描述的激活 + @rule
子技能路由使用 $mention 拆分为独立技能拆分为独立技能，由大模型路由拆分为独立技能，由大模型路由
步骤 5：验证转换后的技能

对每个生成的输出运行验证：

python scripts/validate_skill.py dist/codex/<skill-name>/
python scripts/validate_skill.py dist/gemini/<skill-name>/
python scripts/validate_skill.py dist/antigravity/<skill-name>/
python scripts/validate_skill.py dist/cursor/<skill-name>/

继续之前，修复所有严重或高优先级问题。

步骤 6：生成部署报告

向用户提供摘要：

## Conversion Report: {skill-name}

| Platform | Score | Files | Warnings | Manual Steps |
|----------|-------|-------|----------|-------------|
| Codex | 92% | 4 | 2 | 1 |
| Gemini | 88% | 3 | 3 | 1 |
| Antigravity | 88% | 3 | 3 | 1 |
| Cursor | 88% | 3 | 3 | 1 |

### Generated Files
[list per platform]

### Warnings
[list per platform]

### Manual Steps Required
[list per platform]
步骤 7：生成多平台安装脚本

转换所有平台（--target all）时，脚本会自动生成 install-multiplatform.sh，该脚本：

  • 自动检测当前 Agent 平台
  • 安装到正确的技能路径
  • 支持通过 --platform 标志显式选择平台

平台速查

平台技能路径指令文件配置格式
Claude Code.claude/skills/CLAUDE.mdJSON（.mcp.json）
OpenAI Codex.agents/skills/AGENTS.mdTOML（config.toml）
Gemini CLI.gemini/skills/GEMINI.mdJSON（settings.json）
Antigravity.agent/skills/GEMINI.mdJSON（mcp_config.json）
Cursor.cursor/skills/.cursor/rules/*.mdcJSON（mcp.json）

如需查看完整的平台规范，请加载 references/platforms.md。

级别转换指南

  • 级别 1（单个 SKILL.md）：转换顺利。建议自动转换。
  • 级别 2（技能 + 脚本）：转换效果良好。请验证脚本路径。
  • 级别 3（多技能）：部分支持。每个子技能可独立转换。路由需要手动处理。
  • 级别 4（生态系统）：需要手动审核。子 Agent 委派需要针对平台进行适配。

评论

支持 Markdown