mcp-to-skill

Convert any MCP (Model Context Protocol) server's prompts and resources into Agent Skills — ready to use with Claude Code and other AI agents.

Usage

npx @mcp-s/mcp-to-skill <mcp-server-url> [options]

Options

| Flag | Default | Description | |------|---------|-------------| | -o, --output <dir> | ./skills | Output directory for generated skills | | -h, --help | | Show help |

Examples

# Generate skills from a public MCP server
npx @mcp-s/mcp-to-skill https://my-mcp-server.com/mcp

# Specify a custom output directory
npx @mcp-s/mcp-to-skill https://my-mcp-server.com/mcp -o ./my-skills

How it works

1. Connect — Connects to the MCP server via Streamable HTTP or SSE transport.
2. Authenticate — If the server requires OAuth, your browser opens automatically. Tokens are stored in ~/.mcp-to-skill/auth.json for future runs.
3. Select — An interactive checklist shows all available prompts and resources. Toggle items with space, confirm with enter.
4. Generate — Each selected item becomes a skill directory with a SKILL.md file.

Output format

Each skill follows the Agent Skills specification:

skills/
├── my-prompt/
│   └── SKILL.md
└── my-resource/
    └── SKILL.md

Example SKILL.md for a prompt:

---
name: code-review
description: Review code for bugs and style issues. Use when you need automated feedback.
metadata:
  mcp-server: https://example.com/mcp
  mcp-type: prompt
  mcp-name: code_review
---

## Overview

...

## Arguments

| Name | Required | Description |
|------|----------|-------------|
| code | Yes      | The code to review |

## Usage

...

Authentication

Protected MCP servers using OAuth 2.0 + PKCE are supported automatically:

• On first access, your browser opens for authorization.
• Tokens are cached at ~/.mcp-to-skill/auth.json (mode 0600).
• Dynamic Client Registration (RFC 7591) is used when available.

Requirements

• Node.js 18 or later

Install globally

npm install -g @mcp-s/mcp-to-skill
mcp-to-skill https://my-mcp-server.com/mcp

License

MIT