Skillsmith

Skillsmith

共有スキルを、本番環境でも安全に。

複数のチームがエージェントスキルを公開するようになると、問題はスキルを見つけることから、管理することへと変わります。これはどのチームを対象にしていますか？ どのバージョンがどこにインストールされていますか？ セキュリティスキャンでフラグが付けられていますか？ 誰も保守しなくなったスキルはどうなりますか？

Skillsmith は、チーム間でエージェントスキルを共有、スキャン、追跡するためのレジストリです。スキルはチームごとのレジストリに公開され、変更されないバージョンで管理されるため、インストール間の差異を気付かないままにせず、確認できます。フラグが付けられたスキルや疑わしいスキルは、セキュリティレビューが行われるまで隔離されます。古くなったスキルは、誰かのリポジトリでひっそりと放置されるのではなく、非推奨にできます。

インストール

クイックセットアップ（MCP）

Skillsmith は MCP 互換です。エージェントに合ったスニペットを選んでください。 SMI-4580: スニペットは packages/cli/src/templates/mcp-server.template.snippets.ts から取得しているため、この README とウェブサイトのドキュメントに差異が生じることはありません。

{
  "mcpServers": {
    "@skillsmith/mcp-server": {
      "command": "npx",
      "args": ["-y", "@skillsmith/mcp-server"],
      "env": {
        "SKILLSMITH_API_KEY": "sk_live_..."
      }
    }
  }
}

{
  "mcpServers": {
    "@skillsmith/mcp-server": {
      "command": "<paste output of: which skillsmith-mcp (macOS/Linux) or where skillsmith-mcp (Windows)>",
      "env": {
        "SKILLSMITH_API_KEY": "sk_live_...",
        "SKILLSMITH_CLIENT": "cursor"
      }
    }
  }
}

{
  "mcpServers": {
    "@skillsmith/mcp-server": {
      "command": "npx",
      "args": ["-y", "@skillsmith/mcp-server"],
      "env": {
        "SKILLSMITH_API_KEY": "sk_live_..."
      }
    }
  }
}

{
  "mcpServers": {
    "@skillsmith/mcp-server": {
      "command": "npx",
      "args": ["-y", "@skillsmith/mcp-server"],
      "env": {
        "SKILLSMITH_API_KEY": "${env:SKILLSMITH_API_KEY}"
      }
    }
  }
}

[mcp_servers.@skillsmith/mcp-server]
command = "npx"
args = ["-y", "@skillsmith/mcp-server"]

[mcp_servers.@skillsmith/mcp-server.env]
SKILLSMITH_API_KEY = "sk_live_..."

{
  "mcpServers": {
    "@skillsmith/mcp-server": {
      "command": "npx",
      "args": ["-y", "@skillsmith/mcp-server"],
      "env": {
        "SKILLSMITH_API_KEY": "sk_live_..."
      }
    }
  }
}

MCP クライアントの設定に追加して再起動すれば、すぐにスキルを検索できます。

API キーの設定（任意）

レート制限の緩和と使用状況の追跡のため、API キーで認証できます。

最も簡単な方法 — CLI ログイン（対話形式）：

npm install -g @skillsmith/cli
skillsmith login

ブラウザーで skillsmith.app/account/cli-token が開きます。キーを生成してコピーし、プロンプトが表示されたら貼り付けます。キーは OS のキーチェーンに安全に保存されます。

MCP サーバーの設定 — キーを設定に追加します：

上記のクライアント別スニペットには、すでに env.SKILLSMITH_API_KEY の欄が含まれています。sk_live_... のプレースホルダーを skillsmith login で取得した値に置き換えてください。

API キーは skillsmith.app/account/cli-token で取得できます。

クォータに関する注意： 月間の数値は、適用される場合にのみ厳格な上限となります。エッジ関数で月間クォータによるブロックが行われるのは Community のみで、ENFORCE_COMMUNITY_QUOTA が 'true' の場合に限られます。MCP サーバー独自の月間クォータの対象は skill_suggest とティアによって制限されるツールのみで、デフォルトではそれらを厳格にブロックします（SKILLSMITH_ENFORCE_MCP_QUOTA=false にすると無効になります）。

キーが設定されていない場合、MCP サーバーは組み込みの公開キーにフォールバックします。そのため、キーなしの MCP 利用は Community レートとなり、他のすべてのキーなしクライアントと、エッジエンドポイント（search、get、recommend など）ごとの 30 回／分の枠を共有します。10 回の試用枠（IP あたり 100 回／分）は、認証に成功しない直接 HTTP リクエストに適用されます。これには、不正な形式または期限切れの認証情報を含むリクエストも含まれます。通常のキーなし MCP リクエストは組み込みキーで認証されるため、この枠の対象にはなりません。有効にした場合、共有キーには IP あたりの日次予算も適用されることがあります（ENFORCE_ANON_BUDGET。デフォルトでは無効）。

注： API キーをチャットに貼り付けないでください。必ず settings.json から設定してください。

