@mutemoon/mcp-to-skill

Generate Claude Code skill folders from MCP server configurations. This tool helps reduce context usage by organizing MCP tool schemas into separate files while keeping descriptions readable.

Installation

npm install -g @mutemoon/mcp-to-skill

Usage

npx @mutemoon/mcp-to-skill --config <path/to/mcpServers.json> --output <skills-dir>

Arguments

• --config <path> - Path to MCP servers config JSON file
• --output <dir> - Output directory for generated skills (default: ./skills)
• --server <name> - (Optional) Generate skill for specific server only

Config Format

{
  "mcpServers": {
    "lowcode": {
      "command": "npx",
      "args": ["-y", "@skyland/lowcode-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
    }
  }
}

Generated Structure

For each MCP server, a skill folder is generated:

skills/
└── using-lowcode/
    ├── SKILL.md              # Tool descriptions and usage
    ├── mcp.json              # Server config for call-mcp-tool
    └── references/
        ├── create-view.json  # Input schema for create-view tool
        └── edit-view.json    # Input schema for edit-view tool

SKILL.md Format

---
name: using-lowcode
description: Tools provided by the lowcode MCP server
---

# lowcode MCP Tools

## Available Tools

### create-view

Creates a new view component.

**Input Schema:** [create-view.json](./references/create-view.json) (approx. 150 words)

## How to Use

- [ ] Use `Read` skill to read the input schema.

- [ ] Call tools using the `call-mcp-tool` CLI:

```bash
npx -y call-mcp-tool@latest --config path/to/skill/mcp.json --tool <tool-name> --input '<json>'
```

Example

# Generate skills from your MCP config
npx @mutemoon/mcp-to-skill \
  --config ~/.claude/mcp_servers.json \
  --output ./my-skills