ClaudeCode的skills学习

1. Skills 是什么

skills是一个可重复使用的技能文件，核心是将流程、规范、工具调用封装为可复用的标准化能力包。
Anthropic于2025 年 10 月 16 日正式提出并实现，用于 Claude 大模型（含 ClaudeCode）的能力扩展，核心是将流程、规范、工具调用封装为可复用的标准化能力包。

主要优势：

• 专业化能力：为特定领域任务定制能力
• 减少重复：一次创建，自动使用
• 组合能力：组合 Skills 以构建复杂工作流程

2. Skills 原理

2.1 skills架构

Claude Code允许 Skills 以包含指令、可执行代码和资料的目录形式存在，Claude按需分阶段加载token消耗少(渐进式披露)。

Skills 的整体组成

• 元数据（Metadata）：定义 Skill 的基本信息和配置
• 主体（Body / Core）
  • 指令（Instructions）：核心 Prompt，告诉 Claude 怎么使用这个 Skill
  • 代码（Code Snippets / Scripts）：可复用的代码模板、示例、脚本
  • MCP 配置（MCP Integrations）：依赖哪些 MCP 服务、如何调用
  • 工作流描述（Workflow Steps）：固定的任务执行步骤
• 资源：SKILL.md中 引入的外部资源(指令、代码等文件)
  

AI虚拟运行环境(Agent虚拟运行环境)：为 AI 智能体提供的隔离、受控的沙箱空间，它能访问文件系统、执行 bash 命令和脚本，但操作与本地真实环境隔离，保障安全。

2.2 SKILL格式

skill作用域

目录结构

.claude ├──skills/ ├── 技能名A/ │ └── SKILL.md └── 技能名C/ ├── SKILL.md └── 其他资源文件 └── reference.md (detailed API docs - loaded when needed) my-skill/ ├── SKILL.md (required - overview and navigation) ├── ├── examples.md (usage examples - loaded when needed) └── scripts/ └── helper.py (utility script - executed, not loaded)

每个技能都建立一个文件夹，其里面必须包含一个SKILL.md文件 +可选的外部资源(文件、指令、代码等)

1. 元数据：在SKILL.md中开头,必须包含name(技能名)和description(模型根据描述匹配对应的skill)

---name:skill名字 description:skill描述---

2. 指令：正文/主体内容，主要是prompt提示词，用来描述该技能工作流程

• 技能作用：这个技能是干嘛的（无障碍设计、WCAG 2.2）
• 使用场景：什么时候用它
• 核心概念：必须理解的专业知识点（POUR、语义化、焦点管理…）
• 执行步骤：Claude 必须按步骤执行（5 步）
• 架构 / 流程图：可视化说明工作原理
• 跨平台对照表：Web /iOS/ Android 对应写法
• 代码示例：真实可复制的代码（Web、iOS、Android）
• 规范与约束：禁止做什么、必须做什么、最佳实践、参考文档

3. 外部资源：脚本、可执行代码、补充说明等外部资源。

2.3 SKILL加载流程

SKILLS的核心：渐进式披露(按需加载)

元数据加载：每次与claude code交互都会加载所有安装的skills得元数据(name和descrition)

触发skill: 确定需要使用这个skill后，会加载整个SKILL.md全部内容，但是不会加载SKILL.md捆绑的外部资源

资源按需：skill.md挂载的多个文件外部资源按需加载，代码/脚本/工具等不会被加载入上下文而是只获取其输出结果。

使用处理PDF的skill加载流程

1. 首次都会加载PDF Skill技能的元数据信息

2. 用户请求：“从这个 PDF 中提取文本并总结”

3. Claude 调用：bash: read pdf-skill/SKILL.md→ 指令加载到上下文中

4. Claude 判断：不需要填写表单，因此不读取 FORMS.md

5. Claude 执行：使用 SKILL.md 中的指令完成任务

3. Skills 安装使用

3.1 内置官方skills

官方Skills

anthropics技能库：官网skills地址

相关技能

安装示例

authropics官方推荐我们使用插件的方式安装skill,通过插件可以将上边所有的官方插件。

注意authropics 将上述的技能都放在一个 document-skills中了，安装完如上所有技能都安装完毕

#添加官方插件/plugin marketplaceaddanthropics/skills# 安装所有官方插件/plugininstalldocument-skills@anthropic-agent-skills# 可以不安装 example 示范相关技能#/plugin install example-skills@anthropic-agent-skills#重新激活插件（目前我这边不好使，我使用了退出重启的方式）/reload-plugins

查看技能

#查看技能/skills#删除example-skill/plugin uninstall example-skills@anthropic-agent-skills

使用技能

#使用自然语言形式
帮我 使用algorithmic-art 生成一个随机抽象画

从上图可以看到 使用了algorithmic-art 技能画了一幅画

#显示调用 /skill-name 使用技能

/docx 帮我生成一份 35 岁 fire 的文档，要求不同资金下的生活方式

3.3 自定义Skills

技能文档编写

文件名字必须为SKILL.md

--- name: md-check description: 检查并优化 Markdown 文档格式，确保标题、列表、代码块规范 tools: Read, Write, Bash --- # Markdown 格式检查与优化技能 ## 使用场景 - 提交 PR 前检查 Markdown 文档格式 - 统一项目内 Markdown 文件的写作规范 - 修复标题层级、列表、代码块等格式问题 ## 执行步骤 1. **读取文件**：获取指定 Markdown 文件内容 2. **格式检查**：检查标题层级、列表缩进、代码块标记是否规范 3. **自动修复**： - 确保标题使用 `#` 且层级不跳级 - 列表统一使用 `-` 符号，缩进为 2 个空格 - 代码块使用 ```包裹并指定语言 4. **生成报告**：列出修改点和优化说明 5. **写入文件**：将优化后的内容写回原文件 ## 调用方式

技能创建

1. 创建存放技能目录

在 创建 ～/.claude/skills// 目录 (用户级别) /${project}/.claude/skills// 目录 (项目级别)

#创建目录mkdir-p~/.claude/skills/md-check

2. 放置技能内容到SKILL.md

#创建SKILL.md vim ~/.claude/skills/md-check/SKILL.md #填充技能文档

3. 重启

技能使用

使用和官方SKILL用法一样

4 SKILL编写规范

4.1 文档格式

4.2 参数占位

4.3 相关问题

技能未触发

1. 自然语言没有提及工具描述对应的关键字
2. 技能描述的有问题
3. 该技能设置不允许模型调用disable-model-invocation=true

技能频繁触发

1. 描述要更具体一些。
2. disable-model-invocation: true设置只手动调用

5 开源skills平台

5.1 哪里找skills

5.2 编程相关skills

6 skill杂谈

6.1 SKILL优化

同时提供规范化方式开发使用skills, 从而获取更准确的输出。