| Name | skillz JSON |
| Version |
0.1.12
JSON |
| download |
| home_page | None |
| Summary | MCP server that exposes Claude-style skills to any MCP client. |
| upload_time | 2025-10-26 10:31:04 |
| maintainer | None |
| docs_url | None |
| author | Eleanor Berger |
| requires_python | >=3.12 |
| license | MIT License
Copyright (c) 2025 Eleanor Berger <eleanor@intellectronica.net>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE. |
| keywords |
mcp
skills
fastmcp
claude
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Skillz
## 👌 **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](https://github.com/anthropics/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.
## Quick Start
To run the MCP server in your agent, use the following config (or equivalent):
```json
{
"skillz": {
"command": "uvx",
"args": ["skillz@latest"]
}
}
```
with the skills residing at `~/.skillz`
_or_
```json
{
"skillz": {
"command": "uvx",
"args": ["skillz@latest", "/path/to/skills/direcotry"]
}
}
```
## Usage
Skillz looks for skills inside the root directory you provide (defaults to
`~/.skillz`). Each skill lives in its own folder or zip archive that includes a
`SKILL.md` file with YAML front matter describing the skill. Any other files in
the skill become downloadable resources for your agent (scripts, datasets,
examples, etc.).
An example directory might look like this:
```text
~/.skillz/
├── summarize-docs/
│ ├── SKILL.md
│ ├── summarize.py
│ └── prompts/example.txt
├── translate.zip
└── web-search/
└── SKILL.md
```
When packaging skills as zips, include the `SKILL.md` either at the root of the
archive or inside a single top-level directory:
```text
translate.zip
├── SKILL.md
└── helpers/
└── translate.js
```
```text
data-cleaner.zip
└── data-cleaner/
├── SKILL.md
└── clean.py
```
### Directory Structure: Skillz vs Claude Code
Skillz supports a more flexible skills directory than Claude Code. In addition to a flat layout, you can organize skills in nested subdirectories and include skills packaged as `.zip` files (as shown in the examples above).
Claude Code, on the other hand, expects a flat skills directory: every immediate subdirectory is a single skill. Nested directories are not discovered, and `.zip` files are not supported.
If you want your skills directory to be compatible with Claude Code (for example, so you can symlink one skills directory between the two tools), you must use the flat layout.
**Claude Code–compatible layout:**
```text
skills/
├── hello-world/
│ ├── SKILL.md
│ └── run.sh
└── summarize-text/
├── SKILL.md
└── run.py
```
**Skillz-only layout examples** (not compatible with Claude Code):
```text
skills/
├── text-tools/
│ └── summarize-text/
│ ├── SKILL.md
│ └── run.py
└── image-processing.zip
```
You can use `skillz --list-skills` (optionally pointing at another skills root)
to verify which skills the server will expose before connecting it to your
agent.
## CLI Reference
`skillz [skills_root] [options]`
| Flag / Option | Description |
| --- | --- |
| positional `skills_root` | Optional skills directory (defaults to `~/.skillz`). |
| `--transport {stdio,http,sse}` | Choose the FastMCP transport (default `stdio`). |
| `--host HOST` | Bind address for HTTP/SSE transports. |
| `--port PORT` | Port for HTTP/SSE transports. |
| `--path PATH` | URL path when using the HTTP transport. |
| `--list-skills` | List discovered skills and exit. |
| `--verbose` | Emit debug logging to the console. |
| `--log` | Mirror verbose logs to `/tmp/skillz.log`. |
---
> Made with 🫶 by [`@intellectronica`](https://intellectronica.net)
Raw data
{
"_id": null,
"home_page": null,
"name": "skillz",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "mcp, skills, fastmcp, claude",
"author": "Eleanor Berger",
"author_email": "Eleanor Berger <eleanor@intellectronica.net>",
"download_url": "https://files.pythonhosted.org/packages/50/94/d37cab51d946078a28aa0688145599db3e993dfaa1b2630f16c1251ebdf5/skillz-0.1.12.tar.gz",
"platform": null,
"description": "# Skillz\n\n## \ud83d\udc4c **Use _skills_ in any agent** _(Codex, Copilot, Cursor, etc...)_\n\n[](https://pypi.org/project/skillz/)\n[](https://pypi.org/project/skillz/)\n\n> \u26a0\ufe0f **Experimental proof\u2011of\u2011concept. Potentially unsafe. Treat skills like untrusted code and run in sandboxes/containers. Use at your own risk.**\n\n**Skillz** is an MCP server that turns [Claude-style skills](https://github.com/anthropics/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.\n\n## Quick Start\n\nTo run the MCP server in your agent, use the following config (or equivalent):\n\n```json\n{\n \"skillz\": {\n \"command\": \"uvx\",\n \"args\": [\"skillz@latest\"]\n }\n}\n```\n\nwith the skills residing at `~/.skillz`\n\n_or_\n\n```json\n{\n \"skillz\": {\n \"command\": \"uvx\",\n \"args\": [\"skillz@latest\", \"/path/to/skills/direcotry\"]\n }\n}\n```\n\n## Usage\n\nSkillz looks for skills inside the root directory you provide (defaults to\n`~/.skillz`). Each skill lives in its own folder or zip archive that includes a\n`SKILL.md` file with YAML front matter describing the skill. Any other files in\nthe skill become downloadable resources for your agent (scripts, datasets,\nexamples, etc.).\n\nAn example directory might look like this:\n\n```text\n~/.skillz/\n\u251c\u2500\u2500 summarize-docs/\n\u2502 \u251c\u2500\u2500 SKILL.md\n\u2502 \u251c\u2500\u2500 summarize.py\n\u2502 \u2514\u2500\u2500 prompts/example.txt\n\u251c\u2500\u2500 translate.zip\n\u2514\u2500\u2500 web-search/\n \u2514\u2500\u2500 SKILL.md\n```\n\nWhen packaging skills as zips, include the `SKILL.md` either at the root of the\narchive or inside a single top-level directory:\n\n```text\ntranslate.zip\n\u251c\u2500\u2500 SKILL.md\n\u2514\u2500\u2500 helpers/\n \u2514\u2500\u2500 translate.js\n```\n\n```text\ndata-cleaner.zip\n\u2514\u2500\u2500 data-cleaner/\n \u251c\u2500\u2500 SKILL.md\n \u2514\u2500\u2500 clean.py\n```\n\n### Directory Structure: Skillz vs Claude Code\n\nSkillz supports a more flexible skills directory than Claude Code. In addition to a flat layout, you can organize skills in nested subdirectories and include skills packaged as `.zip` files (as shown in the examples above).\n\nClaude Code, on the other hand, expects a flat skills directory: every immediate subdirectory is a single skill. Nested directories are not discovered, and `.zip` files are not supported.\n\nIf you want your skills directory to be compatible with Claude Code (for example, so you can symlink one skills directory between the two tools), you must use the flat layout.\n\n**Claude Code\u2013compatible layout:**\n\n```text\nskills/\n\u251c\u2500\u2500 hello-world/\n\u2502 \u251c\u2500\u2500 SKILL.md\n\u2502 \u2514\u2500\u2500 run.sh\n\u2514\u2500\u2500 summarize-text/\n \u251c\u2500\u2500 SKILL.md\n \u2514\u2500\u2500 run.py\n```\n\n**Skillz-only layout examples** (not compatible with Claude Code):\n\n```text\nskills/\n\u251c\u2500\u2500 text-tools/\n\u2502 \u2514\u2500\u2500 summarize-text/\n\u2502 \u251c\u2500\u2500 SKILL.md\n\u2502 \u2514\u2500\u2500 run.py\n\u2514\u2500\u2500 image-processing.zip\n```\n\nYou can use `skillz --list-skills` (optionally pointing at another skills root)\nto verify which skills the server will expose before connecting it to your\nagent.\n\n## CLI Reference\n\n`skillz [skills_root] [options]`\n\n| Flag / Option | Description |\n| --- | --- |\n| positional `skills_root` | Optional skills directory (defaults to `~/.skillz`). |\n| `--transport {stdio,http,sse}` | Choose the FastMCP transport (default `stdio`). |\n| `--host HOST` | Bind address for HTTP/SSE transports. |\n| `--port PORT` | Port for HTTP/SSE transports. |\n| `--path PATH` | URL path when using the HTTP transport. |\n| `--list-skills` | List discovered skills and exit. |\n| `--verbose` | Emit debug logging to the console. |\n| `--log` | Mirror verbose logs to `/tmp/skillz.log`. |\n\n---\n\n> Made with \ud83e\udef6 by [`@intellectronica`](https://intellectronica.net)\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 Eleanor Berger <eleanor@intellectronica.net>\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.",
"summary": "MCP server that exposes Claude-style skills to any MCP client.",
"version": "0.1.12",
"project_urls": {
"Homepage": "https://github.com/intellectronica/skillz",
"Issues": "https://github.com/intellectronica/skillz/issues"
},
"split_keywords": [
"mcp",
" skills",
" fastmcp",
" claude"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e40e7565ae2fbbb9494b0065709c222fc4473e87a4d9dfad5b01d36902d806c6",
"md5": "84a1d47da50d356320331544236e89e5",
"sha256": "325b688c2ea943336de808e71a302ab1e46c7dd0cb36f1e864aae486b2603cce"
},
"downloads": -1,
"filename": "skillz-0.1.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "84a1d47da50d356320331544236e89e5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 13600,
"upload_time": "2025-10-26T10:31:02",
"upload_time_iso_8601": "2025-10-26T10:31:02.734882Z",
"url": "https://files.pythonhosted.org/packages/e4/0e/7565ae2fbbb9494b0065709c222fc4473e87a4d9dfad5b01d36902d806c6/skillz-0.1.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5094d37cab51d946078a28aa0688145599db3e993dfaa1b2630f16c1251ebdf5",
"md5": "285dd6076537aa4a35000ce57172e2b3",
"sha256": "3269e184864c90f23645f92c07c8dd1dab09644017fb3df1631e90b4718b0427"
},
"downloads": -1,
"filename": "skillz-0.1.12.tar.gz",
"has_sig": false,
"md5_digest": "285dd6076537aa4a35000ce57172e2b3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 12468,
"upload_time": "2025-10-26T10:31:04",
"upload_time_iso_8601": "2025-10-26T10:31:04.385914Z",
"url": "https://files.pythonhosted.org/packages/50/94/d37cab51d946078a28aa0688145599db3e993dfaa1b2630f16c1251ebdf5/skillz-0.1.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-26 10:31:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "intellectronica",
"github_project": "skillz",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "skillz"
}
