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

| Parameter | Required | Default | Example | | --------- | -------- | ------------------- | ------------------------------ | | URL | No | - | https://mcp.exa.ai | | Config | No | - | ./mcp.json | | Transport | No | http | http or sse | | Name | No | from URL or config | exa-search | | Output | No | ./<name>/SKILL.md | ./skills/exa-search/SKILL.md |

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)

| URL | Tools | Good | Bad | | --------------------------------- | ------------------------------- | ----------------- | --------- | | https://mcp.exa.ai | webSearchExa, getCodeContextExa | mcp-exa-search | exa | | https://api.example.com/weather | getWeather, getForecast | mcp-weather-api | weather |

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

| Error | Action | | ------------------ | ----------------------------------------------- | | Connection timeout | Verify URL, check network, increase --timeout | | No tools returned | Server may require auth or have no tools | | Transport mismatch | Try http first, fall back to sse |