CLI のインストール（開発用）

CLI はローカル開発で利用できます。

# From the repository root
npm run build
node packages/cli/dist/index.js search "testing"

重要な 4 つの質問

複数のチームがスキルを公開するようになると、重要なのは次の質問です。

1. どのチームにスコープされていますか？ レジストリ内のすべてのスキルは、いずれかのチームにスコープされています。
2. ここにインストールされているのはどのバージョンですか？ バージョンは不変です。skill_diff（Individual ティア）と skill_outdated は、実行元のマシンにインストールされているスキルの差分を報告します。
3. セキュリティスキャンでフラグが付けられていますか？ 公開インデックスから取得したスキルは自動的に評価されます。フラグ付きまたは疑わしいスキルは、レビューが完了するまで隔離されます。フラグが付いていないことは、正式に承認されたことを意味するのではなく、フラグが付けられていないことを意味します。各スキルには、Official から Unverified まで 8 段階の信頼ティアがあります（セキュリティガイド）。
4. 誰もメンテナンスしていないスキルはどうなりますか？ 古くなったスキルは、誰かのリポジトリでひっそりと放置されるのではなく、非推奨にできます。

仕組み

• 公開 — スキルはチームにスコープされたレジストリに、不変のバージョンとして公開されます。
• バージョン管理 — 公開するたびに新しい不変のバージョンが作成されます。既存のバージョンがその場で上書きされることはありません。
• 差分の検出 — skill_diff（Individual ティア）と skill_outdated により、確認時点でインストールされている内容と、どこに遅れがあるかを把握できます。
• 非推奨化 — 古くなったスキルは、誰かのリポジトリでひっそりと放置されるのではなく、非推奨にできます。

スコープと権限

スキルはチームのレジストリにスコープされます。チームのオーナーと管理者は、スキルを公開・管理できるユーザーを制御します。メンバーはスキルをインストールして検索できます。

まずは個人で始める

自分用のスキルを無料で検索、インストール、管理できます。チームで同じスキルが必要になったときには、すでにレジストリが用意されています。

MCP ツール

Skillsmith には43個のツールが登録されています。43個のうち19個は、無料のCommunityティアで利用できます。上位ティアでは、バージョン追跡、チーム機能、エンタープライズ向けの制御機能が追加されます。ご利用のティアを超えるツールを呼び出すと、アップグレードを促すメッセージが返されます。料金。

Community（無料）

Individual

Team

エンタープライズ

セッション開始時の自動名前空間監査は、Team および Enterprise の機能です。上記の監査ツールと名前変更ツールは、どのティアでも手動で実行できます。

設計の基本はローカルファーストです。 Skillsmith はレジストリをローカルの SQLite データベース ~/.skillsmith/skills.db にキャッシュします。このデータベースは MCP サーバー、CLI、VS Code 拡張機能で共有されます。既定では FTS5（SQLite に組み込まれたキーワード検索）を使用します。セマンティック検索はオプトイン（SKILLSMITH_USE_HNSW=true）で、有効にすると、ローカルの ONNX 埋め込み（CPU 上で動作するオープンな ML モデル形式）を使って実行されます。API 呼び出しは発生しません。ローカルスキルデータベースの内部では、スキーマ、FTS5/HNSW の検索方法、キャッシュを最新の状態に保つ sync（Team+ ティアの機能）について説明しています。

アーキテクチャ

Skillsmith は Model Context Protocol（MCP）を使用します。

┌─────────────────────────────────────────────────────┐
│  MCP Client (Claude Code, Cursor, etc.)             │
│  ┌─────────────────────────────────────────────────┐│
│  │  Skillsmith MCP Server                          ││
│  │  └── @skillsmith/mcp-server                     ││
│  │      ├── search, get_skill, skill_compare       ││
│  │      ├── install_skill, uninstall_skill         ││
│  │      ├── skill_recommend, skill_validate        ││
│  │      ├── skill_outdated, skill_diff, ...        ││
│  │      └── 43 tools across four tiers             ││
│  └─────────────────────────────────────────────────┘│
│                          │                          │
│                          ▼                          │
│  ┌─────────────────────────────────────────────────┐│
│  │  ~/.skillsmith/skills.db (SQLite + FTS5)        ││
│  │  ~/.claude/skills/ (installed skills)           ││
│  └─────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────┘

使用方法

設定が完了すると、MCP クライアントから Skillsmith のツールを使用できます。

"Search for testing skills"
→ Uses search tool to find testing-related skills

"Show me details for community/jest-helper"
→ Uses get_skill tool to retrieve full skill information

"Install the jest-helper skill"
→ Uses install_skill tool to add it to ~/.claude/skills

"Compare jest-helper and vitest-helper"
→ Uses skill_compare tool to show side-by-side comparison

"Are any of my installed skills out of date?"
→ Uses skill_outdated tool to check for staleness and missing dependencies

"Do any of my skills clash with each other?"
→ Uses skill_inventory_audit tool to find name collisions and suggest renames

