SkillzSAFE

👌 Use _skills_ in any agent (Codex, Copilot, Cursor, etc...)

[](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.

Quick Start

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"
]
}
}

Gemini CLI Extension

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

Install it with:

gemini extensions install