SkillDB

io.github.devchad-cmdPublished by GitHub account devchad-cmdv0.8.4-registry.1Updated Nov 3, 2026

Search and load AI agent skills. Free metadata; full content requires a Pro or Studio account.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

SkillDB lets an AI assistant search, preview and load expert agent skills from a catalog of 5,900+ skills, and manage private skills on paid plans.

What you can do
  • Search, preview and list skills and packs in the catalog by keyword, category or pack
  • Load full skill content and get recommendations or suggestions for a project
  • Manage private skills: list your own and shared skills, create and update them (Studio plan, write-scoped key)
  • Set or swap the API key mid-session and purge cached skills
When to use it
Useful when you want your coding assistant to pull curated, task-specific instructions (for example code review, React patterns or security hardening) instead of relying on general knowledge, or when you maintain your own private skill library.
Requirements
Either the hosted endpoint at skilldb.dev (Streamable HTTP, OAuth or API key) or the local npm package run with npx, which needs Node.js 18 or newer. A SkillDB API key is optional for metadata-only search; full skill content needs a Pro or Studio key, and private-skill writes need a Studio key with write scope. The key can come from the SKILLDB_API_KEY environment variable or a .skilldbrc file.
Before you install
The API key is a credential: it is passed on the command line or stored in .skilldbrc files, so keep it out of shared repositories. Full content and private skills require a paid Pro or Studio account. Write-scoped keys allow creating and updating private skills, and purge or remove commands delete cached skills from disk. The anonymous catalog endpoint returns metadata and previews only.

Installation

In SourceWeft

  1. Open SkillDB in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.devchad-cmd%2Fskilldb/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "skilldb": {
      "type": "http",
      "url": "https://skilldb.dev/api/mcp"
    }
  }
}

README

skilldb

CLI, TypeScript SDK, and MCP Server for SkillDB — discover, install, and manage AI agent skills.

5,900+ expert skills across 429 packs for Claude Code, Cursor, Windsurf, VS Code, and any MCP-compatible AI tool.

[Add SkillDB to Cursor] [Install in VS Code] [npm]

Open source for transparency. This is the full source for the skilldb npm package — the CLI and MCP server that run on your machine and handle your API key. It's published to npm via Trusted Publishing (OIDC, with provenance), so the published artifact is verifiably built from this repo. Audit away, and PRs welcome. MIT licensed.

MCP Server

Connect SkillDB directly to your AI coding tool via the Model Context Protocol:

bash
# Step 1 (optional): install globally. You can also skip this — the npx form below works without it.npm install -g skilldb
# Step 2 (optional): Get a Pro or Studio API key for full content at https://skilldb.dev/api-access
# Step 3: Add to Claude Code (omit --api-key for metadata-only access)claude mcp add skilldb -- npx -p skilldb skilldb-mcp --api-key sk_live_YOUR_KEY

Note: skilldb-mcp is a binary inside the skilldb package, not its own npm package — always invoke it as npx -p skilldb skilldb-mcp (not npx skilldb-mcp).

⚠️ Without an API key, you can search and browse skills (metadata only). With a Pro or Studio API key, you get full skill content — the actual markdown instructions your agent uses. Get your key in 30 seconds at skilldb.dev/api-access.

Cursor — add to .cursor/mcp.json:

json
{  "mcpServers": {    "skilldb": {      "command": "npx",      "args": ["-p", "skilldb", "skilldb-mcp"]    }  }}

Windsurf — add to mcp_config.json:

json
{  "mcpServers": {    "skilldb": {      "command": "npx",      "args": ["-p", "skilldb", "skilldb-mcp", "--api-key", "sk_live_xxx"]    }  }}

VS Code — one-liner:

bash
code --add-mcp '{"name":"skilldb","command":"npx","args":["-p","skilldb","skilldb-mcp"]}'

Or add the same server block to .vscode/mcp.json (workspace) / user mcp.json under "servers".

Once connected, your AI assistant can search and load skills natively. Just ask:

  • "Search SkillDB for React performance patterns"
  • "Load the code review skill"
  • "What skills should I use for this project?"
  • "Save this as a private skill" (Studio plan — see below)

10 tools exposed: skilldb_search, skilldb_get, skilldb_list, skilldb_suggest, skilldb_recommend, skilldb_purge, skilldb_set_key (set/swap your API key mid-session, no restart), and the private-skill tools skilldb_my_skills, skilldb_create_skill, skilldb_update_skill (Studio plan + write-scoped key).

