Claude Code 的 skills 是单文件定义的可复用能力模块，安装后以斜杠命令或自然语言触发。本文给出官方市场、手动放置、从零编写三种安装方式，并拆解目录结构与 SKILL.md 写法。 Claude Code skills 官方资源与获取入口
动手之前，先认准官方来源，避免装到被二次打包的改版技能：
- 官方文档：docs.claude.com（Claude Code 技能说明，含字段与目录规范）
- 内置插件市场：在 Claude Code 内执行 /plugin marketplace add anthropics/claude-plugins-official 添加官方市场，再安装 skill-creator 等官方插件
注意区分：社区和第三方站点也存在大量 skills，质量参差。安装前确认来源，凡是要求输入账号密码、或 SKILL.md 里夹带不明脚本与远程下载命令的，一律不要装。
Claude Code skills 三种安装方式
方式一：官方插件市场安装（推荐）
- 打开 Claude Code，添加官方市场：/plugin marketplace add anthropics/claude-plugins-official；
- 安装官方插件，例如技能生成器：/plugin install skill-creator@claude-plugins-official；
- 若安装摘要提示需要重载，执行 /reload-plugins（仍有警告就加 --force）；
方式二：手动放置（自定义或第三方技能）
- 克隆官方仓库：git clone https://github.com/anthropics/skills --depth 1 /tmp/skills-repo；
- 查看有哪些技能：ls /tmp/skills-repo；
- 复制到个人目录（全局生效）：cp -r /tmp/skills-repo/<skill-name> ~/.claude/skills/；
- 或复制到项目目录（团队共享、可提交 Git）：cp -r /tmp/skills-repo/<skill-name> .claude/skills/；
- 如果 ~/.claude/skills 目录在本次会话开始前不存在，重启 Claude Code，新目录才会被发现。
没有 git 环境时，也可以直接从官方仓库下载 ZIP，解压后把对应文件夹复制到上述路径。
方式三：从零编写自己的 skill
- 建目录：mkdir -p ~/.claude/skills/<skill-name>；
- 在目录内新建 SKILL.md，写 frontmatter 加指令（下一节有字段表）；
- 重启 Claude Code（新建目录需重启），用 /<skill-name> 调用。
关键提示：目录名就是斜杠命令名，描述（description）越具体，Claude 越能在该用的时候自动选它。
SKILL.md 结构与目录位置对照
同一个 SKILL.md，放在不同路径，生效范围完全不同：
| | |
|---|
| ~/.claude/skills/<名称>/SKILL.md | |
| .claude/skills/<名称>/SKILL.md | |
| 托管设置目录下的 .claude/skills/<名称>/SKILL.md | |
| <插件>/skills/<名称>/SKILL.md | |
| <子目录>/.claude/skills/<名称>/SKILL.md | |
| | |
SKILL.md 开头是一段 YAML frontmatter，第一行必须是 ---。除 description 外字段均为可选：
| | |
|---|
| | |
| | |
| | |
| | 设为 true 时禁止 Claude 自动加载，只能手动触发 |
| | |
| | |
| | |
技能文件夹里还能放 scripts/、references/、assets/、examples/ 等配套文件，SKILL.md 运行时按需读取。
Skills 加载规则与命名优先级
- 同名冲突优先级：企业 > 个人 > 项目。插件技能带命名空间（/插件名:技能名），不会和上面三者直接打架。
- 保留名：不要把技能文件夹命名为 synced（任何大小写都不行），这个名字留给从 claude.ai 同步下来的技能。
- 惰性加载：Claude 启动时只读取技能的名称和描述，收到你的请求后才做语义匹配，并在读入完整内容前请你确认。
- 动态上下文注入：SKILL.md 里以 ! 开头的行（如 !git diff HEAD）会在加载前执行命令，把输出直接嵌入指令，让回答基于真实数据而不是猜测。
- 版本门槛：skills 相关多项能力官方标注需 Claude Code v2.1.200 及以上，部分 frontmatter 字段还要更新版本。运行 claude --version 自查，过旧就升级。
Skills 不生效？常见排错清单
| | |
|---|
| | |
| | 重启会话；改的是插件内文件需 /reload-plugins |
| | |
| | |
| | 加 disable-model-invocation: true |
Claude Code skills 常见问题（FAQ）
Q：Claude Code skills 收费吗？
A：技能本身只是文本文件，免费。官方技能免费提供；第三方作者可能对自研技能收费，但安装和使用机制不收钱。
Q：哪里能下载到官方 skills？
A：官方文档在 docs.claude.com，官方技能仓库在 github.com/anthropics/skills，也可在 Claude Code 内添加 anthropics/claude-plugins-official 市场一键装。
Q：技能能在 Cursor、Codex 等其他工具里用吗？
A：Claude Code 的 skills 默认只在本工具内生效（~/.claude/skills 与项目 .claude/skills）。遵循开放 Agent Skills 标准的技能可放到跨工具共享目录，被支持该标准的工具读取，但并非装好就自动通用于所有 AI 编辑器。
Q：怎么调用已经装好的技能？
A：直接输入 /<skill-name> 斜杠命令；或者在对话里描述相关需求，Claude 会按 description 语义匹配并在加载前请你确认。
Q：怎么更新或删除一个技能？
A：更新就编辑对应 SKILL.md；删除就删掉整个技能文件夹。改动后重启 Claude Code 让变更生效。
Q：对 Claude Code 版本有要求吗？
A：有。skills 相关多项能力官方标注需 v2.1.200 及以上，部分字段门槛更高。用 claude --version 自查，过旧请先升级。
Q：可以把自己写的技能分享或卖钱吗？
A：可以。技能就是文件夹加文件，打包上 README 和安装说明即可自由分享，也能作为数字商品售卖。
Q：安装第三方技能安全吗？
A：看清来源。优先官方仓库和市场；装之前读一遍 SKILL.md，警惕要求账号密码、执行远程下载或可疑 shell 命令的技能。
Q：怎么让 Claude 自动触发技能，而不是每次手敲斜杠命令？
A：把 description 写成具体动作加触发条件（例如"当用户要求写 PR 描述时使用"），Claude 会自动匹配；只想手动调就加 disable-model-invocation: true。
技能本身免费，具体字段支持与兼容性会随 Claude Code 版本演进，安装前先确认你的版本号。Claude Code skills 的安装本质是放对一个 SKILL.md 文件：官方市场一键装、手动复制即生效、从零写也不复杂。把高频工作流固化成技能，能明显少敲很多重复提示词。想跟进 Claude Code skills 的官方更新与更多玩法，可以关注本站的 AI 工具栏目，新内容我们会同步更新。
AI 速览
