Claude Code Skill 与 Plugin 完整教程总结

Claude Code Skill 与 Plugin 完整教程总结

一、核心概念区分：Skill（技能）vs Plugin（插件）

1. 本质定义

• Skill（技能）：单一可复用、自动匹配的工作流能力模块，是最小功能单元。
• Plugin（插件）：打包多个Skill、配置、脚本、事件钩子等组件的完整容器/安装包，可包含一套完整业务工具集。

2. 目录结构对比

Skill 标准目录（my-skill/）

plaintext

my-skill/
├─ SKILL.md # 【必需】Skill主入口，核心文件
├─ reference.md # 可选：知识库、详细说明文档
├─ examples.md # 可选：使用示例、输出样例
└─ scripts/
└─ helper.py # 可选：辅助执行脚本

Plugin 标准目录（my-plugin/）

plaintext

my-plugin/
├─ .claude-plugin/
│ └─ plugin.json # 【必需】插件元数据/清单文件
├─ skills/ # 可选：存放1个或多个Skill模块
│ ├─ ppt/
│ │ └─ SKILL.md
│ └─ wechat-format/
│ ├─ SKILL.md
│ ├─ templates.md
│ └─ scripts/render.py
├─ agents/ # 可选：自定义智能代理
├─ hooks/
│ └─ hooks.json # 可选：事件钩子配置
├─ commands/ # 可选：自定义命令
├─ .mcp.json # 可选：MCP服务配置
├─ .lsp.json # 可选：LSP语言服务配置
├─ bin/ # 可选：可执行程序，自动加入环境PATH
└─ settings.json # 可选：插件全局默认配置

3. 存储生效范围区别

Skill 根据存放路径，分为两种生效模式：

1. 项目局部Skill（仅当前项目可用）
路径：项目根目录下  ./skills/ 
特点：仅在当前打开的项目内加载生效，多项目隔离。
2. 全局Skill（所有项目通用）
路径：用户根目录  ~/.claude/skills/ 
特点：所有Claude Code项目自动加载，全局复用。

二、3种 Skill 安装方式（最终运行效果完全一致）

1. 手动复制（最基础）
将完整Skill文件夹（内含 SKILL.md 核心文件），直接复制到上述项目局部skills或全局~/.claude/skills目录。
2. 专用工具安装
使用官方/社区提供的skill管理工具一键拉取、部署Skill包。
3. Plugin插件安装
安装完整Plugin包，Plugin内部自带 skills/ 目录，自动批量注册内部所有Skill。

三、手动创建 Skill 核心规范

1. 文件夹命名为自定义skill标识（如 frontend-design ）；
2. 强制必备文件：根目录 SKILL.md ，为Skill的功能定义、提示词主入口，缺失则无法识别；
3. 辅助文件按需添加：知识库、示例、执行脚本；
4. 存放至目标目录（全局/项目局部）后重启Claude Code即可自动加载。

四、底层原理补充

提示词统一存入数据库，通过唯一key完成调用；Skill是轻量化单功能模块，Plugin是包含多能力、服务、钩子、配置的完整扩展包。

五、视频来源

视频标题：手把手教你在Claude Code中熟练使用SKILL技能！
B站链接：https://b23.tv/vCXzTjq
UP主：我是阿众