FILES / ONE SKILL, DIFFERENT PACKAGING

點 MD，與下載安裝包，
到底拿到什麼？

先把「內容、封裝、安裝」分開看。不是 ZIP 比 MD 聰明，也不是下載後電腦就多了一個 AI。

Prompt：這次要做什麼→MD：可重複的工作指引→ZIP：指引＋需要的附檔→安裝：讓平台找到並載入它

用做遊戲的例子來看

build-falling-blocks-game.md

裡面是文字：
- 這項技能能做什麼
- 先確認什麼需求
- 如何處理旋轉、碰撞、消行、暫停與重玩
- 如何檢查與交付

可以閱讀、修改，或交給支援的平台讀取。但本例 MD 會提到附帶網站；只拿 MD，會少那個可改造的網站範例。

build-falling-blocks-game-codex.zip
└── build-falling-blocks-game/
    ├── SKILL.md       ← 同一份核心指引
    └── assets/
        └── index.html ← 完整可玩網站

解壓後會同時得到指引與範例。AI 可以讀指引，也能開啟範例改成你的主題。ZIP 是壓縮包，不是雙擊安裝程式。

這次的 prompter 課堂版全部做法都寫在 MD 裡，沒有必要附檔。所以 MD 已包含完整工作指引；ZIP 只是依平台要求整理相同內容，並不會多一個模型或更高能力。

兩個網站 Skill 則不同：完整 ZIP 多了 source/技能名稱/assets/index.html。因此要沿用範例網站，請下載整包。

簡單記：一張食譜也可以完整教你做菜；如果食譜說「使用附帶模具」，只拿食譜就會少模具。MD 是食譜，ZIP 能把食譜和附件一起裝好。

選哪個下載	ZIP 內結構	下載後做什麼	怎麼叫它工作
Codex ZIP	`技能名稱/SKILL.md` 附檔放同資料夾內	解壓，將完整技能資料夾放進 `~/.agents/skills/`；或目前專案的 `.agents/skills/`。已使用舊版 `~/.codex/skills/` 的環境先確認實際探索位置，避免同名重複。	重新載入／重啟後，輸入 `$build-falling-blocks-game` 加任務。使用「/skills」或環境技能清單核對是否出現。
Google Gemini ZIP	根目錄 `SKILL.md` `source/技能名稱/assets/index.html`	Google Gemini → Customize → Skills → Upload → 選 ZIP → 檢查 → Create。Google 官方也支援單獨 SKILL.md；本例有範例網站，建議整包。	在對話／任務輸入 `/` 或新版 `@` 選技能，再說需求。可用工具依帳號與平台開放。
Claude ZIP	技能資料夾內 `SKILL.md` `source/技能名稱/assets/index.html`	Claude → Customize → Skills → 上傳 ZIP 並啟用；確認程式執行與檔案建立功能可用。這是與 Google Gemini 不同的平台。	啟用後指定技能名稱並輸入任務；Claude Code 使用完整技能資料夾。

Gemini CLI 是終端機工具，另有 gemini skills install 與 ~/.gemini/skills/；本頁「Google Gemini ZIP」是 Google 網頁／App 的上傳格式，不要把兩種方式混在一起。

同名舊版先備份、比較；不要同時裝兩份同名技能。下載網站 ZIP 的位置與安裝目的地不同，請放對完整資料夾。

把 MD 貼到一般對話，是「這次依文字指引做事」；未儲存成 Skill，就不代表下次仍會自動載入。安裝 Skill 也不會額外開通 API、帳號或付費功能。

格式文件查核：2026-10-17。已核對本次九個 ZIP 的入口、附檔與 SHA-256；尚未在 Google Gemini、Claude 的登入帳號內執行上傳與觸發。