skillz

[](https://pypi.org/project/skillz/) [](https://pypi.org/project/skillz/)

> ⚠️ Experimental proof‑of‑concept. Potentially unsafe. Treat skills like untrusted code and run in sandboxes/containers. Use at your own risk.

Skillz is an MCP server that turns Claude-style skills _(SKILL.md plus optional resources)_ into callable tools for any MCP client. It discovers each skill, exposes the authored instructions and resources, and can run bundled helper scripts.

> 💡 You can find skills to install at the [Skills Supermarket](http://skills.intellectronica.net/) directory.

To run the MCP server in your agent, use the following config (or equivalent):

{
  "skillz": {
    "command": "uvx",
    "args": ["skillz@latest"]
  }
}

with the skills residing at ~/.skillz

_or_

{
  "skillz": {
    "command": "uvx",
    "args": ["skillz@latest", "/path/to/skills/direcotry"]
  }
}

or Docker

You can run Skillz using Docker for isolation. The image is available on Docker Hub at intellectronica/skillz.

To run the Skillz MCP server with your skills directory mounted using Docker, configure your agent as follows:

Replace /path/to/skills with the path to your actual skills directory. Any arguments after intellectronica/skillz in the array are passed directly to the Skillz CLI.

{
  "skillz": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-v",
      "/path/to/skills:/skillz",
      "intellectronica/skillz",
      "/skillz"
    ]
  }
}

A Gemini CLI extension is available at intellectronica/gemini-cli-skillz.

Install it with:

gemini extensions insta