openai/skills

Skills Catalog for Codex

這是什麼

openai/skills 是一個給 Codex 使用的 Agent Skills 目錄。README 對「Skill」的定義很直接：它是一個資料夾，裡面放著指令、腳本與資源，讓 AI agent 在需要處理特定任務時可以被發現並重複使用。換句話說，這個專案不是一般函式庫，也不是單一 CLI 工具，而是把任務知識打包成可分發、可安裝的能力單元。README 也特別說明，Codex 透過 skills 協助團隊與個人把能力封裝起來，讓同一套做法能在不同情境中被反覆套用。需要注意的是，README 開頭已標明 此 repository 已 deprecated，目前 Codex skill 與 plugin 範例應改看 OpenAI Plugins repository；若要新增自己的 skill，則應依照 Build plugins 指南建立 skill-only plugin。

為什麼上榜

這個專案今天仍以 25,607 stars、日增 46 stars 出現在榜上，重點不在於它還是最新入口，而在於「Agent Skills」這個概念本身正在被更多人重新理解：AI agent 不只需要模型能力，也需要可重複、可治理的工作流程封裝。openai/skills 的 README 用很少篇幅講清楚核心抽象：把 instructions、scripts、resources 放進一個資料夾，讓 agent 在任務中取用。它的爭議點也很明顯：專案已經 deprecated，所以它更像是歷史入口與概念索引，而不是新手今天應該直接依賴的主要安裝來源。這種「曾經是入口、現在指向新體系」的狀態，反而很適合拿來觀察 Codex 生態如何從 skills catalog 走向 plugins 與 open standard。

適合誰，可以拿來做什麼

這份 README 最適合三類讀者：第一，是正在理解 Codex skills 的開發者，可以用它快速抓到 skill 的基本結構與安裝概念；第二，是想把團隊內部 SOP、程式碼審查規範、文件產生流程等任務變成 agent 可重複能力的人；第三，是已經有舊 skills 使用經驗、需要確認遷移方向的人。若你今天要從零開始建立新 skill，README 明確建議不要只停在本 repo，而要看目前的 OpenAI Plugins repository 與 Build plugins 指南。也就是說，它適合拿來理解脈絡與名詞，不適合被當作唯一的最新實作手冊。

上手

README 提供的安裝方式主要針對 Codex 內的 $skill-installer。系統內建的 .system skills 會在最新版 Codex 自動安裝；curated 與 experimental skills 則可用安裝器加入，安裝後需要重新啟動 Codex 才會生效。

$skill-installer gh-address-comments

$skill-installer install the create-plan skill from the .experimental folder

$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan

實作前仍要記住 README 的 deprecated 提醒：新的 Codex skill 與 plugin 範例，應以 OpenAI Plugins repository 與 Build plugins 指南為準。

README 重點摘要

• 此 repository 已 deprecated；目前範例與新增 skill 的方向改指向 OpenAI Plugins repository 與 Build plugins 指南。
• Agent Skills 是包含 instructions、scripts、resources 的資料夾，用來讓 AI agent 執行特定任務。
• Codex 使用 skills 來封裝可重複的能力，方便個人或團隊分發與復用。
• .system skills 會在最新版 Codex 自動安裝；curated、experimental skills 可透過 $skill-installer 安裝。
• README 指向 Using skills、Create custom skills、Agent Skills open standard 等延伸文件；各 skill 的授權則看該目錄下的 LICENSE.txt。