MCP Skill Generator

MCP Skill Generator

Generate reusable skills from any MCP server using mh CLI.

Prerequisites

• mh CLI must be installed. If not available, install with:

  curl -fsSL https://raw.githubusercontent.com/​vaayne/​mcphub/​main/​scripts/​install.sh | sh
  

Workflow

1. Gather Input

Notes:

• --url/​-u and --config/​-c are mutually exclusive
• Config mode uses the tool names returned by mh list, with JS-style name mapping and collision checks

2. Discover Tools

URL mode:

mh -u <url> -t <transport> list

Stdio mode:

mh --stdio list -- cmd args ...

Config mode:

mh -c <config> list

3. Generate Skill

Read references/​skill-template.md, fill placeholders: {skill-name}, {description}, {Title}, {url}, {transport}, {tool-count}, {tools-list}, {usage-block}, {notes-block}.

Usage blocks:

URL mode:

List tools: `mh -u {url} -t {transport} list`
Get tool details: `mh -u {url} -t {transport} inspect <tool-name>`
Invoke tool: `mh -u {url} -t {transport} invoke <tool-name> '{"param": "value"}'`

Config mode (use local config file name):

List tools: `mh -c {config-file} list`
Get tool details: `mh -c {config-file} inspect <tool-name>`
Invoke tool: `mh -c {config-file} invoke <tool-name> '{"param": "value"}'`

Notes blocks:

URL mode:

- Run `inspect` before invoking unfamiliar tools to get full parameter schema
- Timeout: 30s default, use `--timeout <seconds>` to adjust

Config mode:

- Run `inspect` before invoking unfamiliar tools to get full parameter schema
- Timeout: 30s default, use `--timeout <seconds>` to adjust

4. Write Output

Save to output path, create directories if needed.

If input is a config file, copy it into the generated skill folder as config.json and set {config-file} in the usage block to ./​config.json, relative to the generated SKILL.md location.

Naming Guidelines

Name: Focus on capability, not source. Pattern: {source}-{capability} (kebab-case, 2-3 words)

Description: {Action + capability}. Use when {conditions}. Triggers on "{phrase1}", "{phrase2}".

• Start with action verb (Search, Fetch, Get, Create, Analyze)
• Include 3-5 trigger phrases, mention service name, keep under 200 chars

Error Handling