sidebar: aiSidebar title: Skill（技能系统）

Skill（技能系统）

概述

Skill 是 Claude Code CLI 的插件/技能系统，允许开发者扩展 AI 助手的能力。每个 Skill 是一个独立的 npm 包，可以添加特定的功能、工作流或集成。

相关概念：MCP 是协议，Skill 是实现。 插件市场：https://claude-plugins.dev

核心概念

1. Skill 的定义

Skill 是 Claude Code 的功能扩展单元：

打包为 npm 包
包含特定的工具、工作流或代理
通过 claude-plugins install 安装
可与 Claude Code 深度集成

2. Skill 与 MCP 的关系

┌─────────────────────────────────────────────────────────┐
│              Claude Code 扩展体系                       │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │              Skill 系统                           │ │
│  │  ├── 高级封装（工作流、代理、专业功能）          │ │
│  │  ├── npm 包分发                                   │ │
│  │  ├── 配置驱动                                     │ │
│  │  └── 示例：PR Review Toolkit, Python Workflow   │ │
│  └───────────────────────────────────────────────────┘ │
│                         ▲                              │
│                         │ 可能使用                      │
│                         │                              │
│  ┌───────────────────────────────────────────────────┐ │
│  │              MCP 协议                             │ │
│  │  ├── 底层协议                                     │ │
│  │  ├── 标准化数据传输                               │ │
│  │  ├── 语言无关                                     │ │
│  │  └── 示例：Filesystem Server, GitHub Server      │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
└─────────────────────────────────────────────────────────┘

Skill 的类型

1. 工作流类 (Workflows)

提供特定开发场景的完整工作流：

Skill	功能	安装命令
Python Development	Python 3.12+、Django、FastAPI	`npx claude-plugins install @wshobson/claude-code-workflows/python-development`
JavaScript/TypeScript	ES6+、Node.js、React	`npx claude-plugins install @wshobson/claude-code-workflows/javascript-typescript`
Backend Development	API 设计、GraphQL	`npx claude-plugins install @wshobson/claude-code-workflows/backend-development`
Code Refactoring	代码清理、重构	`npx claude-plugins install @wshobson/claude-code-workflows/code-refactoring`
Developer Essentials	Git、SQL、测试	`npx claude-plugins install @wshobson/claude-code-workflows/developer-essentials`

2. 工具包类 (Toolkits)

提供特定的工具集：

Skill	功能	安装命令
PR Review Toolkit	自动化代码审查	`npx claude-plugins install @anthropics/claude-code-plugins/pr-review-toolkit`
Document Skills	Excel、Word、PDF 处理	`npx claude-plugins install @anthropics/anthropic-agent-skills/document-skills`

3. 综合类 (Comprehensive)

提供完整的企业级功能：

Skill	功能	安装命令
Claude Flow	150+ 命令、74+ 代理	`npx claude-plugins install @ruvnet/claude-flow-marketplace/claude-flow`
Frontend Excellence	React 19、Next.js 15	`npx claude-plugins install @dotclaude/dotclaude-plugins/frontend-excellence`

使用 Skill

1. 安装 Skill

# 基本安装
npx claude-plugins install <package-name>

# 安装 Python 开发工作流
npx claude-plugins install @wshobson/claude-code-workflows/python-development

# 安装 PR 审查工具包
npx claude-plugins install @anthropics/claude-code-plugins/pr-review-toolkit

2. 列出已安装的 Skill

npx claude-plugins list

3. 卸载 Skill

npx claude-plugins uninstall <package-name>

4. 更新 Skill

npx claude-plugins update <package-name>

创建自定义 Skill

项目结构

my-custom-skill/
├── package.json
├── README.md
├── src/
│   ├── index.ts          # 入口文件
│   ├── tools/            # 工具定义
│   ├── agents/           # 代理定义
│   └── workflows/        # 工作流定义
└── dist/                 # 编译输出

package.json

{
  "name": "@myorg/my-custom-skill",
  "version": "1.0.0",
  "description": "My custom Claude Code skill",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "keywords": [
    "claude-code",
    "claude-plugin",
    "skill"
  ],
  "peerDependencies": {
    "@anthropic-ai/claude-code": "*"
  }
}

入口文件 (index.ts)

import { defineSkill } from '@anthropic-ai/claude-code';

export default defineSkill({
  id: 'my-custom-skill',
  name: 'My Custom Skill',
  description: 'A custom skill for my needs',

  // 定义工具
  tools: [
    {
      name: 'my-tool',
      description: 'Does something useful',
      parameters: {
        type: 'object',
        properties: {
          input: { type: 'string' }
        }
      },
      handler: async (params) => {
        return `Processed: ${params.input}`;
      }
    }
  ],

  // 定义代理
  agents: [
    {
      name: 'my-agent',
      description: 'Handles specific tasks',
      handler: async (context) => {
        // 代理逻辑
      }
    }
  ]
});

发布到 npm

# 构建
npm run build

# 发布
npm publish

Skill 配置

配置文件位置

Claude Code 读取以下位置的配置：

~/.claude-code/
├── skills.json          # 已安装的技能列表
├── skills.config.json   # 技能配置
└── skills/              # 本地技能目录

skills.config.json 示例

{
  "enabledSkills": [
    "@wshobson/claude-code-workflows/python-development",
    "@anthropics/claude-code-plugins/pr-review-toolkit"
  ],
  "skillSettings": {
    "@wshobson/claude-code-workflows/python-development": {
      "pythonVersion": "3.12",
      "framework": "fastapi"
    }
  }
}

Skill 与 MCP 的选择

场景	推荐方案	原因
标准化数据访问	MCP	跨平台兼容，协议标准
专业工作流	Skill	高级封装，开箱即用
自定义工具	MCP	灵活控制底层逻辑
团队协作	Skill	配置共享，版本管理
快速集成	Skill	npm 安装，即插即用

参考资源

官方资源

社区资源

文档更新时间：2025 年 12 月

basics

Installation

Details

Usage

Skill Instructions