Gem To Skill Kit — Development skill for Claude Code

Gem to Skill Kit

把 Google Gemini 的 Gem 盤點、說明、挑選並升級成可重複使用的 Agent Skill。

這個 repo 主要給 Google AntiGravity／Gemini CLI 讀取，也可由 Codex、Claude Code、OpenCode 或其他能讀取 `AGENTS.md` 與 `SKILL.md` 的 Agent 使用。

交給 Agent 的一句話

請讀取這個 repo，依照導引幫我找到 Google Drive 裡的 Gem，先列出每個 Gem 的用途，再讓我挑選並升級成 Skill。

五階段流程

1. 安裝 Google Drive for desktop，完成並登入後才繼續。
2. 自動尋找 Gem 資料夾；找不到時，引導使用者手動選取並提供完整路徑。
3. 唯讀掃描每個 Gem，先列出名稱、原本用途與相關知識檔。
4. 由使用者挑選 Gem，再從 Agent 能力加值選單中選擇升級方式。
5. 產生標準 .agents/skills//SKILL.md，驗證後儲存到使用者指定位置。

Google／跨 Agent 格式

GEMINI.md                       Google Gemini CLI／AntiGravity 入口
AGENTS.md                       跨 Agent 通用入口與安全規則
ANTIGRAVITY.md                  AntiGravity 專用開工提示
.agents/skills/gem-to-skill/    可攜 Agent Skill
.gemini/commands/gem/upgrade.toml
docs/USER_FLOW.md               給使用者看的五階段流程
tests/                          不含私人資料的測試案例

Google Gemini CLI 會載入根目錄 `GEMINI.md`。其他 Agent 先讀 `AGENTS.md`，再啟用 `.agents/skills/gem-to-skill/SKILL.md`。

快速驗證

python .\.agents\skills\gem-to-skill\scripts\detect_environment.py
python .\.agents\skills\gem-to-skill\scripts\find_gem_folder.py
python -m unittest discover -s .\tests -v

隱私邊界

• 原始 Gem 資料夾永遠唯讀。
• 不把 Gem 指令、知識檔、Drive ID 或盤點結果提交 GitHub。
• 升級產物必須存到 Gem 原始資料夾之外。
• 讀取私密 Gem、建立檔案或安裝全域 Skill 前，Agent 必須先說明並取得同意。
• 本 repo 的 output/、.work/ 與盤點 JSON 預設不進 Git。

Google Drive 安裝

官方說明與下載：

https://support.google.com/drive/answer/10838124

Windows 或 macOS 安裝完成、登入正確帳號且能在檔案總管／Finder 開啟 Google Drive 後，再進行 Gem 尋找。

來源

新版延續 [gem-to-agent-kit](https://github.com/mathruffian-dot/gem-to-agent-kit) 的唯讀盤點概念，輸出目標改為標準 Agent Skill，並重寫為可停等、可選擇、可驗證的五階段流程。

授權：MIT