SkillDB

See SkillDB in Action

Search, get exactly the skill you need, and your agent reads it instantly. Watch the full workflow from install to zero-latency skill loading.

1
2
3
4
5
6
7
Terminal — skilldb

Click play to watch the SkillDB setup flow

Breakdown

What just happened?

Three key things happen when you run the setup flow.

Local Cache

Skills downloaded to .skilldb/skills/ — your agent reads them from disk at zero latency. No API calls at runtime.

IDE Detection

skilldb init auto-detects Claude Code, Cursor, or Codex CLI and writes the integration config for you.

Idempotent & Offline

Run skilldb get or skilldb add again — they skip cached skills. Once downloaded, skills work fully offline.

Workflows

Try different workflows

SkillDB fits into any workflow. Browse categories, inspect skills, or integrate programmatically.

Get a single skill
$ skilldb search react hooks
Found 5 skills for "react hooks":
custom-hooks               react-patterns-skills
react-state-management     software-skills
react-testing              software-skills
$ skilldb get react-patterns-skills/custom-hooks
Saved Custom Hooks -> .skilldb/skills/react-patterns-skills/custom-hooks.md
Download a full pack
$ skilldb list --category "Technology & Engineering"
Found 8 packs:
PACK                    SKILLS  DESCRIPTION
────────────────────────────────────────────────────
Software                17      Code review, debugging...
Mobile App              12      iOS, Android, React Native...
$ skilldb add software-skills
Downloaded 17 skills from software-skills pack
TypeScript SDK
import { createClient } from 'skilldb';
const db = createClient();
const results = await db.search('react hooks');
console.log(results.skills.length); // 5
const skill = await db.get('react-patterns-skills/custom-hooks.md');
console.log(skill.title);   // "Custom Hooks"
console.log(skill.lines);   // 187
Smart profile loading
$ skilldb use auto
Detected: React + TypeScript + PostgreSQL
Activating fullstack profile...
  Loaded 12 skills to .skilldb/active/
  Budget: 2,847 / 5,000 lines (57%)
$ skilldb use security
Activating security profile...
  Loaded 8 skills to .skilldb/active/
  Budget: 1,920 / 5,000 lines (38%)
Slim summaries
$ skilldb slim software-skills/code-review
Generated slim summary
  Full:  203 lines (code-review.md)
  Slim:   28 lines (code-review.slim.md)
  Saved: 86% reduction
$ skilldb slim --all
  Slimmed 12 active skills
  Total: 2,847L -> 384L (87% saved)
Budget management
$ skilldb budget
Active profile: fullstack
Loaded skills (12):
  react-patterns/custom-hooks    142L
  software-skills/code-review    203L
  software-skills/debugging      187L
  ...
Total: 2,847 lines | ~14K tokens
Budget: 5,000 lines (57% used)

MCP Integration

Use SkillDB inside your AI agent

Model Context Protocol (MCP) lets your agent call SkillDB tools directly. One command to install. No manual searching, no copy-pasting. Your agent finds the right skill itself.

1
2
3
4
5
6
7
Terminal — skilldb

Click play to watch the SkillDB setup flow

How MCP Works

Your agent gets superpowers

MCP gives your AI agent direct access to SkillDB's 5,629+ skills through natural language.

One-Command Setup

claude mcp add skilldb — that's it. Works with Claude Code, Cursor, Windsurf, VS Code Copilot, and 30+ MCP-compatible tools.

Natural Language

Just ask your agent to "find a skill for X" and it calls SkillDB automatically. No commands to memorize, no context to manage.

Mid-Session Keys

Paste your API key any time with skilldb_set_key — no restart needed. Free keys get metadata, Pro keys get full content.

MCP Tools

10 tools your agent can call

From searching to creating private skills — everything through natural language.

Claude Code setup
$ claude mcp add skilldb -- npx skilldb-mcp
Added MCP server skilldb
$ claude mcp add skilldb -- npx skilldb-mcp \
    --api-key sk_live_YOUR_KEY
Added MCP server skilldb (with API key)
# Or set key mid-session:
> Use skilldb_set_key with your key
✅ API key configured!
Cursor IDE setup
// .cursor/mcp.json
{
  "mcpServers": {
    "skilldb": {
      "command": "npx",
      "args": [
        "skilldb-mcp",
        "--api-key",
        "sk_live_YOUR_KEY"
      ]
    }
  }
}
// Restart Cursor to load
Search & discover
> Find skills for Kubernetes deployment
● skilldb_search("kubernetes deployment")
1. Kubernetes Orchestration (devops-skills)
   239 lines | ✅ Full content
2. Container Security (security-skills)
   187 lines | ✅ Full content
3. Helm Charts (infrastructure-skills)
   156 lines | ✅ Full content
Auto-recommend by stack
> What skills should I use for this project?
● skilldb_recommend
  technologies: ["python","fastapi","postgresql"]
  role: "backend"
Recommended packs:
- python-skills (12 skills)
- api-design-skills (8 skills)
- database-skills (10 skills)
- software-skills (17 skills)
Private skills
> Create a private skill for our internal API
● skilldb_create_skill
  name: "internal-api-patterns"
  title: "Our Internal API Conventions"
  content: "# Internal API Standards..."
  pack: "personal"
✅ Private skill created!
ID: personal/internal-api-patterns.md
> List my private skills
● skilldb_my_skills → 3 skills found
All 10 MCP tools
Available tools:
skilldb_search     Search 5,629+ skills
skilldb_get        Get full skill content
skilldb_list       Browse packs & categories
skilldb_suggest    Autocomplete skill names
skilldb_recommend  Stack-based suggestions
skilldb_set_key    Configure API key (v0.7+)
skilldb_purge      Clear cached skills
skilldb_my_skills  List private skills
skilldb_create_skill  Create private skill
skilldb_update_skill  Update private skill
17.5 KBPackage size
2Dependencies
...Skills
...Packs

Ready to try it yourself?

Get started in under 5 minutes. Install the CLI, grab some skills, and watch your agent level up.

Get Startednpm i -g skilldb