Open Claude Skill

Agent技能MCP

将克劳德代理技能带给任何兼容MCP的代理

通用MCP服务器，支持 任何 在MCP支持下使用Anthropic官方代理申请 克劳德代理技能 随着 渐进式呈现 -在最大化能力的同时减少上下文开销。

包名: agentskill-mcp | PyPI: 代理技能mcp

英语| 简体中文

为什么选择AgentSkill MCP？

Claude Agent Skills的设计非常出色，但与Claude的生态系统紧密相连。该项目通过以下方式打破了这一限制：

• ✅ 通用兼容性：适用于任何MCP兼容代理（Kilo Code、Cursor、Roo Code、Codex等）
• ✅ 100%克劳德技能兼容：使用官方的拟人技能格式-无需修改
• ✅ 渐进呈现：实现与Claude Code相同的智能上下文加载
• ✅ 零锁定：标准MCP协议意味着您永远不会绑定到一个平台

问题技能解决

传统的MCP工具预先加载所有文档，甚至在开始之前就消耗了大量的令牌。有了15多种工具，你的代理在做任何实际工作之前都会缺乏上下文。

技能解决这个问题 通过渐进式披露：代理最初会看到一个轻量级的技能列表，然后只在需要时加载完整的细节。该项目为每个MCP兼容代理带来了相同的效率。

特性

• 🚀 单线安装: pip install agentskill-mcp 或 uvx agentskill-mcp
• 🔌 通用MCP兼容性（逐步测试）：适用于Kilo Code、Cursor、Roo Code、Codex、Cherry Studio和任何MCP兼容代理
• 📦 官方技能格式：完全兼容 人类学的克劳德技能
• 🎯 渐进呈现：智能上下文加载-在需要技能之前，开销最小
• 🔄 热重载（尚未实现）：实时检测和更新文件更改（在支持协议的情况下）
• 🗂️ 智能路径发现：自动检测 .claude/skills/, .skill/，或自定义目录
• 🌍 环境意识：具有自动检测功能的项目级和全局技能目录
• 🎨 兼容ClaudeCode：支持两者 .claude/skills/ （条款代码格式）和 .skill/ （此项目的自定义格式）

项目状态

⚠️ 早期发展 -这个项目还处于早期阶段。目前仅在Windows上测试。

测试平台：

• ✅ 基洛代码 （AI编码助手）-Windows
• ✅ Roo代码 （AI编码助手）-Windows
• ✅ 克莱恩 （AI编码助手）-Windows

下一步：

• 🔄 对更多MCP兼容试剂（Codex、Cursor、QwenCode等）进行测试
• 🔄 跨平台测试（macOS、Linux）
• 🔄 更广泛的兼容性验证
• 🔄 热重载可行性测试（基于MCP的列表更改通知）见：

https://modelcontextprotocol.io/specification/2025-06-18/server/tools#list-更改通知

理论上：任何实施 模型上下文协议 应该有效，但我们正在积极测试以确认。

快速开始

配置

⚠️ 当前推荐用法：通过指定技能目录 --skills-dir 参数

添加到MCP客户端配置文件中。在您的代理文档中查找配置位置：

• 基洛代码: .kilocode/mcp.json 在您的工作空间中
• Roo代码：检查代理文件
• 光标: .cursor/mcp.json 在您的工作空间中
• 其他代理商：请参阅特定于代理的MCP配置指南

推荐配置（Windows）：

{
  "mcpServers": {
    "skills": {
      "command": "uvx",
      "args": [
        "agentskill-mcp",
        "--skills-dir",
        "C:\\Users\\YourName\\path\\to\\skills"
      ]
    }
  }
}

对于macOS/Linux：

{
  "mcpServers": {
    "skills": {
      "command": "uvx",
      "args": [
        "agentskill-mcp",
        "--skills-dir",
        "/Users/YourName/path/to/skills"
      ]
    }
  }
}

使用pip安装版本：

替换 "command": "uvx" 随着 "command": "agentskill-mcp" 并将其从args中删除：

{
  "mcpServers": {
    "skills": {
      "command": "agentskill-mcp",
      "args": [
        "--skills-dir",
        "C:\\Users\\YourName\\path\\to\\skills"
      ]
    }
  }
}

💡 提示:

