teach it new tricks
WoowTech Skill 手冊

裝一顆 Skill，Pi Agent 立刻多會一件事

Skill 是給 AI 看的「工作手冊」：一個資料夾、一份 SKILL.md，裝進去它就會照著做。這本手冊幫你把網路上最熱門的開源 skill 挑好、講清楚、附上安裝指令——先裝別人做好的，再學著寫自己的。

調查基準：本冊的集合規模與維護狀態為 2026-08-20 調查當日的 GitHub 公開數據，會隨時間變動；安裝前建議點進原始 repo 再確認一次。

Skill 是什麼，為什麼要裝

把 Pi Agent 想成一位很聰明的萬事通助理：什麼都能聊，但「你家的做事方法」它不會通靈。Skill 就是教鐘點阿姨的工作手冊——把「遇到什麼情況、照什麼步驟做」寫成一份 Markdown，放進技能資料夾，它遇到對應情況就會翻出來照做。

  • 裝別人寫好的：文件處理、簡報、研究、設計……開源社群已經寫好上千顆，裝了就會。
  • 之後寫自己的：家裡的獨門流程（出週報、冰箱盤點）也能包成 skill，做法見第 16 章。

Skill 的原理（怎麼被掃描、怎麼進 system prompt、AI 怎麼決定用不用）在第 14 章有完整說明，這本手冊專注在「挑哪些、怎麼裝」。

怎麼裝（3 分鐘版）

完整圖解在第 15 章，這裡是速查版：

  1. 打開 pi-web 的 Skills 面板

    HA 側邊欄 → Pi Agent 工作區 → 切到 Skills 面板。

  2. 貼上 package spec，按 Install

    本冊每個項目都附好可以直接貼的 spec。合法寫法：

    # GitHub repo（最常用）
git:github.com/anthropics/skills
# 釘住版本（tag 或 commit，建議正式環境用）
git:github.com/anthropics/[email protected]
# npm 套件
npm:@scope/some-skill
# 本地路徑（自己寫的 skill）
/data/pi-agent/skills/my-skill

  3. Reload session 驗證

    裝完按 Reload session（或開新 session），問它「目前載入了哪些 skill？」確認有進到清單。

  4. 用一句話觸發測試

    照該 skill 的 description 講一個對應需求，確認它真的會拿出來用。

提示：多 skill 的 monorepo（例如 anthropics/skills）整包裝進去，Pi 會遞迴掃描全部 SKILL.md。只想要其中一顆時，實務做法是 clone 下來後用本地路徑指向那個子資料夾——git spec 目前沒有「只裝子目錄」的語法。

精選十顆（家庭視角）

從熱門集合裡替家庭用戶挑出來的實用款，由「最對口」往下排：

Skill它幫你做什麼安裝 spec
home-assistant-manager 讓 agent 直接管理 HA：寫自動化、看 log、做儀表板。最對口也最高風險——會動線上設定，先在測試環境驗證。 git:github.com/komal-SkyNET/claude-skill-homeassistant
docx / pdf / pptx / xlsx 官方文件四件套：家庭記帳表、掃描 PDF 抽字、產 Word、做簡報。 git:github.com/anthropics/skills
skill-creator 讓 AI 幫你把家裡的流程寫成新 skill（搭配第 16 章）。 git:github.com/anthropics/skills
last30days 給一個主題，橫掃近 30 天的 Reddit／X／YouTube 整理成報告——家庭採購、旅遊研究神器。 git:github.com/mvanhorn/last30days-skill
defuddle 把網頁擷取成乾淨 Markdown，省 token——食譜、文章存進家庭筆記最好用。 git:github.com/kepano/obsidian-skills
frontend-slides 用網頁技術做漂亮簡報，不吃 Office 工具鏈，add-on 容器內好跑。 git:github.com/zarazhangrui/frontend-slides
ui-ux-pro-max 給 agent 專業 UI/UX 知識，自訂儀表板、家庭頁面更好看。注意：skill 放在 .claude/skills/ 非標準位置，掃不到就 clone 後用本地路徑裝。 git:github.com/nextlevelbuilder/ui-ux-pro-max-skill
planning-with-files 長期專案用檔案持久化計畫，session 斷了也不失憶——慢慢做的家庭工程適用。 git:github.com/OthmanAdi/planning-with-files
hallmark 反「AI 味」設計守則，讓產出的頁面、圖卡不像模板垃圾。 git:github.com/Nutlope/hallmark
grill-me 動工前被 AI 連環拷問，把需求問到清楚才開工——裝修、旅行等大計畫都適用。 git:github.com/mattpocock/skills

