01 · 技能：一個資料夾就是一種能力

技能是 OpenDesign 的核心。一個技能就是一個裝著 SKILL.md 的資料夾，裡面寫清楚這類活該怎麼做。

關鍵不在官方提供了多少個，在於它的形狀：純 Markdown，你能加，也能拿走。

官方庫裡有什麼

按官方的分類，外掛庫裡的「Skills」這一類目前 23 個，是純指令型的——文案、色彩理論、創意方向、頭腦風暴這類，輸出完全取決於你的輸入。

另外還有 292 個「Templates」，是可執行的模板，每個都帶一份 example.html。兩者的區別是：

	Skills	Templates
內容	純 SKILL.md 指令	指令 + 可執行的示例檔案
輸出	取決於你給的輸入	有一個視覺起點
數量	23	292
適合	需要判斷的活	需要起點的活

實際用的時候你不太需要區分，介面裡都在外掛庫裡。

一個技能長什麼樣

SKILL.md 裡通常包含這幾塊：

---
name: saas-landing
description: 面向 B2B SaaS 的落地頁。適用於……
craft: [accessibility-baseline, state-coverage, typography-hierarchy]
---

## 什麼時候用這個技能
（描述適用場景，讓 Agent 自己判斷該不該載入）

## 必須問清楚的
（這一段驅動需求表單——它問什麼，來自這裡）

## 頁面結構
（這類東西的標準骨架）

## 硬約束
（不能做的事）

## 驗收
（怎麼算做完了）

craft 那一行值得注意：技能宣告自己需要哪些 Craft 規則，Agent 載入技能時會把對應的規則一起裝進系統提示。所以品質底線是跟著技能走的，不用每次在提示詞裡重複。

什麼時候該寫自己的技能

一個判斷標準：同一類活你已經做了三次，每次的提示詞都八九不離十。

到這個程度，那份提示詞裡其實已經沉澱了你的判斷——你知道這類東西該有哪幾段、該問客戶什麼、什麼寫法一定不行。把它寫成技能，下次直接調。

反過來，做了一次覺得不錯就急著寫技能，通常會寫成一份很泛的東西，用起來還不如現場說清楚。

從一次成功的生成反推

最省事的寫法不是從頭寫，是讓 Agent 幫你反推：

剛才那次生成的效果我很滿意。請把這次的做法固化成一個 SKILL.md。

要包含：
1. 這個技能適用於什麼場景，不適用於什麼。
2. 生成前必須問清楚的資訊（這部分會驅動需求表單）。
3. 這類產物的標準結構。
4. 這次我們做對的那些具體判斷——把它們寫成規則。
5. 硬約束：什麼絕對不能做。
6. 驗收標準。

寫完之後告訴我，哪些地方你是從這一次的上下文裡推斷的，
可能不適用於下一次。

最後那一問很重要。從單次成功反推出來的技能，容易把偶然當必然。讓它自己標出來，你再判斷哪些該留。

把技能抽出去用

技能是資料夾，所以能往外帶。

你可以把一個技能從 OpenDesign 裡拿出來，直接丟進自己的 Claude Code 或者 Codex 會話當上下文。適合兩種情況：你要的能力在介面裡沒有對應入口；或者你在寫自動化腳本，不想開 GUI。

這也是「換 Agent 不返工」的實際含義——技能跟 Agent 無關，跟 OpenDesign 也沒有強繫結。

一個實際的例子

假設你每個月都要做一份產品月報，結構固定：核心指標、三件做完的事、兩個問題、下月計劃。

第一次你寫了一長段提示詞，效果不錯。第三次之後，把它寫成技能：

技能的骨架

---
name: monthly-product-report
description: 團隊內部產品月報。固定四段結構，面向不看細節的管理層。
craft: [accessibility-baseline, typography-hierarchy, state-coverage]
---

## 什麼時候用
內部月報、週報、雙週報。不適用於對外發布的材料。

## 必須問清楚的
- 本月的核心指標有哪些，數值是真實的還是待補
- 做完的事裡，哪一件是這個月最重要的
- 問題那部分，是要暴露還是要帶解法一起說
- 讀者是否需要上下文（新加入的管理層 vs 一直在跟的）

## 結構
1. 一句話總結（這個月的判斷，不是流水賬）
2. 核心指標，最多 4 個，每個帶環比
3. 做完的事，最多 3 件，按重要性排
4. 問題，最多 2 個，每個帶下一步
5. 下月計劃，最多 3 條

## 硬約束
- 指標缺資料時寫「待補」，不要估算
- 不要寫「持續最佳化」「穩步推進」這類沒有資訊的短語
- 每一段都要能被刪掉而不影響其他段的理解

## 驗收
- 一個沒參加過任何會議的人能不能讀懂
- 每個數字能不能說出來源

之後每個月只需要給它這個月的資料。

常見坑

坑	表現	怎麼辦
技能寫太泛	跟不用技能差不多	寫具體的判斷，不是通用流程
把一次性的東西寫進去	下次全不適用	讓它標出「這次特有」的部分
技能太長	Agent 抓不住重點	一個技能管一類活，別做萬能的
忘了宣告 craft	品質底線沒兜住	frontmatter 裡把需要的規則列上

相關

• 02 · 設計系統 — 技能管流程，設計系統管長相
• 04 · Craft — 技能宣告的那些規則具體是什麼