• 在中使用绝对路径 --skills-dir 避免歧义
• 配置更改后，重新启动代理应用程序或重新加载MCP服务器
• 测试用 examples/ 在创建自定义技能之前，请先查看目录

加载技能

创建技能目录并添加技能包：

格式1:ClaudeCode格式（建议ClaudeCode用户使用）

# Create in current project (recommended)
Create .claude/skills/ in project root directory

# Or create globally
mkdir -p ~/.claude/skills    # Linux/Mac
mkdir C:\Users\YourName\.claude\skills  # Windows

格式2：此项目的自定义格式（与其他代理兼容）

# Create in current project
Create .skill/ in project root directory

# Or create globally
mkdir ~/.skill         # Linux/Mac
mkdir C:\Users\YourName\.skill  # Windows

然后将你的技能包放在技能目录中。这 ./examples 目录中包含几个官方的Anthropic Skill包，这些包足以进行测试。

# Example of migrating skills (ClaudeCode format)
Copy examples/canvas-design -> .claude/skills/
Copy examples/brand-guidelines -> .claude/skills/

# Or (Custom format for this project)
Copy examples/canvas-design -> .skill/
Copy examples/brand-guidelines -> .skill/

最终结构应该如下：

• 条款代码格式： .claude/skills/canvas-design/
• 此项目的自定义格式： .skill/canvas-design/

试试看

重新启动Agent应用程序并使用以下命令进行测试：

Create a 1920x1080 promotional poster using Anthropic brand style.
Theme: "AI belongs to the future? AI is just a means, not an end"

发生了什么：

1. 代理在中看到可用的技能 load_skill 工具说明
2. 代理人识别相关技能(canvas-design, brand-guidelines)
3. 客服电话 load_skill 获取完整的技能细节
4. 代理按照技能说明创建海报

备注：代理可能只调用一种技能，具体取决于它如何解释任务。这是正常的——人工智能代理在工具选择方面具有一些固有的随机性。

技能格式

技能遵循官方的Claude Skill格式：

Frontmatter（YAML）

---
name: skill-name          # Required: matches folder name
description: |            # Required: detailed description for agent matching
  What this skill does and when to use it.
  Include keywords that agents should match on.
license: MIT              # Optional: license information
---

技能含量

在frontmatter之后，提供详细的Markdown说明：

• 明确、可操作的指导
• 示例和最佳实践
• 辅助资源参考

辅助资源

技能可以包括模板、字体、脚本等资源：

# ClaudeCode format
.claude/skills/
├── algorithmic-art/
│   ├── SKILL.md
│   └── templates/
│       ├── viewer.html
│       └── generator.js

# Or legacy format
.skill/
├── algorithmic-art/
│   ├── SKILL.md
│   └── templates/
│       ├── viewer.html
│       └── generator.js

您技能中的参考资源：

Read `templates/viewer.html` using the Read tool

运作原理

逐步披露实施

挑战：如何在MCP框架内实施渐进式披露？

克劳德官方实施 （从行为推断）：

• 内置技能系统集成在客服系统提示中
• 初始显示仅显示 `` 列表
• 特别 load_skill 命令触发完整内容加载

我们的MCP实施:

1. 单MCP工具： load_skill

- 将所有可用的技能元数据嵌入到工具中 description - 代理在不加载完整内容的情况下查看技能列表

1. 工具描述结构:

Tool(
    name="load_skill",
    description="""Execute a skill within the main conversation

When users ask you to perform tasks, check if any of the
available skills below can help...

  code-reviewer
  Comprehensive code review framework...

  calculator
  Mathematical calculations...

""",
    inputSchema={
        "type": "object",
        "properties": {
            "skill": {"type": "string"}
        }
    }
)

1. 按需加载:

- 代理将任务与来自的技能进行匹配 ` - 呼叫 load_skill(skill="code-reviewer") - 服务器读取 .skill/code-reviewer/SKILL.md` - 返回完整技能内容

当前实施说明

版本0.1.3 关注最可靠的使用模式：

• ✅ 推荐：通过指定技能目录 --skills-dir 参数
• ⚠️ 实验性：动态 set_skills_directory 工具（目前在生产中禁用）

这种方法确保了不同代理实现之间的最大兼容性，同时我们继续测试和改进更高级的功能。