八大熱門集合

想一次裝一整包、或自己逛著挑，從這八個入口開始：

anthropics/skills

官方示範＋規格所在地 · ≈17 萬★ · 活躍

Agent Skills 規格與官方 template 的家。19 顆 skill 含文件四件套（docx/pdf/pptx/xlsx）、canvas-design、mcp-builder、skill-creator。家庭用戶第一包就裝這個。

git:github.com/anthropics/skills

注意：文件四件套為 source-available 非開源；部分 skill 附 scripts 需要 Python／JS 環境。

obra/superpowers

開發方法論框架 · ≈27 萬★ · README 明列支援 Pi

14 顆紀律型 skill：brainstorming、TDD、systematic-debugging、writing-plans。適合會寫點程式、想把開發流程紀律化的人。

git:github.com/obra/superpowers

注意：完整體驗依賴 hooks（pi 上可能退化）；內建遙測可用環境變數關閉。

mattpocock/skills

Skills For Real Engineers · ≈22 萬★ · 極活躍

grill-me、tdd、diagnosing-bugs、handoff、teach——工程向為主，但 grill-me／handoff 對任何規劃型任務都好用。純 Markdown、標榜跨模型可用。

git:github.com/mattpocock/skills

skill 分放在 skills/engineering 與 skills/productivity 兩層，Pi 遞迴掃描抓得到。

kepano/obsidian-skills

筆記／生活紀錄 · ≈4.7 萬★ · Obsidian CEO 出品

5 顆：obsidian-markdown、bases、json-canvas、obsidian-cli、defuddle。用 Obsidian 做家庭知識庫的人必裝；defuddle 不用 Obsidian 也好用。

git:github.com/kepano/obsidian-skills

obsidian-cli 需本機裝 CLI，add-on 容器內以 vault 資料夾操作為主。

tonylofgren/aurora-smart-home

智慧家庭專門 · ≈102★ · 小眾但最對口

目前唯一找到的智慧家庭多 skill 集合：home-assistant、esphome、node-red、ha-dashboard-design、ha-integration-dev。

git:github.com/tonylofgren/aurora-smart-home

注意：星數少＝審閱的人少，它會指導 agent 改你的 HA 設定——匯入前自己把 SKILL.md 讀一遍。

coreyhaines31/marketingskills

行銷／文案 · ≈4.5 萬★ · 49 顆

copywriting、seo-audit、emails、social、launch、pricing。小生意、自媒體、接案族的垂直包；寫社群貼文、二手拍賣文案也用得上。

git:github.com/coreyhaines31/marketingskills

ComposioHQ/awesome-claude-skills

策展清單＋自帶部分 skill · ≈7.3 萬★

1000+ 條目的入口站：文件處理、資料視覺化、發票整理、履歷客製、會議逐字稿。當目錄逛，點進去裝各原始 repo。

# 當清單用，不建議整包安裝
https://github.com/ComposioHQ/awesome-claude-skills

品質參差、不少條目綁 SaaS 帳號，逐顆檢視再裝。

VoltAgent/awesome-agent-skills

跨 agent 純索引 · ≈3.1 萬★

只收官方團隊出品：Anthropic 全系列、openai/slides、Google Workspace、remotion（程式化影片）、cloudflare。想找「有品牌背書」的 skill 從這裡查。

# 純索引，照連結裝各原始 repo
https://github.com/VoltAgent/awesome-agent-skills

