Skills MCP

プロジェクト内に.mcp.json、またはグローバルに~/.claude.jsonを作成します。

{
  "mcpServers": {
    "skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/skills"]
    }
  }
}

~/Library/Application Support/Claude/claude_desktop_config.jsonを作成します。

{
  "mcpServers": {
    "skills-mcp": {
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/skills"]
    }
  }
}

プロジェクト内に.cursor/mcp.json、またはグローバルに~/.cursor/mcp.jsonを作成します。

{
  "mcpServers": {
    "skills-mcp": {
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/skills"]
    }
  }
}

プロジェクト内に.vscode/mcp.jsonを作成します。

{
  "servers": {
    "skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "skills-mcp", "-s", "/absolute/path/to/skills"]
    }
  }
}

スキルは、汎用的なAIエージェントを特定分野の専門家に変えるためのモジュール化された独立したパッケージです。特定のドメインやタスクの「オンボーディングガイド」のようなもので、どのモデルも完全に持つことができない手続き的な知識を提供します。

例：PDF処理スキルには以下のものが含まれるかもしれません：

• テキストの抽出やフォームの入力に関する指示
• 信頼性の高いPDF操作のためのPythonスクリプト
• 高度な使用例のためのリファレンスドキュメント
• ドキュメント生成のためのテンプレートファイル

毎回の会話でPDF処理を説明する代わりに、一度スキルをインストールすると、エージェントはいつどのように使用するかを知ります。

ClaudeにはネイティブのSkillsサポートが組み込まれていますが、このMCPサーバーは同じ機能を他のエージェントにも提供します。

• 汎用互換性：MCP互換のすべてのエージェントがClaude Skillsを使用できるようになります。
• 統一管理：単一のスキルディレクトリがすべてのエージェントとプラットフォームで機能します。
• Claudeでのオプション：Claude DesktopまたはClaude Codeを使用する場合、このサーバーを無効にしてネイティブのSkillsを使用することもできます。
• 段階的開示：スキルは段階的に情報を読み込むため、コンテキストの使用を最小限に抑えます。

主な利点：Claudeの形式で一度スキルを作成すれば、Claudeのネイティブサポートでも、VS Code、Cursor、その他のツールでのMCP経由でも、どこでも使用できます。

スキルは、コンテキストを効率的に管理するために三段階の段階的開示システムを使用しています。

1. メタデータ（約100トークン）：起動時に読み込まれる名前と説明
2. 指示（約5kトークン）：スキルがトリガーされたときに読み込まれる主要なSKILL.mdの内容
3. リソース（必要に応じて読み込まれる）：参照資料、スクリプト、アセットなどは必要に応じてアクセスされます。

これにより、コンテキストのペナルティなしに数十のスキルをインストールすることができます。エージェントは必要なものを必要なときにのみ読み込みます。

スキルはClaude SkillsからのAnthropicの規約ベースの形式に従っています。

skill-name/
├── SKILL.md              # 必須：スキルのメタデータと指示
├── references/           # オプション：必要に応じて読み込まれるドキュメント
├── scripts/              # オプション：実行可能なコード
└── assets/               # オプション：出力用のテンプレートとファイル

SKILL.mdの形式

---
name: Skill Name
description: このスキルの機能と使用時期を具体的に記述します。
---

# Skill Name

## Instructions

[エージェントに対するステップバイステップのガイダンス]

## Examples

[具体的な使用例]

良いスキルを作成するためのヒント：

• 説明では、いつスキルを使用するかを具体的に記述します。
• 指示では、命令形または不定詞形を使用します（「Xを行うには、Yを使用します」）。
• SKILL.mdを5k語以内に収め、詳細なドキュメントはreferences/に移動します。
• 決定的な操作のためのスクリプトをバンドルします。
• 出力に使用するファイルのテンプレートをassets/に含めます。

詳細については、Skills仕様を参照してください。

引数

• -s, --skills-dir：スキルディレクトリへのパス（必須、複数指定可能、絶対パスで指定する必要があります）

複数のスキルディレクトリ

複数のスキルディレクトリを指定すると、すべてのディレクトリがスキルの検索対象になります。異なるディレクトリで同じIDの複数のスキルが見つかった場合、警告が表示され、最後に読み込まれたスキルが使用されます。

複数のディレクトリを指定する例：

{
  "servers": {
    "skills-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "skills-mcp",
        "-s",
        "/path/to/skills1",
        "-s",
        "/path/to/skills2"
      ]
    }
  }
}

サーバーのテスト

stdioを使って手動でサーバーをテストすることができます。

npx skills-mcp --skills-dir /absolute/path/to/skills

サーバーが起動し、stdinでJSON-RPCメッセージを待ちます。Ctrl+Cを押してサーバーを停止します。

⚠️ 重要な注意

スキルはエージェントに指示と実行可能なコードを提供します。信頼できるソース（自分で作成したもの、またはAnthropicから取得したもの）からのスキルのみを使用してください。

悪意のあるスキルは、以下のことができます。

• エージェントに有害な方法でツールを呼び出させる
• エージェントの権限でコードを実行する
• 機密データにアクセスまたは公開する

特に機密データや重要な操作にアクセスできる本番システムでは、信頼できるソースからのみインストールするようにしてください。詳細については、仕様書のセキュリティに関する考慮事項セクションを参照してください。

list_skills

すべての利用可能なスキルとそのメタデータをリストします。

出力：

{
  "skills": [
    {
      "id": "pdf-processing",
      "name": "PDF Processing",
      "description": "Extract text and tables from PDF files..."
    }
  ]
}

get_skill

完全なスキルの内容と絶対パスを取得します。

入力：

{
  "id": "pdf-processing"
}

出力：

{
  "path": "/Users/username/.claude/skills/pdf-processing/SKILL.md",
  "name": "PDF Processing",
  "description": "Extract text and tables...",
  "content": "# PDF Processing\n\n## Quick start\n..."
}

init-skills

Skills MCPのワークフローに関する情報ガイダンスを提供します。このプロンプトは以下のことを行います。

• スキルとは何か、どのように構成されているかを説明する
• 段階的開示モデル（必要なものを必要なときにのみ読み込む）を概説する
• スキルの発見、読み込み、使用のステップバイステップのワークフローを説明する
• MCPは最小限のラッパーであり、エージェントがすべてのファイル操作を処理することを明確にする

使用時期：会話の開始時に実行して、背景情報を提供します。このプロンプトは情報提供のみで、即座のアクションをトリガーすることはありません。エージェントは、利用可能なスキルの説明に一致するタスクに遭遇したときにスキルを使用します。

Skills MCPは、最新のAIエージェントの全機能を活用する最小限のラッパー設計に従っています。

サーバーが提供するもの：

• スキルの発見とメタデータ
• 絶対ファイルパス付きのスキル内容
• スキル固有のコンテキスト形式

エージェントが処理するもの（既存のツールを使用）：

• 参照ファイルの読み取り（references/、scripts/、assets/）
• スクリプトの実行
• ディレクトリの検索とナビゲーション

例のワークフロー：

1. エージェントがlist_skillsを呼び出し、「PDF Processing」を見つける
2. エージェントがget_skillを呼び出し、/path/to/pdf-processing/SKILL.mdを受け取る
3. スキルでは、高度な機能のためにreferences/FORMS.mdが指定されている
4. エージェントが完全なパスを構築して読み取る：/path/to/pdf-processing/references/FORMS.md
5. エージェントがスクリプトを実行する：cd /path/to/pdf-processing && python scripts/fill_form.py

この設計により、MCPサーバーをシンプルに保ちながら、エージェントに最大限の柔軟性を与えます。