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之间共享相同的技能目录，而无需复制文件或修改扩展配置。

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

1. 重新启动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文件。