路径发现

服务器会自动使用此优先级查找技能：

1. 命令行参数: --skills-dir /path/to/skills ⭐ 推荐
2. 环境变量: MCP_SKILLS_DIR=/path/to/skills
3. 项目级别: .claude/skills/ 或 .skill/ 在项目根目录中（检测 .git, .claude/, package.json等等）
4. 全球回退: ~/.skill

备注：项目级发现优先 .claude/skills/ （条款代码格式）以上 .skill/ （此项目的自定义格式）。

当前建议：始终使用 --skills-dir 参数以获得最佳兼容性。

用法示例

示例1：使用绝对路径（推荐）

{
  "mcpServers": {
    "skills": {
      "command": "uvx",
      "args": [
        "agentskill-mcp",
        "--skills-dir",
        "C:\\userfolder\\DevFolder\\my-skills"
      ]
    }
  }
}

示例2：使用项目示例

{
  "mcpServers": {
    "skills": {
      "command": "uvx",
      "args": [
        "agentskill-mcp",
        "--skills-dir",
        "C:\\path\\to\\Open-ClaudeSkill\\examples"
      ]
    }
  }
}

提供的工具

load_skill

按名称加载并激活技能。

参数：

• skill （string）：要加载的技能名称

例子：

load_skill(skill="code-reviewer")

高级配置

环境变量

• MCP_SKILLS_DIR：覆盖默认技能目录

命令行参数

agentskill-mcp --skills-dir /custom/path --log-level DEBUG

日志记录

设置调试日志级别：

agentskill-mcp --log-level DEBUG

水平： DEBUG, INFO, WARNING, ERROR

例子

请参阅 examples/ 示例技能目录：

• 算法艺术：使用p5.js创建生成艺术
• 帆布设计：设计视觉艺术和海报
• 品牌指南：应用Anthropic品牌造型
• 代码审查员：全面的代码审查框架
• 计算器：数学计算

安装

方法1：使用pip（推荐）

pip install agentskill-mcp

方法2：使用uvx（无需安装即可试用）

# Run directly without installing
uvx agentskill-mcp --help

方法3：使用紫外线

uv pip install agentskill-mcp

验证安装：

agentskill-mcp --help

# Expected output:
# usage: agentskill-mcp [-h] [--skills-dir SKILLS_DIR]
#                       [--log-level {DEBUG,INFO,WARNING,ERROR}]
#
# AgentSkill MCP - MCP Server for Claude Skills with progressive disclosure

为了发展 （如果你想修改代码）：

git clone https://github.com/QianjieTech/Open-ClaudeSkill.git
cd Open-ClaudeSkill
pip install -e .

发展

从源头运行

# Install development dependencies
uv pip install -e .

# Run the server
uv run agentskill-mcp

# Run with debug logging
uv run agentskill-mcp --log-level DEBUG

创建自定义技能

1. 将示例技能复制为模板
2. 修改正面内容（名称、描述）
3. 更新说明
4. 添加任何辅助资源
5. 与您的代理人一起测试

建筑

核心组件

• 服务器状态：管理运行时状态和路径发现
• SkillLoader：发现和解析技能文件
• SkillFileHandler：通过取消抖动来监控文件更改
• SkillMCPServer：主MCP服务器实现

渐进呈现

技能通过单一途径展现 load_skill 在描述中列出所有可用技能的工具。这最大限度地减少了初始令牌的使用，同时提供了完整的发现。

热重新加载

通过看门狗检测文件更改，并触发技能重新加载。更改对下一个代理请求立即生效。

备注：热重载功能在代码库中实现，但尚未验证其在实践中在所有MCP兼容代理中可靠工作。

贡献

欢迎投稿！请看 贡献.md 作为指导方针。

许可证

Apache许可证2.0-请参阅 许可证 了解详情。

资源

• 文档: 官方文件
• 代理技能规范: 人类学规范
• MCP协议: 模型上下文协议
• 问题:

致谢

该项目基于以下开源项目构建：

• MCP（模型上下文协议） -人类学
• 克劳德技能 -人类学
• 看门狗 -文件系统监控
• 格式 -YAML解析

联系

QQ群：1065081197

______________________________________________________________________

由以下材料制成❤️ 由Open ClaudeSkill社区发布