AI导哈

技能扩展工具

Gemini CLI的技能扩展工具，允许用户安装和管理Anthropic风格的Agent技能，适用于自动化任务处理。

  • by intellectronica
  • 本地部署
  • 97 星标
  • 更新于
在 GitHub 查看 intellectronica/gemini-cli-skillz

使用说明

Gemini CLI技能扩展

使用以下命令在Gemini CLI中运行拟人风格的代理技能 skillz MCP服务器.

安装

gemini extensions install https://github.com/intellectronica/gemini-cli-skillz

备注：如果GitHub版本下载失败，出现415错误，请在提示通过git clone安装时回答“Y”。

设置

  1. 创建技能目录 （如果使用默认值）：

    mkdir -p ~/.skillz

    或者，如果你已经使用了Claude Code技能，创建符号链接：

    ln -s ~/.claude/skills ~/.skillz

    这允许您在Claude Code和Gemini CLI之间共享相同的技能目录，而无需复制文件或修改扩展配置。

  2. 添加技能 到目录。每个技能都是一个包含skill.md文件的文件夹。

  3. 重新启动Gemini CLI 加载技能。

示例：安装拟人技能

cd ~/.skillz

# Clone specific skills from Anthropic's repository
git clone --depth 1 --filter=blob:none --sparse \
  https://github.com/anthropics/skills.git temp
cd temp
git sparse-checkout set document-skills/pdf
mv document-skills/pdf ../
cd ..
rm -rf temp

使用技能

技能会根据您的任务自动调用。例子：

> Extract form fields from this PDF
[Gemini invokes the pdf skill automatically]

配置

该扩展使用 ~/.skillz 作为默认技能目录（skillz的内置默认目录）。

使用自定义技能目录

要使用其他技能目录，请编辑扩展配置：

编辑 ~/.gemini/extensions/skillz/gemini-extension.json 并将您的自定义路径添加到args数组中：

{
  "mcpServers": {
    "skillz": {
      "command": "uvx",
      "args": [
        "skillz@latest",
        "/absolute/path/to/your/skills",
        "--verbose"
      ]
    }
  }
}

重要提示：

  • 使用绝对路径（例如。， /Users/you/my-skills)
  • 蒂尔德(~)不会扩展-使用完整路径，如 /Users/yourusername/.skillz
  • 或使用 $HOME/.custom-skills 如果你的shell在Gemini CLI看到它之前就展开了它

然后重新启动Gemini CLI。

需求

  • uvx --使用uv包管理器自动安装
  • Gemini CLI --推荐最新版本

故障排除

技能未加载:

  • 检查您的技能目录是否存在（默认值： ~/.skillz)
  • 验证SKILL.md文件是否具有有效的YAML frontmatter
  • 跑 /mcp list 查看skillz服务器是否已连接

技能未被识别:

  • 添加技能后重新启动Gemini CLI
  • 使用Gemini CLI调试模式检查skillz服务器日志

未找到uvx命令:

  • 安装紫外线： curl -LsSf https://astral.sh/uv/install.sh | sh

自定义技能目录不起作用:

  • 验证您使用的是绝对路径（否 ~ 瓷砖）
  • 检查您是否正确编辑了gemini-extension.json（请参阅配置部分）
  • 确保路径存在： ls -la /your/custom/path

关于

此扩展打包了 skillz MCP服务器 对于Gemini CLI，启用与Claude.ai和Claude Code中使用的Agent Skills格式相同的格式。

存储库：https://github.com/intellectronica/gemini-cli-skillz

技能通过PyPI加载 uvx skillz@latest，确保您始终拥有最新版本。

许可证

与skillz相同——请参阅存储库LICENSE文件。

相关 MCP