vaayne MCP Skill Generator
Generate reusable skills from any MCP server using mh CLI.
Prerequisites
mhCLI 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/-uand--config/-care 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 list -u <url> -t <transport>
Stdio mode:
mh list --stdio -- cmd args ...
Config mode:
mh list -c <config>
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 list -u {url} -t {transport}`
Get tool details: `mh inspect -u {url} -t {transport} <tool-name>`
Invoke tool: `mh invoke -u {url} -t {transport} <tool-name> '{"param": "value"}'`
Config mode (use local config file name):
List tools: `mh list -c {config-file}`
Get tool details: `mh inspect -c {config-file} <tool-name>`
Invoke tool: `mh invoke -c {config-file} <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 |