Hosted MCP endpoints

  • Authenticated integration: https://skilldb.dev/api/mcp uses Streamable HTTP with OAuth or a SkillDB API key. Full skill content requires a Pro or Studio account.
  • Anonymous SkillDB Catalog: https://skilldb.dev/api/mcp/catalog uses Streamable HTTP without a SkillDB account. Its two tools, skilldb_search and skilldb_get_preview, return public metadata and short previews only. It does not retrieve full skill content, install or execute skills, link accounts, or access private/team libraries.

Quick Start (CLI)

bash
# Search for skills (with inline preview)npx skilldb search "code review"
# Install a skill packnpx skilldb add software-skills
# Activate a smart profile (only loads what you need)npx skilldb use frontend
# Or auto-detect from your projectnpx skilldb use auto

Install

bash
npm install -g skilldb

Or use npx skilldb without installing.

The Memory Problem (And How We Solve It)

Loading 500 skills into your agent's context is worse than loading the right 5. SkillDB uses a 3-layer architecture to manage this:

.skilldb/├── skills/          ← Full cache (everything downloaded)├── active/          ← Active profile (what your agent sees — 5-15 focused skills)├── slim/            ← Compressed cheat sheets (10x smaller)├── config.json      ← Profile + budget settings└── manifest.json    ← What's installed

Your CLAUDE.md or .cursorrules points at .skilldb/active/, not the full cache. The agent gets focused, relevant skills — not noise.

CLI Commands

Core

skilldb init

Detect your IDE (Claude Code, Cursor, Codex CLI, OpenClaw), create .skilldb/, and add integration config.

bash
skilldb init
skilldb search <query>

Search skills by keyword. Shows inline slim preview so you know what you're getting before downloading.

bash
skilldb search "debugging"skilldb search "api design" --category "Technology & Engineering"skilldb search "testing" --limit 10
skilldb add <pack>

Download a skill pack to local cache. Idempotent — skips already-cached skills.

bash
skilldb add software-skillsskilldb add autonomous-agent-skillsskilldb add vibe-coding-security-skills
skilldb get <id>

Download a single skill.

bash
skilldb get software-skills/code-review
skilldb info <id>

Show metadata, slim summary, and full preview for a skill.

bash
skilldb info software-skills/code-review
skilldb list

List available categories, packs, and skills.

bash
skilldb listskilldb list --category "Autonomous Agents"skilldb list --pack software-skills
skilldb login

Prompts for your API key and saves it to ~/.skilldbrc (user-wide) so every project picks it up via the resolution chain in Authentication. The recommended alternative to setting SKILLDB_API_KEY by hand.

bash
skilldb login

Smart Loading

skilldb use <profile>

Activate a focused profile — only loads relevant skills into .skilldb/active/.

bash
skilldb use frontend          # React, testing, web-polish, accessibilityskilldb use backend           # API design, databases, security, performanceskilldb use devops            # Kubernetes, Docker, CI/CD, monitoringskilldb use security          # Trust audit, input validation, credentialsskilldb use data              # SQL, pipelines, analytics, visualizationskilldb use fullstack         # Frontend + backend combinedskilldb use mobile            # Mobile / React Native / app developmentskilldb use ai-agent          # Autonomous agent meta-skillsskilldb use auto              # Auto-detect from your project filesskilldb use --list            # Show available profilesskilldb use --current         # Show active profileskilldb use none              # Deactivate (clear active/)

auto mode scans your package.json, file extensions, and imports to recommend the right profile.

skilldb budget

Set a maximum context budget so your agent doesn't get overloaded.

bash
skilldb budget                # Show current usageskilldb budget set 5000       # Max 5,000 linesskilldb budget set 50k        # Max 50,000 tokensskilldb budget optimize       # Re-rank and trim active skills to fit
skilldb slim

Generate compressed cheat-sheet versions of skills (~30 lines instead of 300).

bash
skilldb slim                  # Slim all active skillsskilldb slim software-skills  # Slim a specific packskilldb slim --ratio 0.3      # Keep 30% of content

Management

skilldb update

Check for newer versions of installed skills and update them.

bash
skilldb update                # Update everythingskilldb update software-skills  # Update one pack
skilldb remove

Uninstall skills from local cache.

