Skillbase/spm

npm for AI skills. Create, share, and discover reusable AI instructions for any model via MCP.

Skillbase (spm)

npm version license downloads

AI skills manager — install, publish, and deploy reusable prompts, personas, and MCP tools across 14 AI clients.

Think npm for AI capabilities: versioned packages of prompts, instructions, and tools that any LLM can use.

npm install -g @skillbase/spm

Why Skillbase?

  • One command to connectspm connect claude wires up MCP for Claude, Cursor, VS Code, Zed, and 10 more clients
  • Portable skills — write once, use everywhere. Skills are model-agnostic packages with semver, dependencies, and a registry
  • Personas — define AI agent personalities with traits, model settings, and skill dependencies in a single .person.json
  • Deploy targets — export and deploy personas to external platforms (OpenClaw, more coming)
  • Built-in MCP server — skills auto-load into your AI client via Model Context Protocol

Supported AI Clients

ClientConnect command
Claude Desktopspm connect claude
Claude Codespm connect claude-code
Cursorspm connect cursor
VS Code (Copilot)spm connect vscode
Windsurfspm connect windsurf
Zedspm connect zed
JetBrains IDEsspm connect jetbrains
Clinespm connect cline
Roo Codespm connect roo-code
Continuespm connect continue
Amazon Q Developerspm connect amazonq
Gemini CLIspm connect gemini
OpenCodespm connect opencode
OpenClawspm connect openclaw

Quick Start

# Initialize skills directory
spm init

# Search for skills
spm search "code review"

# Install a skill
spm add author/skill-name

# Connect to your AI client
spm connect claude

What is a Skill?

A skill is a portable, versioned package containing prompts, tools, or instructions that any AI model can use.

my-skill/
├── skill.json    # Manifest (name, version, triggers, dependencies)
└── SKILL.md      # Main prompt / instructions

Personas

Define AI agent personalities with character traits, model settings, and skill dependencies:

# Create a persona
spm persona create my-agent

# Activate (auto-installs missing skills)
spm persona activate my-agent

# Export to external platform
spm persona export my-agent -f openclaw

# Deploy
spm persona deploy my-agent -t openclaw

Commands

Manage Skills

CommandDescription
spm add <ref>Install a skill
spm installInstall all dependencies from skill.json
spm remove <ref>Remove a skill
spm create <name>Scaffold a new skill
spm link <path>Symlink a local skill for development
spm convert <file>Convert .md/.txt prompts into skills
spm listList installed skills
spm info <name>Show skill details
spm validateValidate a skill directory

Personas

CommandDescription
spm persona createCreate a new persona
spm persona listList installed personas
spm persona activateActivate persona (auto-installs skills)
spm persona deactivateDeactivate current persona
spm persona exportExport to target platform format
spm persona deployDeploy to target platform
spm persona importImport from external platform

Registry

CommandDescription
spm search <query>Search local and remote registries
spm publish <path>Publish to registry
spm update <path>Update a published skill
spm loginAuthenticate (GitHub OAuth)
spm rate <name>Rate a skill (1-5)
spm registry add <url>Add a remote registry

System

CommandDescription
spm connect <client>Connect MCP server to AI client
spm disconnect <client>Disconnect from AI client
spm serveStart MCP server (stdio)
spm initInitialize skills directory
spm reindexRebuild skill index

MCP Server

Skillbase includes a built-in Model Context Protocol server that exposes installed skills as tools to any MCP-compatible AI client:

spm serve --stdio

MCP tools provided: skill_list, skill_load, skill_search, skill_context, skill_feedback, skill_install, persona_list, persona_load

Registries

Skills can be published to self-hosted registries or installed directly from GitHub:

# Install from registry
spm add author/skill-name

# Install from GitHub
spm add github:author/repo

# Add a custom registry
spm registry add https://registry.example.com

# Publish
spm publish ./my-skill

Requirements

  • Node.js >= 20.0.0

License

MIT

Related Servers