CSKILLBOX.COM
Index live 839 skills 112 authors 10 categories Sourced from SKILL.md

说明

Claude Skills 是什么

技能就是装着 SKILL.md 的文件夹:frontmatter 决定「做什么、什么时候用」,正文写具体步骤。本文讲清文件结构、加载条件、安装与写法。

  • 基础
  • 怎么写
  • 收录 839 个

一句话定义

技能就是一个装着 SKILL.md 的文件夹。文件分两部分:

---
name: pdf
description: 读取、拆分、合并并填写 PDF 文件。当任务涉及 PDF 时使用。
---

# PDF

代理要执行的步骤、检查项与示例…
  • frontmatter(name / description)是元信息,description 就是触发条件。
  • 正文是流程:做什么、按什么顺序、检查什么。
  • 需要时可以放脚本和素材,在正文里按相对路径调用。

Claude Code、Codex、Cursor 等代理会在需要时才加载技能,这正是说明文必须写准的原因。

代理怎么决定加载

代理拿你的请求去匹配 description。词汇对上了就加载,对不上就留在磁盘上。

失败通常只有两种:

  1. 描述太虚(「一个对文档有用的技能」)→ 永远匹配不上。
  2. 描述准确,但相邻技能更匹配 → 加载了别的技能。

所以装完先读描述,再用它的词汇提需求。

存放在哪

范围 路径 用途
个人 ~/.claude/skills/<name>/SKILL.md 所有项目通用
项目 <project>/.claude/skills/<name>/SKILL.md 只在当前仓库用

其他代理有自己的技能目录,CLI 会写到对应位置。

安装

npx skills add <owner>/<repo> --skill <name>

例如 npx skills add anthropics/skills --skill pdf。要指定代理就加 -a claude-code(或 -a cursor、-a codex)。详见安装指南。

自己写一个

  1. 只做一件事。 一件事做三样,三样都不会被触发。
  2. 写 frontmatter。 name 用短横线命名,description 写清「做什么 + 什么时候用」。
  3. 正文写成流程。 顺序、检查项、一个实例,不要写宣传语。
  4. 需要才加脚本,并用相对技能目录的路径引用。
  5. 测触发。 一个该触发的请求、一个不该触发的请求;误触发就先改描述。

发布前可以用SKILL.md 校验器检查结构。

技能 / MCP / 子代理

机制 给代理什么 何时加载
技能 方法(步骤与检查项) 描述匹配时
MCP 服务 连接(工具与数据) 会话开始时
子代理 隔离(独立上下文) 被委派时
斜杠命令 你主动调用的提示词 输入时

需要「访问」用 MCP,需要「方法」写技能。

Community notes

Found a broken install? Know a skill we missed?

One line is enough: the skill name, what happened, and the command you ran. We read every note and fix the index.