{
  "markdown": "# Gemini CLI Skills Extension\n\nRun Anthropic-style Agent Skills in Gemini CLI using the [skillz MCP server](https://github.com/intellectronica/skillz).\n\n## Installation\n\n```bash\ngemini extensions install https://github.com/intellectronica/gemini-cli-skillz\n```\n\n**Note**: If the GitHub release download fails with a 415 error, answer \"Y\" when prompted to install via git clone instead.\n\n## Setup\n\n1. **Create skills directory** (if using default):\n   ```bash\n   mkdir -p ~/.skillz\n   ```\n\n   **Or, if you already use Claude Code skills**, create a symbolic link:\n   ```bash\n   ln -s ~/.claude/skills ~/.skillz\n   ```\n\n   This allows you to share the same skills directory between Claude Code and Gemini CLI without copying files or modifying the extension configuration.\n\n2. **Add skills** to the directory. Each skill is a folder with a SKILL.md file.\n\n3. **Restart Gemini CLI** to load the skills.\n\n## Example: Installing Anthropic Skills\n\n```bash\ncd ~/.skillz\n\n# Clone specific skills from Anthropic's repository\ngit clone --depth 1 --filter=blob:none --sparse \\\n  https://github.com/anthropics/skills.git temp\ncd temp\ngit sparse-checkout set document-skills/pdf\nmv document-skills/pdf ../\ncd ..\nrm -rf temp\n```\n\n## Using Skills\n\nSkills are invoked automatically based on your task. Example:\n\n```\n> Extract form fields from this PDF\n[Gemini invokes the pdf skill automatically]\n```\n\n## Configuration\n\nThe extension uses `~/.skillz` as the default skills directory (skillz's built-in default).\n\n### Using a Custom Skills Directory\n\nTo use a different skills directory, edit the extension configuration:\n\n**Edit `~/.gemini/extensions/skillz/gemini-extension.json`** and add your custom path to the args array:\n```json\n{\n  \"mcpServers\": {\n    \"skillz\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"skillz@latest\",\n        \"/absolute/path/to/your/skills\",\n        \"--verbose\"\n      ]\n    }\n  }\n}\n```\n\n**Important notes:**\n- Use an absolute path (e.g., `/Users/you/my-skills`)\n- Tilde (`~`) won't expand - use full path like `/Users/yourusername/.skillz`\n- Or use `$HOME/.custom-skills` if your shell expands it before Gemini CLI sees it\n\nThen restart Gemini CLI.\n\n## Requirements\n\n- **uvx** — Installed automatically with uv package manager\n- **Gemini CLI** — Latest version recommended\n\n## Troubleshooting\n\n**Skills not loading**:\n- Check your skills directory exists (default: `~/.skillz`)\n- Verify SKILL.md files have valid YAML frontmatter\n- Run `/mcp list` to see if skillz server connected\n\n**Skills not recognized**:\n- Restart Gemini CLI after adding skills\n- Check skillz server logs with Gemini CLI debug mode\n\n**uvx command not found**:\n- Install uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`\n\n**Custom skills directory not working**:\n- Verify you're using an absolute path (no `~` tilde)\n- Check that you edited gemini-extension.json correctly (see Configuration section)\n- Ensure the path exists: `ls -la /your/custom/path`\n\n## About\n\nThis 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.\n\nRepository: https://github.com/intellectronica/gemini-cli-skillz\n\nSkills are loaded from PyPI via `uvx skillz@latest`, ensuring you always have the latest version.\n\n## License\n\nSame as skillz — see repository LICENSE file.\n",
  "bytes": 3364,
  "sha": "2bfdad701aa0857aca78b18bc29922d52e4d638461173a1a11fcd24987b8763e",
  "repo_slug": "intellectronica/gemini-cli-skillz",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_intellectronica_gemini_cli_skillz_9fba172b/readme"
}