openskills-mcp

Discover and install AI agent skills via the Model Context Protocol.

OpenSkills indexes skills from trusted GitHub repositories and makes them searchable through MCP tools. This package connects your AI agent to the hosted OpenSkills server.

Quick Start

npx openskills-mcp --api-key osk_your_key_here

Get your API key at openskills.dev/dashboard.

MCP Configuration

Claude Desktop / Claude Code

Add to your claude_desktop_config.json or .claude/settings.json:

{
  "mcpServers": {
    "openskills": {
      "command": "npx",
      "args": [
        "-y",
        "openskills-mcp",
        "--api-key",
        "osk_your_key_here"
      ]
    }
  }
}

Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "openskills": {
      "command": "npx",
      "args": [
        "-y",
        "openskills-mcp",
        "--api-key",
        "osk_your_key_here"
      ]
    }
  }
}

Available Tools

search_skills

Search for skills using natural language.

search_skills("process PDF files", max_results=5, verified_only=true)

Returns skill metadata: name, description, tags, stars, verified status, relevance score.

get_skill

Get installation command for a skill.

get_skill(skill="pdf-processing", agent="claude-code", global_install=false)

Returns a simple installation command:

npx openskills-cli pdf-processing -a claude-code

The openskills CLI handles downloading, extracting, and symlinking automatically.

How It Works

This package runs a local MCP server (stdio transport) that proxies requests to the hosted OpenSkills server (HTTP transport) with your API key for authentication.

Your AI Agent <--stdio--> openskills-mcp <--HTTP--> OpenSkills Server

Requirements

• Node.js >= 18.0.0
• An OpenSkills API key

License

MIT