CLI の使用方法（開発）

# From the repository, after building
node packages/cli/dist/index.js search "testing" --tier verified --min-score 80
node packages/cli/dist/index.js get community/jest-helper
node packages/cli/dist/index.js install community/jest-helper

ドキュメント

• セキュリティガイド - スキルの信頼性、安全性、保護について
• 5 分で始めるセットアップ - クイックスタートガイド
• 設定ガイド - セットアップと使用方法の詳細
• ステータス - Skillsmith の主要サービスの現在のステータスと稼働時間の履歴

開発

Skillsmith では、Docker を中心とした開発を採用しています。すべてのコマンドを Docker 内で実行することで、すべてのプラットフォームでネイティブモジュールのサポートを一貫させます。

前提条件

• Docker Desktop（v24 以降）または Docker Compose を備えた Docker Engine
• Git（リポジトリのクローン用）
• Node.js（任意。Docker 外でローカルツールを使用する場合のみ）

クイックスタート

# 1. Clone the repository
git clone https://github.com/smith-horn/skillsmith.git
cd skillsmith

# 2. Create your local environment file
cp .env.example .env

# 3. Start the development container
docker compose --profile dev up -d

# 4. Install dependencies (first time only)
docker exec -w /app skillsmith-dev-1 sh -c 'sh scripts/lib/node-modules-mount-gate.sh && npm install'

# 5. Build and test
docker exec skillsmith-dev-1 npm run build
docker exec skillsmith-dev-1 npm test

Docker でのコマンド実行

すべての npm コマンドは Docker コンテナ内で実行してください。

コンテナの管理

# Start development container
docker compose --profile dev up -d

# Check container status
docker ps | grep skillsmith

# View container logs
docker logs skillsmith-dev-1

# Stop container
docker compose --profile dev down

# Restart after Dockerfile changes
docker compose --profile dev down
docker compose --profile dev build --no-cache
docker compose --profile dev up -d

変更のプル後

package.json または package-lock.json に変更がある場合は、変更をプルした後に次の操作を行ってください。

docker exec -w /app skillsmith-dev-1 sh -c 'sh scripts/lib/node-modules-mount-gate.sh && npm install'
docker exec skillsmith-dev-1 npm run build

トラブルシューティング

コンテナが起動しない

docker compose --profile dev down
docker volume rm skillsmith_node_modules
docker compose --profile dev up -d

このワイプによって、エントリーポイントの node_modules 事前チェックで起動がブロックされることはありません。ルートボリュームはイメージから再シードされるため、チェックは終了せずに通過します（SMI-6674）。後続の起動手順は別の問題です。ワイプ後は依存関係が混在した状態になるため、続けて単独でインストールを実行しないでください。代わりに、順序付きの更新手順を表示して、その手順に従ってください（ADR-158、SMI-6614）。

( cd <main-checkout-path> && sh scripts/lib/print-deps-refresh-advice.sh <main-checkout-path> )

ネイティブモジュールのエラー（ERR_DLOPEN_FAILED）

better-sqlite3 や onnxruntime-node などのネイティブモジュールは、再ビルドが必要な場合があります。

docker exec -w /app skillsmith-dev-1 sh -c 'sh scripts/lib/node-modules-mount-gate.sh && npm rebuild'

テストで共有ライブラリのエラーが発生する場合

ld-linux-aarch64.so.1 などに関するエラーが表示される場合は、ローカルではなく Docker 内で実行していることを確認してください。

# Wrong - don't run locally
npm test

# Correct - run in Docker
docker exec skillsmith-dev-1 npm test

なぜ Docker なのか？

Skillsmith は、glibc を必要とするネイティブ Node.js モジュール（better-sqlite3、onnxruntime-node）を使用します。Docker は glibc を備えた一貫性のある Debian ベースの環境を提供し、musl libc を使用するシステム（Alpine Linux など）での互換性の問題を回避できます。

開発ワークフローとスキルの設定については、CLAUDE.md をご覧ください。

技術スタック

• ランタイム：Node.js >=22.22（glibc を備えた Docker）
• プロトコル：MCP（Model Context Protocol）
• データベース：FTS5 を使用する SQLite
• 埋め込み：onnxruntime-node 経由の all-MiniLM-L6-v2
• テスト：Vitest
• CI/CD：GitHub Actions

ライセンス

Skillsmith は、Elastic License 2.0 の下でソースコードを利用できます。

できること：

• 個人または社内の業務目的で Skillsmith を使用する
• 自分で使用するためにソースコードを変更する
• チーム向けにセルフホストする
• バグ修正や改善をコントリビュートする

できないこと：

• Skillsmith をサードパーティ向けのマネージドサービスとして提供する
• ライセンスキーの適用機能を回避する

ライセンス全文については、LICENSE ファイルをご覧ください。

作成者

Smith Horn Group Ltd

Skillsmith は Anthropic とは提携していません。Claude と Claude Code は Anthropic の商標です。