如何在 Claude Code 安装 Skill（技能）与插件：完整步骤

更新于 2026-10-22 · 内容依据官方文档整理，配置项可能随版本变化，请以官方最新文档为准。

Skill（技能）是一个包含 SKILL.md 的文件夹：文件开头的 YAML 头信息告诉 Claude 什么时候用它，正文是具体指令。Claude 会在相关时自动加载技能，你也可以输入 /技能名 直接调用。和 CLAUDE.md 不同，技能正文只在用到时才加载，平时只占用描述那一小段上下文。

1. 技能放在哪里

位置	路径	生效范围
个人	`~/.claude/skills/<技能名>/SKILL.md`	本机所有项目
项目	`.claude/skills/<技能名>/SKILL.md`	当前仓库，提交到 git 后团队共享
插件	`<插件>/skills/<技能名>/SKILL.md`	启用该插件的地方，调用名为 `/插件名:技能名`

同名时个人技能优先于项目技能。旧的 .claude/commands/xxx.md 自定义命令仍然可用，官方已把它们并入技能体系。

2. 手动安装一个技能

以官方文档示例为例，先建目录：

mkdir -p ~/.claude/skills/summarize-changes
# 然后创建 ~/.claude/skills/summarize-changes/SKILL.md

SKILL.md 最少只需要 description（官方推荐填写），name 不填时默认用目录名：

---
name: summarize-changes
description: 总结未提交的改动并标出风险。用户询问改了什么、要写提交说明或要求审查 diff 时使用。
---

总结当前 git 改动，列出可能的风险（缺少错误处理、硬编码、需要补测试等）。

从 GitHub 上的技能仓库安装，就是把对应目录复制进来，例如官方仓库里的 pdf 技能：

git clone --depth 1 https://github.com/anthropics/skills.git /tmp/skills
cp -r /tmp/skills/skills/pdf ~/.claude/skills/

Claude Code 会监听技能目录，添加或修改后当前会话就能用，不需要重启。如果 ~/.claude/skills/ 是会话启动后才新建的，执行一次 /reload-skills。

3. 通过插件市场安装（推荐）

插件可以打包技能、子代理、钩子和 MCP 服务器。先添加市场，再安装插件：

/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official

如果提示 Marketplace not found，说明还没添加市场；提示插件找不到时，先执行 /plugin marketplace update 市场名 刷新目录。本站的插件详情页都给出了这两行命令。

4. 技能不触发怎么办

检查 description 是否包含你平时会说的关键词，把最主要的用途写在最前面。
问 Claude「What skills are available?」，确认技能被加载。
直接输入 /技能名 调用；如果连这个都不认，可能是名字里有零宽字符、< 等非法字符。
头信息 YAML 写错时技能仍会加载但没有描述，可用 claude --debug 查看解析错误，或运行 claude plugin validate ~/.claude/skills。
技能太多时描述会被截断，可运行 /skill-doctor 找出不用的技能关掉。

5. 安全提醒

技能可以通过 allowed-tools 给自己预先授权工具，还能用 !`命令` 在加载时执行 shell 命令。安装第三方技能前请先读一遍 SKILL.md 和附带脚本。本站收录的条目均未经实测。

浏览全部技能与插件 →