skillify

Pack MCP (Model Context Protocol) servers into Agent Skills.

[!NOTE] MCP servers can change their APIs freely because clients (LLMs) get the latest spec at runtime. Skillify breaks this model. It creates a snapshot of the server's API at generation time. This snapshot may not work with newer server versions.

Maybe a future version will support a flag for dynamic.

Installation

bun install

Usage

List tools from an MCP server

# stdio (spawn command)
skillify list "npx -y @modelcontextprotocol/server-memory"

# SSE (URL)
skillify list http://localhost:3000/sse

Pack into a skill

# Interactive selection
skillify pack "npx -y @modelcontextprotocol/server-memory"

# Include all tools
skillify pack "node ./my-server.js" --all --name my-skill

# Custom description
skillify pack "..." --description "Custom skill description here"

# Custom message
skillify pack "..." --message "This message appears after the title"

# Filter tools
skillify pack "..." --include tool1,tool2
skillify pack "..." --exclude tool3,tool4

Options

Option	Description
-o, --output <dir>	Parent output directory; skill is placed in <dir>/<skill-name> (default: .)
-n, --name <name>	Skill name (default: MCP server name or mcp-skill)
-d, --description <desc>	Custom skill description
-m, --message <msg>	Custom message after title in SKILL.md
--include <tools>	Comma-separated tools to include
--exclude <tools>	Comma-separated tools to exclude
--all	Include all tools without prompting
--amp	Generate Amp-native skill with mcp.json
--pin-tools	Force includeTools in mcp.json (requires --amp --all)

Output Format

Standard Mode (default)

Generates an Agent Skills compliant directory:

my-skill/
├── SKILL.md
├── references/tools/
│   ├── tool-one.md
│   └── tool-two.md
└── scripts/
    ├── call-tool.js
    └── mcp-client.js

Amp Mode (--amp)

Generates an Amp-compatible skill with embedded MCP configuration:

skillify pack "npx -y @modelcontextprotocol/server-memory" --amp --name memory --all

my-skill/
├── SKILL.md
└── mcp.json

The mcp.json file specifies the MCP server command and optionally pins tools with includeTools.