Skip to content
Back to search

gemini-cli-skillz

Gemini CLI extension for Anthropic-style Agent Skills via skillz MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/intellectronica-gemini-cli-skillz/badge.svg)](/listings/intellectronica-gemini-cli-skillz)

HTML

<a href="/listings/intellectronica-gemini-cli-skillz"><img src="/api/listings/intellectronica-gemini-cli-skillz/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

**Note**: If the GitHub release download fails with a 415 error, answer "Y" when prompted to install via git clone instead.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Gemini CLI Skills Extension
  2. Run Anthropic-style Agent Skills in Gemini CLI using the [skillz MCP server](https://github.com/intellectronica/skillz).
  3. ## Installation
  4. ```bash
  5. gemini extensions install https://github.com/intellectronica/gemini-cli-skillz
  6. ```
  7. **Note**: If the GitHub release download fails with a 415 error, answer "Y" when prompted to install via git clone instead.
  8. ## Setup
  9. 1. **Create skills directory** (if using default):
  10. ```bash
  11. mkdir -p ~/.skillz
  12. ```
  13. **Or, if you already use Claude Code skills**, create a symbolic link:
  14. ```bash
  15. ln -s ~/.claude/skills ~/.skillz
  16. ```
  17. This allows you to share the same skills directory between Claude Code and Gemini CLI without copying files or modifying the extension configuration.
  18. 2. **Add skills** to the directory. Each skill is a folder with a SKILL.md file.
  19. 3. **Restart Gemini CLI** to load the skills.
  20. ## Example: Installing Anthropic Skills
  21. ```bash
  22. cd ~/.skillz
  23. # Clone specific skills from Anthropic's repository
  24. git clone --depth 1 --filter=blob:none --sparse \
  25. https://github.com/anthropics/skills.git temp
  26. cd temp
  27. git sparse-checkout set document-skills/pdf
  28. mv document-skills/pdf ../
  29. cd ..
  30. rm -rf temp
  31. ```
  32. ## Using Skills
  33. Skills are invoked automatically based on your task. Example:
  34. ```
  35. > Extract form fields from this PDF
  36. [Gemini invokes the pdf skill automatically]
  37. ```
  38. ## Configuration
  39. The extension uses `~/.skillz` as the default skills directory (skillz's built-in default).
  40. ### Using a Custom Skills Directory
  41. To use a different skills directory, edit the extension configuration:
  42. **Edit `~/.gemini/extensions/skillz/gemini-extension.json`** and add your custom path to the args array:
  43. ```json
  44. {
  45. "mcpServers": {
  46. "skillz": {
  47. "command": "uvx",
  48. "args": [
  49. "skillz@latest",
  50. "/absolute/path/to/your/skills",
  51. "--verbose"
  52. ]
  53. }
  54. }
  55. }
  56. ```
  57. **Important notes:**
  58. - Use an absolute path (e.g., `/Users/you/my-skills`)
  59. - Tilde (`~`) won't expand - use full path like `/Users/yourusername/.skillz`
  60. - Or use `$HOME/.custom-skills` if your shell expands it before Gemini CLI sees it
  61. Then restart Gemini CLI.
  62. ## Requirements
  63. - **uvx** — Installed automatically with uv package manager
  64. - **Gemini CLI** — Latest version recommended
  65. ## Troubleshooting
  66. **Skills not loading**:
  67. - Check your skills directory exists (default: `~/.skillz`)
  68. - Verify SKILL.md files have valid YAML frontmatter
  69. - Run `/mcp list` to see if skillz server connected
  70. **Skills not recognized**:
  71. - Restart Gemini CLI after adding skills
  72. - Check skillz server logs with Gemini CLI debug mode
  73. **uvx command not found**:
  74. - Install uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`
  75. **Custom skills directory not working**:
  76. - Verify you're using an absolute path (no `~` tilde)
  77. - Check that you edited gemini-extension.json correctly (see Configuration section)
  78. - Ensure the path exists: `ls -la /your/custom/path`
  79. ## About
  80. This extension packages the [skillz MCP server](https://github.com/intellectronica/skillz) for Gemini CLI, enabling the same Agent Skills format used in Claude.ai and Claude Code.
  81. Repository: https://github.com/intellectronica/gemini-cli-skillz
  82. Skills are loaded from PyPI via `uvx skillz@latest`, ensuring you always have the latest version.
  83. ## License
  84. Same as skillz — see repository LICENSE file.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.