Skillz

v1.0.0Developer Toolsstable

An MCP server that transforms Claude-style skills and resources into callable tools for any MCP-compatible agent or client. It automatically discovers, exposes, and executes scripts from skills organized in local directories or packaged archives.

agentaimcpmcp-serverskills
Share:
395
Stars
0
Downloads
0
Weekly
0/5

What is Skillz?

Skillz is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that transforms claude-style skills and resources into callable tools for any mcp-compatible agent or client. it automatically discovers, exposes, and executes scripts from skills organized...

An MCP server that transforms Claude-style skills and resources into callable tools for any MCP-compatible agent or client. It automatically discovers, exposes, and executes scripts from skills organized in local directories or packaged archives.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server that transforms Claude-style skills and resour

Use Cases

Claude skill transformation
Callable agent tools
Script discovery and execution
intellectronica

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx skillz

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Skillz

Skillz is a Python-based MCP server that automatically discovers, loads, and exposes Claude-style skills as callable MCP tools for any compatible AI agent or client. It reads SKILL.md files with YAML frontmatter from a configurable local directory (defaulting to ~/.skillz), unpacks skill archives (.zip or .skill), and makes the skill's instructions, resources, and helper scripts available as tools. This lets teams package reusable agent capabilities once and share them across Claude Desktop, Codex, Copilot, Cursor, and Gemini CLI.

Prerequisites

  • Python environment supporting uvx (install with 'pip install uv') or Docker
  • An MCP-compatible client such as Claude Desktop, Cursor, Codex, or Gemini CLI
  • Skills organized as directories or archives containing SKILL.md files
  • Docker (recommended for sandboxed, untrusted skill execution)
1

Install Skillz via uvx

Skillz is published on PyPI and can be run without a permanent install using uvx.

# Run directly (no install needed):
uvx skillz@latest

# Or install permanently:
pip install skillz
2

Create Your Skills Directory

Create the default skills directory and add your first skill. Each skill lives in its own subdirectory with a SKILL.md file defining its metadata and instructions.

mkdir -p ~/.skillz/my-first-skill

# Create ~/.skillz/my-first-skill/SKILL.md with content:
# ---
# name: my-first-skill
# description: A skill that does something useful
# version: 1.0.0
# ---
# ## Instructions
# Describe what the skill does and how to use it.
3

List Discovered Skills

Verify that Skillz discovers your skills correctly by running the list-skills command.

uvx skillz@latest --list-skills
4

Configure Claude Desktop

Add Skillz to your Claude Desktop configuration. The positional argument specifies a custom skills directory; omit it to use the default ~/.skillz.

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

Or Run with Docker for Sandboxing

For untrusted skills that execute scripts, run Skillz inside a Docker container to isolate execution from your host system.

docker run -v ~/.skillz:/skills intellectronica/skillz --skills-dir /skills

Skillz Examples

Client configuration

Claude Desktop configuration for Skillz using uvx to load skills from the default ~/.skillz directory.

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

Prompts to try

Example prompts once Skillz is connected and skills are loaded.

- "What skills are available in my skillz directory?"
- "Use the summarize-docs skill to summarize the files in ~/Documents/reports"
- "Run the web-search skill to find recent news about MCP servers"
- "List all loaded skills and their descriptions"

Troubleshooting Skillz

No skills discovered after pointing to skills directory

Each skill must have a SKILL.md file at the root of its subdirectory with valid YAML frontmatter (delimited by ---). Check that the frontmatter block has at least 'name' and 'description' fields. Run 'uvx skillz@latest --list-skills --verbose' to see discovery details.

Skill helper scripts fail to execute

Skill scripts must be executable. Run 'chmod +x ~/.skillz/your-skill/script.py' on macOS/Linux. If using Docker, ensure the mounted volume has the correct permissions. Consider running untrusted skills in the Docker image for isolation.

Claude Desktop does not show Skillz tools after configuration

Ensure the skills directory exists and contains at least one valid skill with a SKILL.md file. Fully restart Claude Desktop. If using a custom directory path, pass it as an argument: {"args": ["skillz@latest", "/custom/path/to/skills"]}.

Frequently Asked Questions about Skillz

What is Skillz?

Skillz is a Model Context Protocol (MCP) server that mcp server that transforms claude-style skills and resources into callable tools for any mcp-compatible agent or client. it automatically discovers, exposes, and executes scripts from skills organized in local directories or packaged archives. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Skillz?

Follow the installation instructions on the Skillz GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Skillz?

Skillz works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Skillz free to use?

Yes, Skillz is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "skillz": { "command": "npx", "args": ["-y", "skillz"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Skillz?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides