學習

學習 Agent Skills

簡短易懂的指南，從安裝第一個 Skill 到修復無法載入的問題——適用於 Claude Code、Codex 或 Cursor。

執行你的第一個 Skill 對比 Agents

無需帳戶相容主流 Agents已驗證安裝包

平台

你在用哪個 Agent？

同一個 SKILL.md 資料夾可跨 Agent 使用——選擇你日常使用的執行環境。

Claude Code

專案 Skills 與斜線命令

Codex

終端機原生 $skill-name

Cursor

Rules、Skills 與 Cloud Agents

對比三者

目錄、命令與命名規則

從這裡開始

新來的？先看這三篇

什麼是 Skill？

一組教 Agent 完成某一類工作的說明資料夾——例如製作簡報——核心是 SKILL.md。

瀏覽範例

快速上手

安裝一個免費 Skill，在 Agent 中執行，確認它完成了任務，再考慮自訂。

跑通一個 Skill

安裝 Skill

把資料夾放到 Claude Code、Codex 或 Cursor 能找到的位置——個人路徑與專案路徑因 Agent 而異。

查看安裝指南

深入了解

更好地使用你的 Skills

如何使用 Skills

給 Skill 提供什麼、如何檢查它產生的檔案，以及如何得到更好的第二稿。

Skills 如何被觸發

為什麼 Agent 會選中某一個 Skill，以及如何寫出更容易被選中的描述。

Skill 檔案結構

了解 SKILL.md、scripts/、references/，以及資料夾過深時 Agent 可能跳過它。

Skill 安全

安裝前檢查腳本，優先使用已驗證的包，避免執行不受信任的程式碼。

故障排除

Skill 不工作？對號入座

不在 /skills 裡

放錯了目錄，或 ZIP 多了一層。該 Agent 的路徑必須以 <name>/SKILL.md 結尾。

從不會自動執行

先用名稱明確呼叫，再收緊描述，讓 Agent 能辨識你的請求。

跑成了別的 Skill

描述重疊或名稱重複。把目標 Skill 的第一句話寫得更具體。

本機可以，雲端不行

個人目錄只在本機。提交專案 Skills、同步 Cursor Skills，或在 claude.ai 上啟用。

對比

Skills 與 MCP、提示詞、規則有何不同

為任務選擇合適的抽象——SkillsRadar 幫你發現並組合它們。

Skill

面向特定結果的可重用能力包。

按需載入
可跨 Agent 移植
適合可重複的工作

MCP

將 Agent 連接到工具與資料來源的協定。

即時工具存取
由伺服器支援
與 Skills 互補

提示詞

貼到對話裡的一次性說明。

上手快
難維護
容易漂移

AGENTS.md / 規則

每次執行開始時載入的簡短指引。

始終在上下文中
保持簡短
把流程放進 Skills

連接你的工具

一個帳戶，全部入口

從資料庫開始，在終端機或 Agent 中繼續，需要自訂整合時再用 API。

CLI

無需離開終端機即可搜尋、檢查、安裝、更新與掃描 Skills。

適合本機工作流程

查看安裝指南

MCP

連接 Cursor 或 Claude Desktop，讓 Agent 在對話中搜尋、推薦並說明如何安裝 Skills。

適合在 Agent 內發現

MCP 設定指南

API 與 SDK

把語意搜尋與推薦能力接入產品、腳本與自動化。

適合自訂整合

管理 API 金鑰

速查

命令速查表

斜線命令、$ 呼叫，以及 SkillsRadar CLI 安裝。

/skills

在 Claude Code 或 Codex 中列出 Skills

/skill-name …

在 Claude Code 或 Cursor 中執行 Skill

$skill-name …

在 Codex 中執行 Skill

npx @skillsradar/cli@latest install <slug>

預設 → ~/.agents/skills/（Codex、Cursor 等）

npx @skillsradar/cli@latest install <slug> --agent claude-code

安裝到 ~/.claude/skills/

npx @skillsradar/cli@latest login

瀏覽器登入 → 系統鑰匙圈

skillsradar-mcp

MCP stdio 伺服器——Cursor 設定見 /learn/mcp

完整 Agent 對比

位置

Skills 存放在哪裡

每個 Agent 讀取不同的目錄。把 Skill 放到它會查找的位置——或讓 SkillsRadar 的 --agent 旗標幫你選擇。

~/.agents/skills/共享預設（Codex、Cursor、Gemini CLI 等）

~/.claude/skills/Claude Code（需 --agent claude-code）

~/.gemini/config/skills/Antigravity

查看優先級規則

下一步

準備好探索已驗證的 Skills 了嗎？

瀏覽資料庫、依 Agent 篩選，或開啟 Claude Code、Codex、Cursor 的安裝指南。

探索 Skills Claude Code 指南