SkillDB

skilldb

SkillDB の CLI、TypeScript SDK、MCP サーバーです。AI エージェント向けスキルを検索、インストール、管理できます。

Claude Code、Cursor、Windsurf、VS Code、およびあらゆる MCP 対応 AI ツール向けに、429 パックに収録された 5,900 以上の専門スキルを提供します。

透明性のためのオープンソースです。 これは skilldb npm パッケージの全ソースコードです。お使いのマシン上で動作し、API キーを扱う CLI と MCP サーバーが含まれています。Trusted Publishing（OIDC、プロビナンス付き）を通じて npm に公開しているため、公開された成果物がこのリポジトリからビルドされたことを検証できます。ぜひ監査してください。PR も歓迎します。MIT ライセンスです。

MCP サーバー

Model Context Protocol を使って SkillDB を AI コーディングツールに直接接続します。

# 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

注： skilldb-mcp は skilldb パッケージ内のバイナリであり、独立した npm パッケージではありません。必ず npx -p skilldb skilldb-mcp として実行してください（npx skilldb-mcp ではありません）。

⚠️ API キーがない場合、スキルの検索と閲覧（メタデータのみ）ができます。 Pro または Studio の API キーがある場合、エージェントが使用する実際の Markdown 指示を含む、スキルの全コンテンツを利用できます。 skilldb.dev/api-access から 30 秒でキーを取得できます。

Cursor — .cursor/mcp.json に追加します：

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

Windsurf — mcp_config.json に追加します：

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

VS Code — 1 行で設定できます：

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

または、同じサーバーブロックを .vscode/mcp.json（ワークスペース）またはユーザーの mcp.json の "servers" の下に追加します。

接続すると、AI アシスタントからスキルをネイティブに検索して読み込めるようになります。次のように尋ねるだけです：

• 「SkillDB で React のパフォーマンスパターンを検索して」
• 「コードレビューのスキルを読み込んで」
• 「このプロジェクトではどのスキルを使うべき？」
• 「これをプライベートスキルとして保存して」（Studio プラン。詳細は以下を参照）

公開されるツールは 10 個です： skilldb_search、skilldb_get、skilldb_list、skilldb_suggest、skilldb_recommend、skilldb_purge、skilldb_set_key（セッション中に API キーを設定／切り替えます。再起動は不要）。さらに、プライベートスキル用のツール skilldb_my_skills、skilldb_create_skill、skilldb_update_skill（Studio プランと書き込みスコープのキーが必要）も利用できます。

ホスト型 MCP エンドポイント

• 認証済みインテグレーション： https://skilldb.dev/api/mcp は、OAuth または SkillDB API キーを使用する Streamable HTTP を利用します。スキルの全コンテンツを利用するには、Pro または Studio アカウントが必要です。
• 匿名 SkillDB カタログ： https://skilldb.dev/api/mcp/catalog は、SkillDB アカウントなしで Streamable HTTP を利用します。2 つのツール skilldb_search と skilldb_get_preview は、公開メタデータと短いプレビューのみを返します。スキルの全コンテンツの取得、スキルのインストールや実行、アカウントの連携、プライベートライブラリやチームライブラリへのアクセスは行いません。

クイックスタート（CLI）

# Search for skills (with inline preview)
npx skilldb search "code review"

# Install a skill pack
npx skilldb add software-skills

# Activate a smart profile (only loads what you need)
npx skilldb use frontend

# Or auto-detect from your project
npx skilldb use auto

インストール

npm install -g skilldb

または、インストールせずに npx skilldb を使用します。

メモリの問題（そしてその解決方法）

エージェントのコンテキストに 500 個のスキルを読み込むより、適切な 5 個を読み込むほうが効果的です。SkillDB では、これを管理するために3 層アーキテクチャを採用しています。

.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

CLAUDE.md または .cursorrules では、キャッシュ全体ではなく .skilldb/active/ を参照します。エージェントには、ノイズではなく、絞り込まれた関連性の高いスキルが提供されます。

CLI コマンド

基本

skilldb init

IDE（Claude Code、Cursor、Codex CLI、OpenClaw）を検出し、.skilldb/ を作成して、インテグレーション設定を追加します。

skilldb init

skilldb search <query>

キーワードでスキルを検索します。ダウンロード前に内容を確認できるよう、簡易プレビューをインラインで表示します。

skilldb search "debugging"
skilldb search "api design" --category "Technology & Engineering"
skilldb search "testing" --limit 10

skilldb add <pack>

スキルパックをローカルキャッシュにダウンロードします。冪等性があり、すでにキャッシュされているスキルはスキップします。

skilldb add software-skills
skilldb add autonomous-agent-skills
skilldb add vibe-coding-security-skills

skilldb get <id>

単一のスキルをダウンロードします。

skilldb get software-skills/code-review

skilldb info <id>

スキルのメタデータ、簡潔な概要、全体のプレビューを表示します。

skilldb info software-skills/code-review

skilldb list

利用可能なカテゴリ、パック、スキルを一覧表示します。

skilldb list
skilldb list --category "Autonomous Agents"
skilldb list --pack software-skills

skilldb login

API キーの入力を求め、~/.skilldbrc（ユーザー全体で使用）に保存します。これにより、認証に記載された解決順序を通じて、すべてのプロジェクトでキーを使用できます。SKILLDB_API_KEY を手動で設定するよりも、この方法を推奨します。

skilldb login

スマート読み込み

skilldb use <profile>

用途に合わせたプロファイルを有効化します。関連するスキルのみを .skilldb/active/ に読み込みます。

