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 推荐

1. PR Review Toolkit

功能：

• 自动化代码审查
• 测试覆盖率检查
• 错误处理验证
• 类型安全审查
• 代码质量评估

适用：团队协作、代码质量保证

2. Python Development Workflow

功能：

• Python 3.12+ 最佳实践
• Django/FastAPI 项目模板
• 异步编程模式
• 类型提示支持

适用：Python 开发者

3. JavaScript/TypeScript Workflow

功能：

• ES6+ 语法
• Node.js 开发
• React/Vue 框架
• 现代 Web 工具链

适用：前端/全栈开发者

4. Claude Flow

功能：

• 150+ 专业命令
• 74+ 专业代理
• GitHub 集成
• 企业级工作流

适用：企业团队

---

Skill 与 MCP 的选择

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

---

参考资源

官方资源

• Claude Code 插件文档
• Claude Plugins 市场

社区资源

• Python Development Workflow
• PR Review Toolkit
• Claude Flow

---

文档更新时间：2025 年 12 月