安裝
npx skills add apollographql/skills適合誰
如果你已經在用 Apollo GraphQL 的工具，並且希望編碼 Agent 按官方技能來寫查詢、變更和快取，而不是憑記憶混用舊 API，這組技能更合適。它面向正在使用 Apollo 相關技術的 AI 編碼 Agent，遵循 Agent Skills 格式。格式說明見
https://agentskills.io/
技能也可在
https://skills.sh/
找到。它假定你接受一次交互式安裝：先選技能，再選目標 Agent。只想讀文件、不打算把技能寫進本機 Agent 的人，收益有限。嚮導裡會出現若干 Agent 名稱，那是安裝時的可選項，不要理解成「只有這些產品才能用 Apollo」。
3 分鐘完成第一次嘗試
官方安裝按頁面寫成這一條：
npx skills add apollographql/skills
CLI 會帶你做交互安裝：先選擇要裝的技能，再選擇目標 Agent。這會改本機 Agent 的技能設定，不是唯讀查看。執行前確認本機有 npx，並且你清楚即將寫入哪一個 Agent 環境。看完選項再確認，不要在不明環境裡一路按 Enter。
裝好後做一次唯讀核對。頁面寫到安裝後可透過帶命名空間的斜線命令使用，其中 /apollo-skills:apollo-client 對應 Apollo Client 4.x for React 的 queries、mutations、caching 和 local state。對 Agent 發出這條命令，或明確要求按該技能檢查一條已有查詢，先不要改業務程式。成功訊號是：回答按 Apollo Client 4.x / React 來談查詢或快取，而不是提示技能未安裝。若它開始重寫整個資料層，先停下來。
使用案例
案例一：檢查或起草 React 查詢與變更。/apollo-skills:apollo-client 的說明包含 queries 和 mutations。把一條現有 GraphQL 操作交給 Agent，只問「按 Apollo Client 4.x 在 React 裡該怎麼發」。摘錄沒有給出具體 hook 名，也沒有寫與其他 GraphQL 用戶端的對照。因此你能確認的是：這條技能涵蓋 Client 4.x 的查詢和變更；具體 API 必須以技能正文或你專案裡的 4.x 程式為準。不要讓它順便升級整個用戶端大版本。
案例二：核對快取與本地狀態。同一條技能還寫了 caching 和 local state。任務應是唯讀診斷，例如「這段快取鍵 / 本地狀態按該技能是否合理」。它沒有寫快取淘汰策略的完整清單，也沒有寫本地狀態必須用哪一種儲存。所以驗收只看到：討論落在 Client 4.x 的快取或本地狀態上；若 Agent 建議改 schema 或加新的連結中介軟體，已經超出這條摘錄。
使用邊界
這是 Apollo GraphQL 工具與技術的技能集合，不是通用 GraphQL 教程。離開 Apollo 生態去套用這些斜線命令，超出頁面寫出的範圍。斜線命令帶 apollo-skills: 前綴；摘錄完整描述的只有 /apollo-skills:apollo-client。其他命令即使存在，這份材料也沒有給出說明，不要自行補能力。
安裝路徑就是上面的 npx skills add 交互嚮導。不要並列另一套安裝器。嚮導會讓你選擇技能和 Agent；選錯環境意味著技能被寫進錯誤的執行時。頁面沒有寫解除安裝步驟。
第一次停在唯讀檢查。任何改查詢、改快取策略或升級 Apollo Client 的動作，都要先讓 Agent 複述將改的檔，你確認後再繼續。