MCP-to-Skill Converter

Installation

The skill invokes .claude/tools/integrations/mcp-converter/batch_converter.py. Requirements:

• Python 3.10+: python.org or winget install Python.Python.3.12 (Windows), brew install python@3.12 (macOS).
• pip: Usually included with Python; verify with pip --version.
• Dependencies: From the repo root, install deps for the integration (e.g. PyYAML if required):

  pip install pyyaml
  

  Run from project root; the script uses .claude/tools/integrations/mcp-converter/ (catalog: mcp-catalog.yaml).

Cheat Sheet & Best Practices

MCP design: Single responsibility per server; bounded toolsets; contracts first (strict I/O schemas); stateless by default; additive changes; security (identity, auth, audit). Prefer stdio for local, Streamable HTTP for remote; use a gateway for multi-tenant/centralized policy.

Conversion: Introspect server; estimate token usage of tool schemas; generate skill with progressive disclosure. Test converted skills before relying on them. Use catalog + batch_converter for rules-driven conversion.