Skills
Skills 是 Claude 為了在專門任務上提升效能而動態載入的指令、腳本與資源資料夾。每個 Skill
的核心都是一個 SKILL.md 檔案——這是一組打包好的指令,您只需上傳一次,之後即可附加到任何
messages.create 呼叫中。您正在教 Claude 如何依照您的方式做某件事:您的狀態報告格式、您的審查清單、您的發布說明。Claude
會讀取 Skill、遵循該流程,並以您所設定的形式產生輸出。
Skills 與工具
值得釐清兩者的差異,因為它們解決的是不同的問題:
- 工具(Tools) 將 Claude 連接到資料與動作。「查詢這段程式碼」、「寄送這封電子郵件」——Claude 呼叫工具,由其他東西來執行。
- Skills 教導 Claude 一套流程。「依照這個範本產生每日狀態報告」——這是一份 Claude 會讀取並遵循的操作手冊,有時也意味著 Claude 會自行執行隨附的腳本。
一個簡單的記憶方式是:工具關乎 Claude 能做什麼,而 Skills 則關乎您希望如何完成。

還有一件值得了解的事:Skills 在啟動時不會完整載入上下文。一開始只會載入名稱與描述。當您的代理程式判斷某個 Skill 相關時,才會將完整的 Skill 載入上下文。這讓即使有許多 Skills 可用,您的上下文仍能保持精簡。
上傳 Skill
Skills 只需上傳一次到您的工作區,之後即可透過 ID 參照。您可以直接在 Claude Platform 上傳,或以程式化方式進行:
import anthropic
from anthropic.lib import files_from_dir
client = anthropic.Anthropic()
skill = client.skills.create(
display_name="Status Report Generator",
files=files_from_dir("status-report-skill"), # folder containing SKILL.md
)
print(skill.id) # reference this ID in future requests在這個範例中,我想要一個狀態報告產生器。一份好的狀態報告所需的所有規則——章節、語氣、如何摘要、如何處理阻礙事項——都預先打包在一個 Skill 中。活動紀錄本身只是請求時傳入的一個字串。
將 Skill 附加到請求
Skills 透過容器設定附加到請求——容器內有一個 skills 陣列,其中每個項目都指定一個 skill_id 與 version。以下是狀態報告產生器的完整呼叫:
response = client.messages.create(
model="claude-opus-5",
max_tokens=4096,
container={
"skills": [
{
"type": "custom",
"skill_id": skill.id,
"version": "latest",
}
]
},
tools=[
{
"type": "code_execution_20250825",
"name": "code_execution",
}
],
messages=[
{
"role": "user",
"content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
}
],
)有幾點值得特別說明:
- 我們呼叫的是標準的
client.messages.create,不需要 beta header。Skills 在 Claude API 上已正式發布(generally available),因此不再需要skills-2025-10-02這個 beta header;仍會傳送該標頭的請求會繼續照常運作。 container.skills是 Skill 附加的位置。它是一個清單,因此您可以在單一呼叫中疊加多個 Skills。- 這裡也開啟了程式碼執行(Code execution)。這是必要的:在 API 上,Skills 會在程式碼執行工具的容器內執行,這正是讓 Skill 流程能夠實際執行工作的原因——例如在終端機中執行腳本。
執行結果
輸出結果是完全依照 Skill 所指定格式產生的狀態報告。章節、語氣、阻礙事項的處理方式——這一切都來自您上傳的 SKILL.md 檔案。使用者提示只有一行;流程則存放在 Skill 中。

在正式上線的應用程式中,團隊就是以這種方式,在整個功能範圍內標準化輸出內容。透過這個每日狀態報告端點,每位 PM 都能得到相同的結構、相同的語氣、相同的章節,且順序一致——不需要任何人把範本複製貼上到提示中。

重點回顧
- Skills 封裝您的流程。 一個
SKILL.md檔案(加上任何腳本與資源)教導 Claude 如何依照您的方式完成某件事。 - 工具 vs. Skills: 工具關乎 Claude 能做什麼;Skills 關乎您希望如何完成。
- Skills 會漸進式載入。 啟動時只會載入名稱與描述;當代理程式決定使用時,完整的 Skill 才會載入上下文。
- 使用
client.skills.create上傳一次,然後在任何messages.create呼叫中透過container.skills附加——這是一個清單,因此您可以疊加多個 Skills。 - 當 Skill 的流程需要實際執行工作時,搭配程式碼執行使用。
- 當如何完成與做什麼一樣重要時,請選用 Skill。