bash
skilldb remove software-skills/code-review    # Remove single skillskilldb remove software-skills                # Remove entire packskilldb remove --unused                       # Remove skills not in active profile
skilldb doctor

Health check and audit of your skill setup.

bash
skilldb doctor

Shows: outdated skills, unused skills, missing dependencies, budget status, coverage gaps.

skilldb stats

Local statistics dashboard.

bash
skilldb stats

Shows: installed count, total lines, tokens, active profile, categories covered.

skilldb diff <id>

Compare your local (possibly customized) version with the latest remote.

bash
skilldb diff software-skills/code-reviewskilldb diff                  # Diff all installed
skilldb purge

Remove cached skills to free disk space.

bash
skilldb purge --inactive      # Remove skills not in the active profileskilldb purge --all           # Remove ALL cached skills (including active)skilldb purge --slim          # Also drop slim summariesskilldb purge --dry-run       # Preview what would be removed, delete nothing

Private Skills (Studio)

Create skills that only you (and people you share them with) can read. They surface in your own search results when you're authenticated. Creating/editing requires the Studio plan and an API key with write scope — mint one at skilldb.dev/account#api-keys.

skilldb push <file.md>

Create (or update) a private skill from a local Markdown file. The skill name defaults to the filename; the title resolves as --title flag → first Markdown # H1 → filename.

bash
skilldb push ./my-react-patterns.md                    # create (pack defaults to "personal")skilldb push ./my-react-patterns.md -p team --tags react,perfskilldb push ./my-react-patterns.md --update           # update the skill with the same name/pack

Options: -p, --pack, -n, --name, -t, --title, -d, --description, --tags <comma,list>, -u, --update.

skilldb my-skills

List your private skills (ones you own plus skills shared with you).

bash
skilldb my-skills

You can also do all of this from your agent via the MCP tools skilldb_create_skill / skilldb_update_skill / skilldb_my_skills.

Sharing & Export

skilldb export

Export your setup for sharing or IDE integration.

bash
skilldb export claude         # CLAUDE.md snippet with skill referencesskilldb export cursor         # .cursorrules blockskilldb export profile        # Shareable .skilldb-profile.jsonskilldb export inject <id>    # Print skill to stdout (for piping)
skilldb recommend

Scan your project and get personalized skill recommendations.

bash
skilldb recommend             # Analyze project and suggestskilldb recommend --install   # Auto-install recommendations

SDK Usage

typescript
import { createClient } from 'skilldb';
const db = createClient(); // auto-loads key from env/config
// Search with slim previewsconst results = await db.search('code review');for (const skill of results.skills) {  console.log(skill.title);  console.log(skill.slim); // Quick summary}
// Get full skill content (requires a configured Pro or Studio API key)const skill = await db.get('software-skills/code-review.md');console.log(skill.content);
// List with filtersconst listing = await db.list({ category: 'Autonomous Agents', limit: 10 });

Authentication

The SDK and CLI resolve your API key in order:

  1. SKILLDB_API_KEY environment variable (CI-friendly)
  2. .skilldbrc in project root (project-specific)
  3. ~/.skilldbrc in home directory (user-wide)

Access tiers:

  • No key — browse and search (metadata only).
  • Pro or Studio key — full skill content (the actual markdown instructions).
  • Studio key with write scope — private skills (skilldb push / my-skills, and the create/update MCP tools). Read-only keys are rejected with a write-scope error. Create a write-scoped key at skilldb.dev/account#api-keys.

Profiles

Built-in profiles map to curated skill sets:

ProfileSkills loadedBest for
frontendreact-patterns, web-polish, testing, accessibilityReact/Vue/Angular apps
backendapi-design, databases, security, performanceNode/Python/Go services
devopskubernetes, docker, ci-cd, monitoring, cloudInfrastructure & deployment
securitytrust-audit, input-validation, credentials, hardeningSecurity review & hardening
datasql, pipelines, analytics, visualizationData engineering & analysis
fullstackfrontend + backend combinedFull-stack applications
mobilemobile patterns, app architecture, UIMobile / React Native apps
ai-agentautonomous-agent-skills, task-decomposition, planningBuilding AI agents
autoDetected from projectAny project

Requirements

  • Node.js >= 18

License

MIT

Source: README.md at commit a4459e4

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v0.8.4-registry.1LatestOct 6, 2026
  2. v0.8.3Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts