claude code skills
Claude Code Skills 是可复用的标准操作流程(SOP),通过 Markdown 文件定义,让 Claude 在特定场景下自动或手动执行标准化任务,提升协作效率与稳定性 。根据 Anthropic 官方文档,Skills 核心由 YAML 元数据与 Markdown 指令组成,支持全局或项目级配置 。创建与文件结构
[*]存储路径:
[*]个人全局:~/.claude/skills/<skill-name>/,适用于所有项目 。
[*]项目共享:.claude/skills/<skill-name>/,仅当前项目生效,可提交版本控制 。
[*]核心文件:
[*]目录内需包含 SKILL.md,分为 YAML 头信息 与 Markdown 正文 两部分 。
[*]支持引用 references/、examples/ 等支持文件,实现渐进式加载以节省上下文 。
配置与调用机制
[*]YAML 关键参数:
[*]name:定义斜杠命令名(如 /commit)。
[*]description:决定 Claude 何时自动加载,需包含具体场景关键词 。
[*]allowed-tools:预设允许使用的工具(如 Read、Bash),无需每次授权 。
[*]user-invocable:设为 false 可隐藏命令,仅允许自动触发 。
[*]调用方式:
[*]手动:终端输入 / <name> 直接执行 。
[*]自动:当用户意图匹配 description 时,Claude 自动注入 Skill 上下文 。
[*]参数传递:通过 argument-hint 定义提示,Skill 内用 $ARGUMENTS 接收 。
最佳实践与示例
[*]描述具体化:避免“帮我写代码”等模糊描述,应写明“当用户提到重构或优化时触发”。
[*]官方示例:如 explain-code Skill,要求解释代码时包含类比、ASCII 图表及步骤 walkthrough。
[*]复杂任务拆分:长指令拆分为支持文件,保持 SKILL.md 简洁(建议 500 行以内)。
[*]
页:
[1]