從 SKILL.md 原理、18 條精選 skills、安裝流程到選用決策——把一次性 prompt 沉澱成可安裝、可重用、可驗證的工程資產。
2026 年的 AI coding agent 戰場，焦點已從「模型能不能答對」轉向「工作方法能不能被安裝、重用、驗證、團隊共享」。
過去你會把一段精心調教的 prompt 存在 prompts/ 資料夾，每次手動貼進對話。Agent Skill 把這件事變成第一公民：一個資料夾加一份 SKILL.md，agent 會在任務相關時自動發現並載入，無需你記得呼叫它。
OpenCode 內建原生的 skill tool，會掃描特定路徑、讀取 SKILL.md，並在任務相關時按需注入到 context——不是全程常駐。
關鍵優勢是「按需載入」（lazy loading）。傳統 system prompt 不論任務大小都全程佔用 context window；skill 只在 agent 判斷「可能相關」時才注入對應的 SKILL.md，其餘時間休眠。這對 pay-per-token 模式尤其關鍵。
最小可行的 skill 就是一個資料夾 + 一個 SKILL.md。YAML frontmatter 描述元資料，正文是給 agent 讀的指令。
| 欄位 | 用途 | 範例 |
|---|---|---|
name | skill 的唯一識別符（kebab-case） | code-review-buddy |
description | 觸發關鍵。agent 靠這段判斷是否載入 | 「提交前的自動 code review…」 |
allowed-tools | 限制此 skill 可用的工具白名單 | [Read, Bash] |
OpenCode 從以下路徑自動發現 skills，無需任何插件——把檔案放對位置即可。
| 作用範圍 | 路徑 | 適用場景 |
|---|---|---|
| 專案層 | .opencode/skills/ | 團隊共享、隨 repo 走 |
.claude/skills/ | Claude Code 相容路徑 | |
.agents/skills/ | 跨工具標準路徑 | |
| 全域 / 個人 | ~/.opencode/skills/ | 所有專案都可用 |
~/.config/opencode/skills/ | XDG 標準位置 |
# 複製到個人全域目錄，所有專案都能用 git clone https://github.com/hardikpandya/stop-slop.git \ ~/.opencode/skills/stop-slop # 或放進專案（會進版控、團隊共享） git clone https://github.com/obra/superpowers.git \ .opencode/skills/superpowers
# 從 Anthropic 官方 repo 指定單一 skill npx skills add https://github.com/anthropics/skills \ --skill frontend-design # 從社群 repo npx skills add https://github.com/vercel-labs/agent-skills \ --skill react-best-practices
// opencode.json { "plugin": [ "superpowers@git+https://github.com/obra/superpowers.git" ] }
Use the <skill-name> skill to ...，或在對話中提及該 skill 處理的任務類型，觀察 agent 是否自動套用。
以下是從 GitHub、Composio、Agensi、VoltAgent 等來源交叉篩選出的高實用性 skills，按「解決什麼問題」分六大類。
完整 agentic 開發方法論：brainstorm → plan → TDD → subagent 執行 → review。內建「1% 規則」。
建立、測試、基準測試 SKILL.md，把一次性 prompt 變成可重用套件。
強制 red / green / refactor 的測試驅動開發流程（Superpowers 內含）。
強制 agent 先選定美學方向再寫 UI，避免「紫色漸層 slop」，支援 React / Vue / HTML / CSS。
依「影響力」排序的 React/Next.js 效能規則：fetch waterfall、bundle size、RSC、memoisation。
Workers / Pages / D1 / R2 / KV / Vectorize 的產品決策樹，含 docs 與 changelog 指引。
Python Playwright 本地 web app 測試：server lifecycle、screenshot、DOM 偵察再行動。
偵測並分類 flaky 測試，協助在 pay-per-token 模式下避免無謂重跑。
提交前自動 code review，捕捉會演變成昂貴 debug session 的問題。
單一介面存取 1,000+ SaaS：GitHub、Linear、Slack、Stripe、Jira、Notion，免去多套 auth flow。
引導建構 MCP server（協議 + SDK + eval），把 eval 創建視為 build 的一部分。
移除文件中的 AI 寫作痕跡（filler、binary contrasts、em-dash），含五維評分量表。
10 秒內讓 repo 訪客判斷專案價值的 README 生成器。
自動產生 changelog 與 release notes。
以專業編輯角度審查 README、API docs、changelogs。
捕捉易受攻擊、過時、typosquat 的套件（供應鏈風險閘門）。
在 agent 執行前阻擋隱藏指令注入。
多 agent skill，模仿大腦預設模式網絡，在 Obsidian vault 中找非顯性關聯。Sonnet（generator）+ Haiku（critic），≥7.0 分才浮現，每跑約 $0.40–0.50。
18 條 skills 不必全裝。依你的角色與當前任務，沿這棵樹走一遍即可。
superpowers（方法論）+ composio（SaaS 整合）+ stop-slop（文件品質）+ skill-creator（自製）。四條涵蓋 80% 場景。
假設你的團隊有一套「commit message 規範」，每次都得口頭提醒 agent。把它做成 skill，一勞永逸。
# 建立專案層 skill mkdir -p .opencode/skills/commit-style # 編輯主檔 $EDITOR .opencode/skills/commit-style/SKILL.md
--- name: commit-style description: 當使用者要建立 git commit 或撰寫 commit message 時使用。強制 Conventional Commits 格式，禁止模糊訊息如 "fix bug" 或 "update"。 allowed-tools: [Bash, Read] --- # Commit Style Enforcer ## 何時觸發 使用者說「commit」「提交」「寫 commit message」時。 ## 格式規則 - 必須使用 Conventional Commits：`type(scope): subject` - type 限：feat / fix / docs / refactor / test / chore / perf - subject 用主動語態、小寫、不超過 50 字 - body 解釋「為什麼」而非「做了什麼」 ## 禁忌 - 不要用 "update"、"fix bug"、"misc" 等模糊詞 - 不要在 subject 句尾加句號 - 不要憑空編造 scope，要從變更的模組推導 ## 輸出 先讀取 `git diff --staged`，產出 1 條建議訊息，詢問使用者確認後再執行 commit。
git diff --staged 而非亂寫。description 是否寫得不夠明確。Agent Skill 不是新潮流，而是 AI 協作從「對話」走向「工程化」的關鍵一層。
superpowers + composio + stop-slop，跑一個真實任務感受差異。.opencode/skills/，團隊共享。description 那一行寫得多具體。