给 Claude Code 添加 skills 主要有两种方式：

1. 安装已有插件；
2. 创建自定义插件。

详细说明如下。

1. 通过安装插件添加 skills

这是最简单的方式，许多插件都自带 skills（如 update-config、simplify、loop 等）。

步骤：

1. 在 Claude Code 会话中运行：

   /plugin install 插件名@claude-plugins-official
   

   例如安装代码简化插件：

   /plugin install code-simplifier@claude-plugins-official
   

2. 或通过菜单浏览插件：输入 /plugin → 选择 Discover → 找到所需插件安装。

3. 安装后重启 Claude Code，新 skills 即可使用。

---

2. 创建自定义插件添加 skills

2.1 几个关键概念

• marketplace：插件 plugin 市场，里面装了各种claude code的插件
• plugin：claude code的各种插件，每个插件帮claude code完成具体的功能，每个 plugin 中可以包含 skill 和 mcp
• skill：本质是一份说明书文档，指示claude code在什么时候应该怎么干活

为 claude code 添加自己的 skills 这里给出的方法是：

1. 添加一个自己定义的 marketplace 目录
2. 通过自定义的 marketplace 目录加载安装自定义的skills

具体步骤，请见下文。

2.2 目录结构要求

marketplace-name/
└── .claude-plugin/
    └── marketplace.json
└── skill-name/
    ├── .claude-plugin/
    │   └── plugin.json
    └── skills/
        └── SKILL.md

---

2.3 marketplace.json 格式

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "marketplace-name",
  "description": "市场描述",
  "owner": {
    "name": "你的名字",
    "email": "your@email.com"
  },
  "plugins": [
    {
      "name": "skill-name",
      "description": "Skill 描述，触发条件说明",
      "version": "1.0.0",
      "source": "./skill-name",
      "skills": [
        "./skill-name/skills"
      ]
    }
  ]
}

关键点

字段	要求	错误示例	正确示例
source	字符串	{ "source": "directory", "path": "./drawio" }	"./drawio"
skills	字符串数组	[{"name": "drawio", "path": "./drawio/skills"}]	["./drawio/skills"]

---

2.4 plugin.json 格式

{
  "name": "skill-name",
  "description": "Skill 描述，用于触发和说明用途",
  "author": {
    "name": "你的名字",
    "email": "your@email.com"
  }
}

---

2.5 SKILL.md 格式

这是技能的详细文档，通常包含以下部分：

必需部分

• Overview — 技能概述
• When to Use — 触发条件（显式触发 + 主动触发）
• Workflow — 使用流程

可选部分

• Prerequisites — 前置要求
• Commands — 命令示例
• Common Mistakes — 常见错误

示例结构

---
name: drawio
description: Use when user requests diagrams, flowcharts...
---

## Overview

Generate .drawio XML files and export to PNG/SVG/PDF locally.

## When to Use

**Explicit triggers:** user says "画图", "diagram", "visualize"...

**Proactive triggers:**
- Explaining a system with 3+ components
- Describing multi-step processes

## Workflow

1. Detect CLI
2. Plan
3. Generate
4. Export draft
5. Self-check
6. Review loop
7. Final export

---

2.6 添加步骤

步骤	命令/操作
1. 创建目录结构	在 C:\Users\xxx\.claude\plugins\marketplaces\ 下创建
2. 添加 marketplace	2.1 /plugin → Add marketplace2.2 输入自己创建的 marketplace 路径
3. 重新加载	/reload-plugins
4. 验证	/plugin 查看已安装的插件和 skills

---

2.7 常见错误排查

错误信息	原因	解决方案
Invalid schema: plugins.0.source: Invalid input	source 是对象而非字符串	改为 "source": "./skill-name"
Invalid schema: plugins.0.skills: Invalid input	skills 是对象数组	改为 "skills": ["./skill-name/skills"]
技能不显示	skills 目录路径错误	检查 skills 文件夹和 SKILL.md 是否存在
marketplace 添加失败	JSON 格式错误	使用 JSON 验证器检查语法

---

2.8 完整示例：drawio 插件

目录结构

custom-plugins/
└── .claude-plugin/
    └── marketplace.json
└── drawio/
    ├── .claude-plugin/
    │   └── plugin.json
    └── skills/
        └── SKILL.md

marketplace.json

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "custom-plugins",
  "description": "Directory of custom Claude Code extensions",
  "owner": {
    "name": "你的名字",
    "email": "你的邮箱@email.com"
  },
  "plugins": [
    {
      "name": "drawio",
      "description": "Use when user requests diagrams...",
      "version": "0.2.0",
      "source": "./drawio",
      "skills": [
        "./drawio/skills"
      ]
    }
  ]
}

plugin.json

{
  "name": "drawio",
  "description": "Use when user requests diagrams, flowcharts, architecture charts...",
  "author": {
    "name": "你的名字",
    "email": "你的邮箱@email.com"
  }
}

---

3. 验证 skill 是否生效

安装插件后，在 Claude Code 会话中：

• 输入 / 查看可用的 skills 列表
• 如果 skill 描述的条件匹配用户请求，Claude 会自动应用该 skill

---

注意事项

1. 技能触发：skill 的触发完全依赖 description 字段的描述，要准确包含用户可能使用的关键词。
2. 插件信任：只安装可信来源的插件，插件可能访问文件系统或执行命令。
3. 重启生效：安装插件后通常需要重启 Claude Code 会话。
4. 官方文档：更多细节参考 https://code.claude.com/docs/en/plugins。

如果你只需要现有功能，直接安装官方插件库中的插件即可。如果需要定制功能，则可以创建自定义插件。