跳至主要內容

如何建立自訂技能

今日已更新

Custom Skills 讓您可以使用特定於您的組織或個人工作風格的專業知識和工作流程來增強 Claude。本文說明如何建立、結構化和測試您自己的 Skills。

Skills 可以簡單到只有幾行指示,也可以複雜到包含可執行程式碼的多檔案套件。最好的 Skills:

  • 解決特定的、可重複的任務

  • 具有 Claude 可以遵循的清晰指示

  • 在有幫助時包含範例

  • 定義何時應該使用它們

  • 專注於一個工作流程,而不是試圖做所有事情

建立 Skill.md 檔案

每個 Skill 都包含一個目錄,其中至少包含一個 Skill.md 檔案,這是 Skill 的核心。此檔案必須以 YAML 前置資料開始,以保存名稱和描述欄位,這些是必需的中繼資料。它還可以包含其他中繼資料、Claude 的指示或參考檔案、可執行指令碼或工具。

必需的中繼資料欄位

name:您的 Skill 的人類友善名稱(最多 64 個字元)

  • 範例:品牌指南

description:Skill 的功能及何時使用的清晰描述。

  • 這很重要—Claude 使用此資訊來判斷何時應該調用您的 Skill(最多 200 個字元)。

  • 範例:將 Acme Corp 品牌指南應用於簡報和文件,包括官方顏色、字體和標誌使用。

選用的中繼資料欄位

version:在您反覆運算時追蹤 Skill 的版本。

  • 範例:1.0.0

dependencies:您的 Skill 所需的軟體套件。

  • 範例:python>=3.8, pandas>=1.5.0

Skill.md 檔案中的中繼資料作為漸進式揭露系統的第一層,提供足夠的資訊讓 Claude 知道何時應該使用 Skill,而無需載入所有內容。

Markdown 正文

Markdown 正文是中繼資料之後的第二層詳細資訊,因此如果需要,Claude 在讀取中繼資料後將存取此內容。根據您的任務,Claude 可以存取 Skill.md 檔案並使用 Skill。

Skill.md 範例

品牌指南 Skill

## 中繼資料
name: 品牌指南
description: 將 Acme Corp 品牌指南應用於所有簡報和文件
version: 1.0.0

## 概述
此 Skill 提供 Acme Corp 的官方品牌指南,用於建立一致、專業的材料。建立簡報、文件或行銷材料時,應用這些標準以確保所有輸出與 Acme 的視覺識別相符。Claude 應在建立外部面向的材料或代表 Acme Corp 的文件時參考這些指南。

## 品牌顏色

我們的官方品牌顏色為:
- 主要:#FF6B35(珊瑚色)
- 次要:#004E89(海軍藍)
- 強調:#F7B801(金色)
- 中性:#2E2E2E(深灰色)

## 排版

標題:Montserrat Bold
正文:Open Sans Regular
大小指南:
- H1:32pt
- H2:24pt
- 正文:11pt

## 標誌使用

始終在淺色背景上使用全彩標誌。在深色背景上使用白色標誌。在標誌周圍保持最少 0.5 英吋的間距。

## 何時應用

在建立以下內容時應用這些指南:
- PowerPoint 簡報
- 用於外部共享的 Word 文件
- 行銷材料
- 客戶報告

## 資源

請參閱資源資料夾以取得標誌檔案和字體下載。

新增資源

如果您有太多資訊無法新增到單一 Skill.md 檔案(例如,僅適用於特定情況的部分),您可以透過在 Skill 目錄中新增檔案來新增更多內容。例如,新增包含補充和參考資訊的 REFERENCE.md 檔案到您的 Skill 目錄。在 Skill.md 中參考它將幫助 Claude 決定在執行 Skill 時是否需要存取該資源。

新增指令碼

對於更進階的 Skills,將可執行程式碼檔案附加到 Skill.md,允許 Claude 執行程式碼。例如,我們的文件 Skills 使用以下程式設計語言和套件:

  • Python(pandas、numpy、matplotlib)

  • JavaScript/Node.js

  • 幫助進行檔案編輯的套件

  • 視覺化工具

注意:Claude 和 Claude Code 可以在載入 Skills 時從標準儲存庫(Python PyPI、JavaScript npm)安裝套件。使用 API Skills 時無法在執行時安裝其他套件—所有相依性必須預先安裝在容器中。

打包您的 Skill

完成 Skill 資料夾後:

  1. 確保資料夾名稱與您的 Skill 名稱相符

  2. 建立資料夾的 ZIP 檔案

  3. ZIP 應包含 Skill 資料夾作為其根目錄(不是子資料夾)

是否回答了您的問題?