返回市场
技能到扩展

技能到扩展

作者:simongwatts8 星标更新:2025-11-07

项目介绍

技能到扩展转换器

一个命令行工具,用于将Anthropic Claude技能转换为自包含的Google Gemini扩展。


👋 请注意!

这是一个个人开源项目,并未与Anthropic或Google有任何关联。我创建它是为了解决我遇到的问题,希望它也能对你有所帮助。它以“现状”提供,没有任何官方支持。

快速安全提示 ⚠️: 请将此工具视为实验性的概念验证。由于技能/扩展可能包含代码,处理这些代码时应像对待任何在线找到的不受信任脚本一样谨慎。为了额外的安全性,建议在沙箱或容器中运行它们。自行承担风险。


概述

该项目提供了一个Python脚本,用于自动化将Claude技能迁移到Gemini扩展格式的过程。该脚本递归查找技能,进行转换,并注入一个通用的MCP服务器,使扩展能够读取其自身的文件。

安装到Gemini CLI的全局目录后,所有技能将在启动时加载到模型的上下文中,使其立即了解其全部能力范围。

特性

  • 递归转换: 自动查找目录及其子目录中的所有有效技能(SKILL.md)。
  • 全局上下文感知: 所有已安装的技能在启动时都会被加载,允许模型从第一个提示开始就了解其全部能力。
  • 自包含扩展: 每个转换后的技能都成为一个带有内置文件读取服务器的独立Gemini扩展。
  • 安全透明: 将技能转换到本地输出文件夹,让你完全控制安装过程。

预备条件

  • Python(版本3.7或更高)
  • 已安装并配置好的Google Gemini CLI
  • 已安装的Git
  • fastmcp Python库。使用pip一次性安装:
    pip install fastmcp
    

完整教程:转换、安装和验证

本指南将引导你完成克隆官方Anthropic技能仓库、转换它们并将其安装为全局使用的步骤。

第一步:获取源技能

首先,将官方技能仓库从Anthropic克隆到本地文件夹。

git clone https://github.com/anthropics/skills.git

第二步:安装转换器脚本

接下来,我们将安装转换器,以便可以作为本地Gemini命令运行。

# 克隆这个仓库
git clone https://github.com/simongwatts/skills-to-extensions.git

# 如果不存在,则创建gemini命令目录
mkdir -p ~/.gemini/commands

# 将两个必要的文件复制到gemini命令目录
cp skills-to-extensions/skill_converter.py ~/.gemini/commands/
cp skills-to-extensions/server.py ~/.gemini/

第三步:执行转换

导航到你在第一步中克隆的skills目录并运行转换器脚本。

# 更改目录到源技能
cd skills

# 运行转换过程。输出将在新的'converted_skills'文件夹中。
python ~/.gemini/commands/skill_converter.py . --output ./converted_skills

第四步:手动安装扩展

要使扩展在全球范围内可用,请将它们从converted_skills文件夹移动到Gemini CLI的专用扩展目录。

# 如果不存在,则创建目标目录
mkdir -p ~/.gemini/extensions

# 此命令将所有转换后的扩展移动到正确的位置。
mv ./converted_skills/* ~/.gemini/extensions/

第五步:验证全局上下文

关键步骤: 在启动Gemini之前,必须从skills源目录导航出来。这是为了确保你正在测试的是来自~/.gemini/extensions的全局安装扩展,而不是当前文件夹中的本地源文件。

现在,我们将确认Gemini模型从一开始就意识到所有新技能。

  1. 从任意目录以交互模式启动Gemini CLI:

    gemini
    
  2. 询问模型它有哪些技能。 因为所有全局扩展都在启动时加载,模型可以从所有SKILL.md文件的组合上下文中总结其能力。

    gemini> /extensions list
    gemini> /mcp list
    gemini> 你上下文中有哪些技能?
    

    预期输出(模型将生成类似以下的摘要):

    ✦ 我有以下可用技能:
    
    * algorithmic-art: 使用p5.js创建算法艺术。
    * artifacts-builder: 使用React和Tailwind CSS构建复杂的HTML艺术品。
    * brand-guidelines: 应用Anthropic的品牌颜色和字体。
    * canvas-design: 创建.png和.pdf文档的视觉艺术。
    * docx: 创建、编辑和分析.docx文件。
    * internal-comms: 帮助编写内部通信,如状态报告和新闻通讯。
    * mcp-builder: 创建MCP服务器以与外部服务交互。
    * pdf: 操作PDF文件(提取文本、合并、拆分等)。
    * pptx: 创建、编辑和分析.pptx演示文稿。
    * skill-creator: 帮助创建新技能。
    * slack-gif-creator: 创建优化用于Slack的动画GIF。
    * template-skill: 创建新技能的模板。
    * theme-factory: 使用预设或自定义主题美化艺术品。
    * webapp-testing: 使用Playwright测试本地Web应用程序。
    * xlsx: 创建、编辑和分析电子表格文件。
    

这确认了安装成功,模型已准备好使用。

第六步:开始使用你的技能(示例提示)

现在所有技能都已加载到模型的上下文中,你可以提出高层次请求,而无需为每个命令指定@工具名称。这里有一些尝试的例子:


创意和技术技能:

“使用algorithmic-art技能,构想一幅由遗忘信号回声编织而成的动态挂毯。粒子, 每一个都是残余能量的碎片,在不可见力场中漂移,其轨迹微妙地受到过去互动的幽灵电流的影响。当它们移动时,留下逐渐消散的光亮轨迹,形成一个不断变化的光影瞬息万变的景观。这件作品应该捕捉衰败之美和运动的持久记忆,其中秩序从无数个体路径的温和混乱中浮现。这一作品的概念种子是‘时间共振’——在流动的数字空间中遗留能量印记的视觉表现。”

这将利用algorithmic-art-ext技能。


元技能(关于创建技能的技能):

“我想创建一个新的技能来与GitHub API交互。我需要哪些关键文件,以及应该在SKILL.md中放入什么内容?”

这将使用skill-creator-ext来指导你完成过程。


许可证

本项目根据MIT许可证发布。详情请参阅LICENSE文件。