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內置了原生技能支持，但此MCP服務器將相同的功能引入到其他智能體中：

• 通用兼容性：任何兼容MCP的智能體現在都可以使用Claude技能。
• 統一管理：單個技能目錄可在所有智能體和平臺上使用。
• Claude可選：在使用Claude Desktop或Claude Code時，你可以禁用此服務器，轉而使用原生技能。
• 漸進式披露：技能分階段加載信息，最小化上下文使用量。

主要優點：以Claude的格式創建一次技能，即可在任何地方使用 —— 無論是通過Claude的原生支持，還是通過VS Code、Cursor和其他工具中的MCP。

技能使用 三級漸進式披露 系統來有效管理上下文：

1. 元數據（約100個標記）：在啟動時加載名稱和描述。
2. 指令（約5k個標記）：當技能被觸發時加載主要的SKILL.md內容。
3. 資源（按需加載）：根據需要訪問參考資料、腳本和資產。

這意味著你可以安裝數十個技能而不會產生上下文負擔 —— 智能體僅在需要時加載所需的內容。

技能遵循Anthropic基於 Claude Skills 的約定格式：

skill-name/
├── SKILL.md              # 必需：技能元數據和指令
├── references/           # 可選：按需加載的文檔
├── scripts/              # 可選：可執行代碼
└── assets/               # 可選：用於輸出的模板和文件

SKILL.md 格式

---
name: Skill Name
description: What this skill does and when to use it (be specific!)
---

# Skill Name

## Instructions

[Step-by-step guidance for the agent]

## Examples

[Concrete usage examples]

編寫優秀技能的提示

• 明確說明技能的使用時機。
• 在指令中使用祈使/不定式形式（例如“要執行X操作，請使用Y”）。
• 保持SKILL.md文件的字數不超過5k；將詳細文檔移至 references/ 目錄。
• 捆綁用於確定性操作的腳本。
• 在 assets/ 目錄中包含用於輸出的模板文件。

有關更多詳細信息，請參閱 技能規範。

參數

• -s, --skills-dir：技能目錄的路徑（必需，可以多次指定，必須是絕對路徑）。

多個技能目錄

當指定多個技能目錄時，將掃描所有目錄以查找技能。如果在不同目錄中發現具有相同ID的多個技能，將記錄警告信息，並使用最後加載的技能。

以下是具有多個目錄的示例配置：

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

測試服務器

你可以使用標準輸入輸出手動測試服務器：

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

服務器將啟動並等待標準輸入上的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服務器保持簡單，同時為智能體提供最大的靈活性。