Agent Skill Loader

🚀 Agent Skill Loader 🧠

Agent Skill Loaderは、静的なClaude Code Skillsライブラリと動的なAIエージェント（Antigravity、Claude Desktop、Cursorなど）の間の橋渡し役として機能するModel Context Protocol (MCP)サーバーです。これにより、エージェントは必要に応じてスキルを「学習」でき、各プロジェクトに手動でファイルをコピーする必要がなくなります。

🚀 クイックスタート

Agent Skill Loaderを使用することで、AIエージェントがスキルを動的に学習できるようになります。以下のセクションでは、セットアップ方法、設定、使用方法などを説明します。

✨ 主な機能

• 探索機能: list_skills - 設定されたスキルディレクトリをスキャンします。
• 動的学習機能: read_skill - エージェントが読むためのSKILL.mdの内容を取得します。
• 永続化機能: install_skill - 必要に応じてスキルをプロジェクトに永久にコピーします。
• 設定機能: manage_search_paths - 実行時にスキルディレクトリを追加または削除します。
• トラブルシューティング機能: debug_info - 設定とパスの問題を診断します。

📦 インストール

前提条件

• Node.js >= 18

オプションA: npmからインストール（推奨）

npm install -g agent-skill-loader

次に、.mcp.jsonに登録します。

"agent-skill-loader": {
  "command": "agent-skill-loader"
}

オプションB: ソースからビルド

git clone https://github.com/back1ply/agent-skill-loader.git
cd agent-skill-loader
npm install
npm run build

次に、.mcp.jsonに登録します。

"agent-skill-loader": {
  "command": "node",
  "args": ["<path-to-repo>/build/index.js"]
}

📚 ドキュメント

設定

サーバーは自動的にワークスペースを検出し、以下の場所からスキルパスを集約します。

1. デフォルト: %USERPROFILE%\.claude\plugins\cache（標準の場所）
2. 動的設定: skill-paths.json（プロジェクトルートにあります）

動的パス管理

設定ファイルを手動で編集する必要はありません。ツールを使用して実行時にパスを管理できます。

• 追加: manage_search_paths(operation="add", path="F:\\My\\Deep\\Skills")
• 削除: manage_search_paths(operation="remove", path="...")
• 一覧表示: manage_search_paths(operation="list") は skill-paths.json を作成または更新します。

使用方法

エージェント向け

エージェントは5つのツールを見ることができます。

• list_skills(): 利用可能なスキルのJSONリストを返します。
• read_skill(skill_name): マークダウン形式の説明を返します。
• install_skill(skill_name, target_path?): フォルダを .agent/skills/<name> にコピーします。セキュリティ上の理由から、target_path は現在のワークスペース内である必要があります。
• manage_search_paths(operation, path?): スキル検索パスを追加、削除、または一覧表示します。
• debug_info(): 診断情報（パス、ステータス、警告）を返します。

エージェントのプロンプト例

"DAXメジャーを書く必要がありますが、ベストプラクティスがわかりません。"

エージェントは自動的に list_skills を呼び出し、writing-dax-measures を見つけ、read_skill を呼び出し、その後専門知識を使ってあなたに回答します。

トラブルシューティング

スキルが見つからない場合は、debug_info() を使用して以下の情報を確認できます。

• search_paths: スキャンされているディレクトリ
• path_status: 各パスが存在し、読み取り可能かどうか
• warnings: スキャン中に遭遇したエラー（アクセス拒否、空のファイルなど）

出力例:

{
  "workspace_root": "C:/projects/agent-skill-loader",
  "search_paths": {
    "base": ["C:/Users/pc/.claude/plugins/cache"],
    "dynamic": ["F:/My/Skills"],
    "effective": ["C:/Users/pc/.claude/plugins/cache", "F:/My/Skills"]
  },
  "path_status": [
    { "path": "C:/Users/pc/.claude/plugins/cache", "exists": true, "readable": true },
    { "path": "F:/My/Skills", "exists": false, "readable": false }
  ],
  "skills_found": 12,
  "warnings": [
    { "path": "F:/My/Skills", "reason": "Directory does not exist" }
  ]
}

プロジェクト構造

• src/index.ts: メインのサーバーロジック。
• build/: コンパイルされたJavaScriptの出力。
• package.json: 依存関係（@modelcontextprotocol/sdk、zod）。

コントリビュート

新しいスキルを追加するには、監視対象のディレクトリのいずれかに SKILL.md ファイルを含むフォルダを追加するだけです。サーバーは自動的にそれらを検出します（新しいファイルには再起動は必要ありませんが、キャッシュの実装によっては異なる場合があります）。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、こちらを参照してください。