Claude Skill

Claude Skill

Claude Skill

Claude Skill 是 [[anthropic]] 为其大语言模型 [[claude]] 推出的一套机制，用于将专业知识、流程偏好和领域技能封装在特定文件夹中，使 Claude 能够在后续对话中自动应用这些知识，而无需用户反复解释。

定义

Skill 是一套封装在特定文件夹中的指令集，旨在教会 Claude 如何处理特定的任务或复杂的工作流。它是 [[ai-skill]] 概念在 Anthropic 生态中的产品化实现。

核心设计原则

渐进式披露 (Progressive Disclosure)

为了节省 Token 并保持响应速度，Skill 采用三层架构：

  1. 第一层（YAML 前置元数据）：始终加载，让 Claude 知道何时该触发该技能。
  2. 第二层（SKILL.md 正文）：仅在任务相关时加载完整指令。
  3. 第三层（关联文件）：根据需要由 Claude 发现和引用的文档或脚本。

这一原则与 [[context-engineering]] 概念高度契合，是一种高级的上下文工程实践。

可组合性 (Composability)

Claude 支持同时加载多个 Skill，开发者应确保各个 Skill 能够协同工作，而非假设自己是唯一可用的能力。这要求 Skill 的设计具有模块化和低耦合性。

移植性 (Portability)

一套 Skill 可以无缝运行在 Claude.ai、Claude Code 以及 API 等多种环境下，确保用户在不同平台上的体验一致性。

标准文件结构

1
2
3
4
5
my-skill/
├── SKILL.md          # 必须：包含指令和 YAML 元数据的核心文件
├── scripts/          # 可选：Python、Bash 等可执行代码
├── references/       # 可选：API 指南等说明文档
└── assets/           # 可选：模板、图标等输出资产

YAML 前置元数据关键点

  • name 必须使用 kebab-case（如 my-skill-name）
  • description 必须包含"做什么"和"何时使用（触发词）"
  • 禁止使用 XML 尖括号 < >

测试方法

测试类型 目标 示例
触发测试 确保在正确场景下加载 针对同义词触发，对无关话题不触发
功能测试 验证输出的正确性 API 调用成功，无错误发生
性能对比 证明 Skill 优于原始 Prompt 对比 Token 消耗、对话轮次及 API 成功率

分发方式

  • 个人用户：压缩并上传至 Claude.ai 的设置页面
  • 企业团队：管理员进行全空间部署，实现自动更新与集中管理
  • 开发者：托管在 GitHub 上，附带 MCP 配合说明

常见问题

  • 无法上传：检查文件名是否拼错为 skill.md（必须全大写）
  • 不触发：检查 description 是否包含具体的触发短语
  • 不听话：避免过长指令，关键步骤应置顶或使用清晰的标题

与现有概念的关系

  • [[ai-skill]] — Claude Skill 是 ai-skill 概念在 Anthropic 生态中的产品化实现
  • [[context-engineering]] — 渐进式披露原则是上下文工程的高级实践
  • [[you-are-not-using-agent-you-are-leading-ai-junior-engineers]] — Skill 机制可作为管理"AI 初级工程师"团队的具体工具，通过封装标准操作流程（SOP）减少重复指导
分享到