skills-mcp 0.1.0

A Model Context Protocol (MCP) server for managing AI Agent Skills.

Skills MCP

The Package Manager for AI Agents.

Skills MCP connects your LLM Agent (like Claude Desktop) to a global registry of capabilities. It allows your Agent to autonomously discover, install, and learn new skills to solve complex tasks.

Thin MCP, Fat Agent Philosophy: This tool handles the delivery of code and instructions, empowering the Agent to execute them using its own environment (e.g., uv, bash).

---

🚀 Features

• Search: Find skills for specific tasks (e.g., "pdf", "excel", "diagram").
• Install: One-click download and installation to your local machine (~/.skills).
• Learn: Provides the Agent with the exact file structure and SKILL.md instructions.
• Dependency Management: Works seamlessly with uv to let Agents self-manage Python environments.

---

📦 Installation

The recommended way to install is via uv (a fast Python package manager).

Prerequisites

• Python 3.10+
• uv (Recommended) or pip

# 1. Install uv (if you haven't already)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Install Skills MCP globally
uv tool install skills-mcp

Or using pip:

pip install skills-mcp

---

⚙️ Configuration

To use Skills MCP with Claude Desktop, add the following to your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "skills": {
      "command": "uv",
      "args": ["tool", "run", "skills-mcp"],
      "env": {
        "SKILLS_ROOT": "~/.skills",
        "SKILLS_REGISTRY_URL": "https://skills.leezhu.cn/api/v1"
      }
    }
  }
}

Environment Variables

Variable	Description	Default
SKILLS_ROOT	Where skills are installed locally.	~/.skills
SKILLS_REGISTRY_URL	The API endpoint of the skills registry.	https://skills.leezhu.cn/api/v1
SKILLS_API_KEY	(Optional) Token for private registries.	None

---

💡 Usage Guide (for Agents)

Once installed, you can ask Claude to do things like:

1. Discovery:

   "Search for a skill that can split Excel files." (Claude calls skills_search)

2. Acquisition:

   "Install the excel-pro skill." (Claude calls skills_install)

3. Execution:

   "Read the instructions for excel-pro and split this file." (Claude calls skills_get_details, reads the SKILL.md, installs dependencies via uv, and runs the script)

---

🛠️ Development

Setup

git clone https://github.com/leezhu/skills-mcp.git
cd skills-mcp

# Install dependencies
uv sync

Running Locally (StdIO Mode)

# Direct run
uv run skills-mcp

Testing with MCP Inspector

npx @modelcontextprotocol/inspector uv run skills-mcp

---

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

1. Fork the repository.
2. Create your feature branch.
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.