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服务器保持简单，同时为智能体提供最大的灵活性。