【Claude code】创建自定义skill

一. 编写SKILL.md

复制代码
# 进入项目根目录

mkdir -p .claude/skills/my-custom-skill

cd .claude/skills/my-custom-skill

touch SKILL.md

最小 Skill 只需要一个目录 + SKILL.md,完整结构可扩展:

复制代码
.claude/skills/your-skill-name/
├── SKILL.md          # 必需:技能元数据 + 指令
├── scripts/          # 可选:可执行脚本(Python/Bash/JS)
│   └── helper.py
├── templates/        # 可选:代码/文档模板
│   └── component.tsx
├── references/       # 可选:参考文档
│   └── api-spec.md
└── examples/         # 可选:输入输出样例
    └── usage.md

二、编写 SKILL.md(核心)

SKILL.md 分两部分:顶部 YAML 前置元数据 + Markdown 指令体Claude

Markdown 正文是Metadata之后的第二级细节信息。Claude 会在读取元数据之后,根据任务需要再去读取这部分内容。根据你的任务场景,Claude 可以访问 Skill.md 文件并使用这个 Skill。

  • 先读 YAML 元数据(最上层)

    • name / description / user_command 等
    • Claude 先靠这些快速判断:要不要启用这个 Skill
  • 再读 Markdown 正文(第二层)

    • 只有在确定要用这个 Skill 之后
    • Claude 才会去读你写的具体步骤、规则、示例、命令等

Example Skill.md -- Brand guidelines skill

复制代码
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents

## Overview
This Skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.

## Brand Colors

Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typography

Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt

## Logo Usage

Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.

## When to Apply

Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients

## Resources

See the resources folder for logo files and font downloads.

三. 触发skills:

1. 自动触发

Claude 根据对话内容 + description 关键词自动匹配并加载 Skill。

  1. 手动触发(斜杠命令)

    /my-custom-skill

3.查看已加载 Skill

复制代码
# 查看所有可用 Skill
/skills list
# 查看 Skill 详情
/skills info react-component-generator

尝试写了一个检测当前python环境并根据当前代码安装不存在package的skill:

复制代码
## Metadata
name: pip_install_skill
description: 根据代码检测需要安装的python包,并根据当前环境进行pip安装 : 根据代码检测需要安装的python包,并根据当前环境进行pip安装
## Overview
根据当前代码检测需要的python包
获取当前python与pip环境
根据当前环境使用pip安装不存在的python包
可使用pip install xxx -i https://pypi.tuna.tsinghua.edu.cn/simples 加快下载速度

参考:https://support.claude.com/zh-CN/articles/12512198-%E5%A6%82%E4%BD%95%E5%88%9B%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89%E6%8A%80%E8%83%BD

相关推荐
ZhengEnCi12 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程
Karl_fang12 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
ZhengEnCi13 小时前
AI 规则越多越费 Token:无关规则让每次回答多耗 46% 的规则体检提示词
aigc·ai编程·claude
谭光志13 小时前
如何让 AI 高效工作
前端·后端·ai编程
ServBay13 小时前
连AI自己也不愿意维护自己的屎山代码
后端·ai编程·claude
袋鼠云数栈UED团队13 小时前
Agent外循环实践:如何编排任务、验证结果并可靠交付
ai编程
IT规划师15 小时前
热点速递 | AI 代码之争:道德讲许可,法律讲版权
ai编程
文谦南宁AI普工15 小时前
把 eval 做成发布门禁:配对检验 + 三档判定,一个不到 200 行的纯标准库实现
agent·ai编程·产品
框架那些事儿15 小时前
深入 Pi 源码:一个优秀的 Agent,是如何管理上下文的?
人工智能·ai编程·全栈
小虎AI生活15 小时前
最近爆火的 Chrome 新 skill 装进 WorkBuddy,AI 写代码起飞了
aigc·ai编程