mcp-to-skill-converter

Convert MCP servers into Claude Skills with SKILL.md and executor.py.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bjornslib/cobuilder-harness --skill mcp-to-skill-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-to-skill-converter
Source: https://github.com/bjornslib/cobuilder-harness/tree/main/.claude/skills/mcp-to-skill-converter
Command: npx skills add https://github.com/bjornslib/cobuilder-harness --skill mcp-to-skill-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mcp.

What problem does it solve?

Converts MCP servers into Claude Skills using progressive disclosure to dramatically reduce context usage when loading large tool definitions.

Core Features & Use Cases

  • Progressive disclosure: load only metadata at startup, full instructions on first use, tools executed externally.
  • Batch and single-server conversion from .mcp.json; auto-output to mcp-skills and update registry.
  • CLI driven workflow: list, convert, batch convert, and update the index.

Quick Start

Run the converter with --list to see available MCP servers, --name to convert a single server, or --all to batch convert all compatible servers.

Frequently Asked Questions about mcp-to-skill-converter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert MCP servers to Claude Skills to reduce context usage?

You can convert MCP servers to Claude Skills using progressive disclosure, which loads only metadata at startup and full instructions on first use. This dramatically reduces context usage when handling large tool definitions.

Can I batch convert all compatible MCP servers from my configuration file?

Yes, you can batch convert all compatible MCP servers from .mcp.json. The converter automatically outputs the generated skill packages to .claude/skills/mcp-skills/ and updates the registry.

What transports are supported when introspecting MCP servers for conversion?

The converter introspects MCP servers over stdio, http, and sse transports. It generates a minimal front-matter SKILL.md and wires a central executor for runtime calls.

What files are included in the generated skill package when converting an MCP server?

The generated skill package includes SKILL.md, executor.py, mcp-config.json, and package.json. These files are automatically produced under the .claude/skills/mcp-skills/ directory.

How do I list available MCP servers before converting them to skills?

You can list available MCP servers by running the converter with the --list command. This CLI-driven workflow allows you to see all servers before using --name for single conversion or --all for batch conversion.

Why does converting MCP servers into skills help with large tool definitions?

Converting MCP servers into skills helps because progressive disclosure loads only metadata at startup and executes tools externally. This prevents large tool definitions from consuming excessive context window space during your session.