skilldb use frontend          # React, testing, web-polish, accessibility
skilldb use backend           # API design, databases, security, performance
skilldb use devops            # Kubernetes, Docker, CI/CD, monitoring
skilldb use security          # Trust audit, input validation, credentials
skilldb use data              # SQL, pipelines, analytics, visualization
skilldb use fullstack         # Frontend + backend combined
skilldb use mobile            # Mobile / React Native / app development
skilldb use ai-agent          # Autonomous agent meta-skills
skilldb use auto              # Auto-detect from your project files
skilldb use --list            # Show available profiles
skilldb use --current         # Show active profile
skilldb use none              # Deactivate (clear active/)

auto モードでは、package.json、ファイル拡張子、インポートをスキャンし、適切なプロファイルを推奨します。

skilldb budget

エージェントが過剰な情報を抱えないよう、コンテキストの最大予算を設定します。

skilldb budget                # Show current usage
skilldb budget set 5000       # Max 5,000 lines
skilldb budget set 50k        # Max 50,000 tokens
skilldb budget optimize       # Re-rank and trim active skills to fit

skilldb slim

スキルの圧縮版チートシート（300 行ではなく約 30 行）を生成します。

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

管理

skilldb update

インストール済みスキルの新しいバージョンを確認し、更新します。

skilldb update                # Update everything
skilldb update software-skills  # Update one pack

skilldb remove

ローカルキャッシュからスキルをアンインストールします。

skilldb remove software-skills/code-review    # Remove single skill
skilldb remove software-skills                # Remove entire pack
skilldb remove --unused                       # Remove skills not in active profile

skilldb doctor

スキル設定のヘルスチェックと監査を行います。

skilldb doctor

次の項目を表示します：古いスキル、未使用のスキル、不足している依存関係、予算の状態、カバレッジの不足。

skilldb stats

ローカル統計ダッシュボードを表示します。

skilldb stats

次の項目を表示します：インストール数、合計行数、トークン数、アクティブなプロファイル、カバーされているカテゴリ。

skilldb diff <id>

ローカル版（カスタマイズされている場合もあります）と最新のリモート版を比較します。

skilldb diff software-skills/code-review
skilldb diff                  # Diff all installed

skilldb purge

ディスク容量を確保するため、キャッシュされたスキルを削除します。

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

プライベートスキル（Studio）

あなた（および共有相手）のみが読めるスキルを作成できます。認証済みの場合、自分の検索結果に表示されます。作成・編集には Studio プランと、write スコープを持つ API キーが必要です。skilldb.dev/account#api-keys で作成してください。

skilldb push <file.md>

ローカルの Markdown ファイルからプライベートスキルを作成（または更新）します。スキル名はデフォルトでファイル名になります。タイトルは --title フラグ → 最初の Markdown # H1 → ファイル名の順に決定されます。

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

オプション：-p, --pack、-n, --name、-t, --title、-d, --description、--tags <comma,list>、-u, --update。

skilldb my-skills

自分のプライベートスキル（所有しているスキルと共有されたスキル）を一覧表示します。

skilldb my-skills

MCP ツール skilldb_create_skill / skilldb_update_skill / skilldb_my_skills を使って、エージェントからこれらすべての操作を行うこともできます。

共有とエクスポート

skilldb export

共有または IDE 連携のために設定をエクスポートします。

skilldb export claude         # CLAUDE.md snippet with skill references
skilldb export cursor         # .cursorrules block
skilldb export profile        # Shareable .skilldb-profile.json
skilldb export inject <id>    # Print skill to stdout (for piping)

skilldb recommend

プロジェクトをスキャンし、パーソナライズされたスキルの推奨を取得します。

skilldb recommend             # Analyze project and suggest
skilldb recommend --install   # Auto-install recommendations

SDK の使用方法

import { createClient } from 'skilldb';

const db = createClient(); // auto-loads key from env/config

// Search with slim previews
const 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 filters
const listing = await db.list({ category: 'Autonomous Agents', limit: 10 });

認証

SDK と CLI は、次の順序で API キーを解決します。

1. SKILLDB_API_KEY 環境変数（CI に適しています）
2. プロジェクトルートの .skilldbrc（プロジェクト固有）
3. ホームディレクトリの ~/.skilldbrc（ユーザー全体で使用）

アクセス階層：

• キーなし — 閲覧と検索（メタデータのみ）。
• Pro または Studio のキー — スキルの全コンテンツ（実際の Markdown 指示）。
• write スコープを持つ Studio キー — プライベートスキル（skilldb push / my-skills、および create / update MCP ツール）。読み取り専用キーは、write スコープエラーで拒否されます。skilldb.dev/account#api-keys で write スコープ付きキーを作成してください。

プロファイル

組み込みプロファイルは、厳選されたスキルセットに対応しています。

プロファイル	読み込まれるスキル	最適な用途
frontend	react-patterns, web-polish, testing, accessibility	React/Vue/Angular アプリ
backend	api-design, databases, security, performance	Node/Python/Go サービス
devops	kubernetes, docker, ci-cd, monitoring, cloud	インフラストラクチャとデプロイ
security	trust-audit, input-validation, credentials, hardening	セキュリティレビューと強化
data	sql, pipelines, analytics, visualization	データエンジニアリングと分析
fullstack	frontend + backend combined	フルスタックアプリケーション
mobile	mobile patterns, app architecture, UI	モバイル / React Native アプリ
ai-agent	autonomous-agent-skills, task-decomposition, planning	AI エージェントの構築
auto	プロジェクトから検出	あらゆるプロジェクト

要件

• Node.js >= 18

ライセンス

MIT