Commands

generate-skill

Generate a new skill package from an MCP server.

mcp2skill generate-skill [flags]

Flags

Flag	Short	Description
--server	-s	MCP server name from config (required)
--output	-o	Parent directory for the skill (default: current directory)
--no-embed		Do not embed the binary in the skill package
--force	-f	Overwrite existing files without warning
--config		Path to config file

Example

mcp2skill generate-skill --server my-server --output ./skills --force

This creates ./skills/my-server/ with the skill files inside.

Output:

Skill generated successfully at: ./skills/my-server
  SKILL.md: ./skills/my-server/SKILL.md
  TOOLS.md: ./skills/my-server/references/TOOLS.md
  RESOURCES.md: ./skills/my-server/references/RESOURCES.md
  Binary: ./skills/my-server/bin/mcp2skill

Default Behavior

If --output is omitted, the skill is created in a subdirectory named after the server in the current directory:

mcp2skill generate-skill --server my-server
# Creates ./my-server/

update-skill

Update an existing skill package with fresh MCP server information.

Uses a two-phase workflow: first generates updates in a temporary directory, then applies them on confirmation.

mcp2skill update-skill [flags]

Flags

Flag	Short	Description
--skill	-s	Path to the skill directory (required)
--confirm	-c	Apply the pending updates
--discard	-d	Discard pending updates
--update-binary		Update the embedded binary when applying updates (only applicable if skill already has embedded binary)
--config		Path to config file

Example Workflow For Agents

The agent could initiates an update if a tool-call fails (indicating the tool definition has been changed on the server).

1. Generate updates:

./bin/mcp2skill update-skill

Output:

Updates available at: ./update/
Run with --confirm to apply changes or --discard to cancel

2. Review changes in ./update/

3. Apply or discard:

# Apply the updates
./bin/mcp2skill update-skill --confirm

# OR discard them
./bin/mcp2skill update-skill --discard

Example Workflow for Users

# 1. generate updates
mcp2skill update-skill --skill ~/.claude/skills/my-server

# 2. review changes

# 3. apply changes
mcp2skill update-skill --skill ~/.claude/skills/my-server --confirm

list-tools

List available tools from an MCP server.

mcp2skill list-tools [flags]

Flags

Flag	Short	Description
--server	-s	MCP server name from config (required)
--config		Path to config file

Example

mcp2skill list-tools --server my-server

Output:

Found 3 tool(s):

**fetch**: Fetch content from a URL
**search**: Search the web

call-tool

Call a tool from an MCP server directly.

mcp2skill call-tool [flags]

Flags

Flag	Short	Description
--server	-s	MCP server name from config (required)
--tool	-t	Tool name to call (required)
--args	-a	Tool arguments as JSON string
--dry-run		Show what would be called without executing
--config		Path to config file

Example

mcp2skill call-tool --server my-server --tool fetch --args '{"url": "https://example.com"}'

# Dry run to preview
mcp2skill call-tool --server my-server --tool fetch --dry-run

Global Flags

Flag	Description
--config	Path to config file (overrides default lookup)
--verbose	Enable verbose output
--help, -h	Show help
--version, -v	Print the version