WorkshopSkill活動資料夾

技能教程 · 代理

工作坊技能進 OpenAI Codex

Codex 讀技能的方式與 Claude Code 一致:~/.codex/skills/<name>/SKILL.md。WorkshopSkill 的包就是這個形狀——一條 curl 加一次解壓,沒有第三步。

安裝

裝兩個技能進 Codex

mkdir -p ~/.codex/skills cd "$(mktemp -d)" curl -LO https://workshopskill.com/zh-hant/activities/blind-portrait/files/blind-portrait.zip curl -LO https://workshopskill.com/zh-hant/activities/paper-tower/files/paper-tower.zip unzip -o '*.zip' mv blind-portrait paper-tower ~/.codex/skills/

(選作)用 AGENTS.md 帶路

如果備課固定在某個資料夾,替它的 AGENTS.md 加一段,讓每個 Codex 對話都知道抽屜在哪——技能本就自動載入,這段只是把話說明白:

AGENTS.md

# 工作坊備課 技能目錄在 ~/.codex/skills/。收到備課需求時, 先依 description 比對技能,再照 SKILL.md 的指令執行。 索引:https://workshopskill.com/zh-hant/skills.json

首跑

終端裡的一來一往

> 90 分鐘、15 人、沒有投影機,幫我備 Codex 拿需求過濾已裝技能,交出: 開場:兩真一假(15 分鐘,測評型) 主活動:紙塔(30 分鐘,3-5 人隊) 收尾:離場小票(3 分鐘,工具型,零帳號) 接著逐個跑 curl 步驟,依 props 欄位列採購清單

卡住了?

  • 技能太多?只留你常帶的類目,其餘一條 curl 就在 skills.html。
  • 沙箱擋網路?curl 步驟是匿名下載:放行,或自己跑完兩行下載再把目錄交給 Codex。
  • FormLM 登不進去?每個測評型 SKILL.md 裡都有無互動環境的降級說明。

接著讀

常見問題

Codex 從哪個版本開始支援技能?

2025 年起的 Codex CLI 支援 skills 目錄;如果你的建置還沒有,「貼上即可跑」那篇對所有代理通用。

一次對話能用多個技能嗎?

這就是設計用法:人數、時間、場地三個約束同時對準每個技能的 frontmatter 比對。

安裝會回傳什麼嗎?

不會。對 workshopskill.com 的 curl 是靜態檔案下載:免帳號、免金鑰、免遙測。