Agent Skill Loader

🚀 Agent Skill Loader 🧠

Agent Skill Loader 是一個模型上下文協議（MCP）服務器，它在你的靜態 Claude 代碼技能庫和動態 AI 代理（如 Antigravity、Claude Desktop 或 Cursor）之間架起了一座橋樑。它允許代理按需“學習”技能，而無需你手動將文件複製到每個項目中。

🚀 快速開始

前提條件

• 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"]
}

✨ 主要特性

• 發現功能：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"]
}

💻 使用示例

對於代理

代理將看到五個工具：

• list_skills()：返回可用技能的 JSON 列表。
• read_skill(skill_name)：返回 markdown 說明。
• 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，然後用專業知識回答你。

🔧 技術細節

配置

服務器會自動檢測其工作區，並從以下位置聚合技能路徑：

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。

故障排除

如果技能未被發現，使用 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 許可證。