備查：影片產製系統 calesthio/OpenMontage（≈4.9 萬★，AGPL、依賴重，add-on 容器多半跑不動）、科研向 K-Dense-AI/scientific-agent-skills、資安向 mukul975/Anthropic-Cybersecurity-Skills。

相容性須知

SKILL.md 規格已被 Claude Code、Codex、Gemini CLI、Cursor、OpenCode 與 Pi 等採用，純 Markdown 的 skill 幾乎到處能跑。會「退化」的只有三種情況：

  • 依賴 Claude Code 專屬機制（hooks、plugin 指令、subagent 派工）——skill 本文仍可讀，但自動觸發行為可能不完整。
  • 依賴特定 MCP／SaaS 帳號——沒接那個服務就沒用，裝前看清楚前置需求。
  • scripts/ 需要容器內沒有的 runtime——Woow HA Pi Agent 的容器環境要特別注意這條；純 Markdown skill 相容性最好。
觀念：挑 skill 的第一準則不是星數，是「它假設的環境你有沒有」。

安全守則

注意：Skill 的本質是「餵給 agent 的指令」。裝第三方 skill＝讓一段陌生文字指揮你家的 AI。
  • 先讀後裝：安裝前把 SKILL.md 打開讀一遍，或叫 Pi Agent 先讀給你聽：「先讀這顆 skill 的內容，告訴我它會做什麼、有沒有風險，我同意再裝。」
  • 會動 HA 的先進測試機：像 home-assistant-manager 這類會改線上設定的，先在測試實例驗證。
  • 正式環境釘版本：用 @tag 或 @commit 釘住，避免上游改內容你無感升級。
  • 星數＝人氣，不＝安全：熱門集合一樣要看它拿什麼權限做什麼事。

SKILL.md 規格速查

一顆 skill 的最小骨架（寫自己的 skill 看第 16 章）：

fridge-check/
└── SKILL.md          ← 唯一必要檔案

# SKILL.md 內容
---
name: fridge-check
description: 使用者傳冰箱照片時，列出食材、找出臨期的、建議晚餐菜色。
  也在使用者問「今天煮什麼」「冰箱還有什麼」時觸發。
---

# 冰箱盤點
（給 agent 看的做法說明，寫得像教新同事）
欄位必填說明
name是小寫英數與連字號，1–64 字元。
description是做什麼＋何時用。AI 靠這行決定要不要載入，把使用者會講的話寫進去。
license / compatibility / allowed-tools否授權、相容性標注、工具白名單等選填欄位。

慣例：SKILL.md 保持精簡，附件放 references/、scripts/、assets/，用到才讀，避免吃爆 context。

常見問題

裝了但完全沒反應？
先 Reload session 或開新 session（skill 是 session 開始時載入的）。再問它「目前載入了哪些 skill？」確認有進清單；有進但不觸發，多半是 description 沒涵蓋你的講法——直接點名：「用 ○○ skill 幫我做這件事」。
skill 裝太多會怎樣？
每顆 skill 的名稱與描述都會佔 system prompt 的 context，裝幾十包會讓 AI 分心也變貴。原則：常用的留著，試玩過不用的就移除。
怎麼更新、怎麼移除？
Skills 面板可直接移除；git 來源沒釘版本時重新安裝會抓最新，正式環境建議 @tag 釘住、要升級時自己改 tag。詳見第 15 章。
附 scripts 的 skill 在 add-on 容器跑不動？
先確認容器內有沒有該 runtime（Python 套件、Node 等）。跑不動不代表 skill 全廢——Markdown 部分的知識還是會被 AI 用上；真的需要 scripts 的，挑純 Markdown 的替代品通常更省事。
可以只裝 monorepo 裡的其中一顆嗎？
git spec 目前沒有子目錄語法。實務做法：clone 到本機，把想要的那顆 skill 資料夾放到 /data/pi-agent/skills/，或用本地路徑安裝。

把這本帶走

整本是自包含單檔 HTML，下載後離線可開。集合資訊會過期，重要決定前回資源總覽看線上版。

下載本冊 HTML 回資源總覽