1. Skills 是什么2. Skills 原理2.1 skills架构2.2 SKILL格式2.3 SKILL加载流程3. Skills 安装使用3.1 内置官方skills官方Skills安装示例3.3 自定义Skills技能文档编写技能创建技能使用4 SKILL编写规范4.1 文档格式4.2 参数占位4.3 相关问题5 开源skills平台5.1 哪里找skills5.2 编程相关skills6 skill杂谈6.1 SKILL优化1. Skills 是什么skills是一个可重复使用的技能文件核心是将流程、规范、工具调用封装为可复用的标准化能力包。Anthropic于2025 年 10 月 16 日正式提出并实现用于 Claude 大模型含 ClaudeCode的能力扩展核心是将流程、规范、工具调用封装为可复用的标准化能力包。Skills 本质可复用标准化能力包专业领域知识工作流程上下文模板规范工具调用组合封装为单个 Skill主要优势专业化能力为特定领域任务定制能力减少重复一次创建自动使用组合能力组合 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作用域作用域存放路径生效范围个人(User)~/.claude/skills//SKILL.md你的所有项目都可以使用项目(Project).claude/skills//SKILL.md仅当前项目插件(Plugins)/skills//SKILL.md该插件被启用同个人目录结构.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文件 可选的外部资源(文件、指令、代码等)元数据在SKILL.md中开头,必须包含name(技能名)和description(模型根据描述匹配对应的skill)---name:skill名字 description:skill描述---指令正文/主体内容主要是prompt提示词用来描述该技能工作流程技能作用这个技能是干嘛的无障碍设计、WCAG 2.2使用场景什么时候用它核心概念必须理解的专业知识点POUR、语义化、焦点管理…执行步骤Claude 必须按步骤执行5 步架构 / 流程图可视化说明工作原理跨平台对照表Web /iOS/ Android 对应写法代码示例真实可复制的代码Web、iOS、Android规范与约束禁止做什么、必须做什么、最佳实践、参考文档外部资源脚本、可执行代码、补充说明等外部资源。2.3 SKILL加载流程SKILLS的核心渐进式披露(按需加载)元数据加载每次与claude code交互都会加载所有安装的skills得元数据(name和descrition)触发skill: 确定需要使用这个skill后会加载整个SKILL.md全部内容但是不会加载SKILL.md捆绑的外部资源资源按需skill.md挂载的多个文件外部资源按需加载代码/脚本/工具等不会被加载入上下文而是只获取其输出结果。级别加载时机Token 成本内容第一级元数据始终启动时每个 Skill 约 100 个 tokenYAML 前置元数据中的name和description第二级指令触发 Skill 时不超过 5k token包含指令和指导的 SKILL.md 主体第三级及以上资源按需实际上无限制通过 bash 执行的捆绑文件不将内容加载到上下文中使用处理PDF的skill加载流程首次都会加载PDF Skill技能的元数据信息用户请求“从这个 PDF 中提取文本并总结”Claude 调用bash: read pdf-skill/SKILL.md→ 指令加载到上下文中Claude 判断不需要填写表单因此不读取 FORMS.mdClaude 执行使用 SKILL.md 中的指令完成任务3. Skills 安装使用3.1 内置官方skills官方Skillsanthropics技能库官网skills地址目录含义用途skills官方技能示例库包含创意设计、开发技术、企业沟通、文档处理等各类官方技能的完整示例代码 / 定义specAgent Skills 规范文档定义了 Claude 技能的编写格式、语法、触发规则的官方标准相当于「技能开发说明书」template技能模板一份可直接复制修改的空白技能模板你可以基于它快速开发自定义技能相关技能技能名核心用途极简版algorithmic-art生成算法艺术作品(图案、动画brand-guidelines按品牌规范生成内容canvas-design设计海报 / 插画等视觉图claude-api辅助调用 / 调试 Claude APIdoc-coauthoring多人协作文档撰写docx生成 / 编辑 Word 文档frontend-design开发 React/Tailwind 前端internal-comms写企业内部沟通文案mcp-builder构建 MCP 协议服务pdf生成 / 编辑 PDF 文档pptx制作 PowerPoint 演示文稿skill-creator开发自定义 Claude 技能slack-gif-creator制作 Slack 适配的 GIFtheme-factory定制 UI 配色与主题web-artifacts-builder快速构建 Web 应用 / 组件webapp-testing自动化测试 Web 应用xlsx生成 / 处理 Excel 表格安装示例authropics官方推荐我们使用插件的方式安装skill,通过插件可以将上边所有的官方插件。注意authropics 将上述的技能都放在一个 document-skills中了安装完如上所有技能都安装完毕#添加官方插件/plugin marketplaceaddanthropics/skills# 安装所有官方插件/plugininstalldocument-skillsanthropic-agent-skills# 可以不安装 example 示范相关技能#/plugin install example-skillsanthropic-agent-skills#重新激活插件目前我这边不好使我使用了退出重启的方式/reload-plugins查看技能#查看技能/skills#删除example-skill/plugin uninstall example-skillsanthropic-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. **写入文件**将优化后的内容写回原文件 ## 调用方式技能创建创建存放技能目录在 创建 /.claude/skills// 目录 (用户级别) /${project}/.claude/skills// 目录 (项目级别)#创建目录mkdir-p~/.claude/skills/md-check放置技能内容到SKILL.md#创建SKILL.md vim ~/.claude/skills/md-check/SKILL.md #填充技能文档重启技能使用使用和官方SKILL用法一样4 SKILL编写规范4.1 文档格式字段是否必须中文说明简化name否技能的显示名称。若省略则使用目录名仅支持小写字母、数字和连字符最多 64 个字符。description是技能的用途和适用场景。Claude 会据此判断何时使用该技能若省略则取 Markdown 正文第一段。description和when_to_use合并后会被截断为 1536 字符以内。when_to_use否补充说明技能的触发条件如触发词、示例请求会追加到description中。argument-hint否自动补全时显示的参数提示如[filename]。disable-model-invocation否设为true时禁止 Claude 自动加载该技能只能通过/name手动触发。默认false。user-invocable否设为false用户不能嗲用。默认trueallowed-tools否技能激活时可直接使用、无需用户确认的工具列表支持空格分隔字符串或 YAML 列表。model否技能激活时使用的模型。effort否技能激活时的算力强度覆盖会话级设置可选low/medium/high/xhigh/max。context否设为fork时在独立子代理上下文运行。agent否context: fork时使用的子代理类型。hooks否技能生命周期的钩子配置。paths否只有文件路径 / 名称匹配规则时Claude 才会加载这个技能支持逗号分隔字符串或 YAML 列表。shell否技能中!命令和 !块使用的 Shell默认bashbr/Windows 下可选powershell需配合CLAUDE_CODE_USE_POWERSHELL_TOOL1。4.2 参数占位变量名说明中文翻译 简化$ARGUMENTS调用技能时传入的所有参数。如果内容中未使用此变量参数会以ARGUMENTS: value的形式追加。$ARGUMENTS[N]按 0-based 索引访问指定参数例如$ARGUMENTS[0]代表第一个参数。$N$ARGUMENTS[N]的简写形式例如$0代表第一个参数$1代表第二个参数。${CLAUDE_SESSION_ID}当前会话 ID。可用于日志记录、创建会话专属文件或关联技能输出与会话。${CLAUDE_SKILL_DIR}技能SKILL.md文件所在的目录。插件技能中为插件内的技能子目录而非插件根目录。可在命令中引用技能自带的脚本或文件不受当前工作目录影响。4.3 相关问题技能未触发自然语言没有提及工具描述对应的关键字技能描述的有问题该技能设置不允许模型调用disable-model-invocationtrue技能频繁触发描述要更具体一些。disable-model-invocation: true设置只手动调用5 开源skills平台5.1 哪里找skills网站名称网址主要特点SkillsMPhttps://skillsmp.com/zh中文界面友好支持语义搜索与分类筛选可在线预览技能源码提供一键安装命令社区聚合型平台claudeskills.infohttps://claudeskills.info/高质量精选技能中文说明清晰附带使用示例兼容多种 AI 工具skills.shhttps://skills.sh/按真实使用量排名权威可靠支持一键安装命令遵循标准化技能规范claudate.comhttps://claudate.com/全球大型 Claude 专属技能市场内置安全扫描支持多语言与自定义技能生成5.2 编程相关skills技能名称主要用途code-clean代码格式化、重构、规范命名与注释bug-finder扫描代码隐患、定位逻辑漏洞与异常问题git-helper生成 commit 信息、处理冲突、提供 Git 命令api-doc-generator自动生成接口文档支持 OpenAPI / Markdowntest-case-maker自动生成单元测试与边界测试用例performance-check分析性能瓶颈优化代码执行效率code-translate多语言代码互转保持逻辑与结构一致sql-optimizerSQL 语句优化、索引建议、执行计划分析6 skill杂谈6.1 SKILL优化优化维度优化内容对你的好处触发机制优化自动匹配意图、按 description/when_to_use 智能判断支持 paths 按文件类型触发支持 disable-model-invocation 关闭自动触发不乱调用、不漏调用技能更听话上下文加载优化技能元数据只在需要时注入上下文未调用的技能不占 tokenscripts / 资源按需读取不占上下文速度更快、更省 token、不卡上下文独立上下文隔离context: fork 用子代理独立运行只返回结果摘要不污染主对话长任务不爆上下文、主会话更干净模型智能调度支持按技能指定模型Opus/Sonnet/Haiku执行完自动切回默认模型复杂任务用强模型、简单任务省成本执行效率优化支持异步执行、并发控制、结果缓存 cached避免重复计算 / 重复请求运行更快、更稳定、更少冗余技能描述自动优化skill-creator 自动优化 description提升触发准确率官方数据 83.3%不用反复调提示技能一写就准工程化验证优化内置触发评估、质量评估、A/B 测试、基准对比技能可测试、可迭代、可上线插件化加载优化插件统一管理、热重载 /reload-plugins、不重启会话即可更新技能开发调试更快、不用反复重启权限与工具控制allowed-tools 限定可用工具user-invocable 隐藏不需要的技能更安全、界面更干净变量与模板优化ARGUMENTS、${CLAUDE_SKILL_DIR} 等变量自动注入支持脚本复用写技能更简单、路径不写错同时提供规范化方式开发使用skills, 从而获取更准确的输出。