skill-porter
一键转换 Claude Code 技能与 Gemini CLI 扩展的通用工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:skill-porter。 它的用途是:一键转换 Claude Code 技能与 Gemini CLI 扩展的通用工具 完整的 Skill 内容见:https://321skill.com/skills/skill-porter/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我把 ~/projects/my-claude-skill 这个技能转换成能在 Gemini CLI 里用的扩展。' 它会调用 Skill Porter 分析源文件结构,自动生成适配 Gemini 的 gemini-extension.json 和 GEMINI.md 等文件,并输出到指定目录。或者,你可以直接命令它:'验证一下刚转换好的扩展是否符合规范。'
介绍
Skill Porter 解决了开发者在 Claude Code 和 Gemini CLI 两个平台间迁移或复用技能时的格式转换难题。它自动化处理了两种平台在元数据格式、工具权限配置、文档结构等方面的差异,让开发者只需编写一次核心功能,就能轻松适配两个平台。
使用方式非常灵活,既可以通过 npm 全局安装作为命令行工具,直接执行转换命令;也可以将其本身作为一个技能或扩展安装到 Claude Code 或 Gemini CLI 中,在 AI 对话环境中直接调用,实现“用 AI 转换 AI 技能”的便捷体验。
它非常适合为多个 AI 平台开发工具的开发者、希望最大化技能复用率的团队,以及想要尝试不同 AI 平台但不想重复开发的学习者。无论是将成熟的 Claude 技能移植到 Gemini 生态,还是反向操作,都能大幅提升效率。
需要注意的是,转换过程主要处理平台特定的配置文件和元数据,核心的业务逻辑代码(尤其是 MCP 服务器部分)通常无需改动即可复用。建议在转换后进行验证,确保生成的文件符合目标平台的要求。
核心特点
这是目前首个专注于 Claude Code 技能与 Gemini CLI 扩展之间双向转换的专用工具,通过智能分析源文件结构和自动映射平台差异配置(如白名单与黑名单的逻辑反转),实现了高达85%的代码复用率。
注意事项
主要处理配置和文档的格式转换,对于技能核心逻辑中高度依赖特定平台 API 或 SDK 的部分,可能仍需手动调整。
常见问题
Skill Porter 能转换哪些内容?
自动转换技能元数据(YAML/JSON)、工具权限配置、MCP服务器设置、环境变量定义及主要文档(SKILL.md/GEMINI.md)。
转换后的技能能直接使用吗?
核心 MCP 代码通常可直接运行,但建议使用内置的 validate 命令进行验证,并参考目标平台文档进行最终测试。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/skill-porter/raw/index.md 读取 skill-porter 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/skill-porter/raw/index.md(查看排版版本)