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.