@skilt/tools

CLI for querying any skills MCP server — search, grep, catalog, graph, read.

Install & Run

# Via npx (zero install)
npx @skilt/tools search "react hooks"

# Via uvx (Python)
uvx skilt-tools search "react hooks"

# Install globally
pip install skilt-tools
skilt search "react hooks"

Server Configuration

The CLI needs to know which MCP server to query. Set it once:

# Option 1: Environment variable (recommended)
export SKILT_SERVER=https://your-skills-server.com/mcp

# Option 2: Per-command flag
skilt --server https://your-skills-server.com/mcp search "query"

If neither is set, falls back to https://skills.cfapps.eu12.hana.ondemand.com/mcp.

Commands

search — Find skills by keyword

BM25-ranked search across skill names and descriptions.

skilt search "react hooks"
skilt search "database migration"
skilt search "deploy kubernetes"

grep — Search file contents

Regex search across all skill files (like ripgrep for skills).

skilt grep "useState"
skilt grep "@tool"
skilt grep "class.*Provider"

catalog — List all skills

skilt catalog

read — Read a skill

# Read the main SKILL.md
skilt read pdf-processing

# Read a specific file from a skill
skilt read pdf-processing templates/extractor.py

graph — Dependency graph

Shows which skills reference other skills (JSON output).

skilt graph
skilt graph | jq '.edges[] | select(.from == "pdf-processing")'

refresh — Reload skills

Tells the server to pull latest from its git source.

skilt refresh

Works with any SkillsDirectoryProvider server

This CLI works with any MCP server that uses FastMCP's SkillsDirectoryProvider. Set up your own:

from fastmcp import FastMCP
from fastmcp.server.providers.skills import SkillsDirectoryProvider

mcp = FastMCP("my-skills")
mcp.add_provider(SkillsDirectoryProvider(roots="./skills"))
mcp.run()

Then point the CLI at it:

export SKILT_SERVER=http://localhost:8000/mcp
skilt catalog