Log inSubmit server
Skillsmith logo

Skillsmith

Discover, evaluate, install, and manage versioned agent skills through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Skillsmith

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "skillsmith": {
      "command": "npx",
      "args": [
        "-y",
        "@skillsmith/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @skillsmith/mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 8d ago.

Overview

Skillsmith MCP server connects MCP-compatible agents to the Skillsmith registry for discovering, evaluating, installing, and managing agent skills. Its tools support filtered search, recommendations, skill details, installation and removal, validation, and side-by-side comparison. The registry uses team scopes, immutable versions, trust tiers, quarantine status, and deprecation to track shared skills. Reach for it when agents need a consistent way to find and maintain skills across local environments.

Use cases

  • Search a team registry for skills by category and trust tier
  • Install a selected skill into a local agent environment
  • Validate a skill before adding it to a workflow
  • Compare candidate skills side by side
  • Remove skills that are no longer needed

Key features

  • Filtered registry search
  • Contextual skill recommendations
  • Local skill installation and removal
  • Skill structure and quality validation
  • Side-by-side skill comparison
  • Immutable, team-scoped skill versions

Tools43

What Skillsmith lets your agent do. Expand a tool for its parameters.

Self-reported~741 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

11/11 checks healthy over the last 50d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @skillsmith/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars78Stargazers on the source repository.
npm downloads1.7kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed43Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Skillsmith works

What Skillsmith MCP server does

Skillsmith MCP server exposes the Skillsmith registry through the Model Context Protocol. It helps an agent find skills, inspect their metadata and installation instructions, install or remove them locally, and assess alternatives before use.

The registry is organized around team-scoped skills. Each publication creates an immutable version, so updates do not silently replace an installed version. Skills can also carry trust information, be flagged or quarantined pending security review, and be deprecated when they are no longer maintained.

This is suited to teams that publish or reuse agent skills and need visibility into which skills are available, which versions are installed, and whether a skill has been flagged. It also supports individual local use without requiring a team workflow.

How it works

The MCP server runs as a local process configured in an MCP client. After the client starts it, the agent can call Skillsmith MCP server tools to query the registry and manage skills on the machine where the server is running.

Registry data is cached in a local SQLite database at ~/.skillsmith/skills.db. The MCP server, CLI, and VS Code extension share this database. Standard search uses SQLite FTS5 keyword search. Semantic search can be enabled with SKILLSMITH_USE_HNSW=true; it uses local ONNX embeddings and does not make an API call for those embeddings.

Team permissions determine who can publish and manage skills. Team owners and administrators control those actions, while members can search and install. Immutable versions make local drift visible; the README identifies skill_diff and skill_outdated as the mechanisms for checking installed versions and outdated copies, although they are not listed among the MCP tools provided here.

Setup and configuration

Install the MCP package with npx -y @skillsmith/mcp-server, or install it globally with npm install -g @skillsmith/mcp-server and configure the resulting executable directly. Add the command to the MCP client configuration, then restart or reload the client as required.

An API key is optional. Supplying SKILLSMITH_API_KEY provides higher rate limits and usage tracking. The documented login flow installs @skillsmith/cli, runs skillsmith login, and stores the key in the operating system keyring before it is added to the MCP client configuration.

Cursor requires version 2.4 or later and Node 22.22 or later. Its documented setup uses the globally installed executable because Cursor's bundled Node may not resolve the package through npx. Set SKILLSMITH_CLIENT=cursor to route installations to ~/.cursor/skills rather than the default ~/.claude/skills.

Tools and capabilities

  • search filters skills by query, category, trust tier, and minimum score.
  • get_skill returns detailed skill information, including an install command.
  • install_skill installs a selected skill in the local environment.
  • uninstall_skill removes an installed skill.
  • recommend returns contextual skill recommendations.
  • validate checks a skill's structure and quality.
  • compare presents multiple skills for side-by-side comparison.

Together, these operations cover discovery, selection, local installation, cleanup, and basic quality checks. The local cache supports repeated searches without requiring every lookup to fetch the complete registry remotely.

Limitations and notes

An unflagged skill is not necessarily formally approved; it means the skill has not been flagged. Suspicious or flagged skills may be quarantined pending review. Registry access and rate limits vary by account tier, from a free trial and community tier through paid individual, team, and enterprise plans.

The provided MCP tool list does not include publishing, deprecation, drift, or synchronization operations. Keep API keys in client settings or environment configuration rather than sending them in chat.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Skillsmith

Skillsmith is an MCP server that connects MCP-compatible agents to the Skillsmith registry. Its main tools search and recommend skills, retrieve skill details, install and uninstall skills locally, validate structure and quality, and compare multiple skills. It also uses team-scoped, versioned registry data for skill management.

Install it with `npx -y @skillsmith/mcp-server` in your MCP client configuration, then restart or reload the client. You can also install `@skillsmith/mcp-server` globally and configure the resulting executable directly, which is the documented approach for Cursor.

Yes, Skillsmith works with Cursor 2.4 or later. Install the package globally, point Cursor to the `skillsmith-mcp` executable, enable the server in Cursor's MCP settings, and reload the window. Set `SKILLSMITH_CLIENT=cursor` to use `~/.cursor/skills` for installations.

No, an API key is optional. Set `SKILLSMITH_API_KEY` when you want higher rate limits and usage tracking. The documented login flow uses the Skillsmith CLI to generate and store a key before adding it to the MCP client configuration.

Skillsmith stores its registry cache in `~/.skillsmith/skills.db`, a local SQLite database. The MCP server, CLI, and VS Code extension share this database, and default searches use SQLite FTS5 keyword search.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSkillsmith AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/skillsmith?style=directory)](https://allmcps.com/mcp/skillsmith)
HTML Embed
<a href="https://allmcps.com/mcp/skillsmith"><img src="https://allmcps.com/api/badge/skillsmith?style=directory" alt="Skillsmith on AllMCPs" /></a>