安裝
npx skills add get-convex/agent-skills適合誰
需要讓代理處理 common Convex workflows 時,再裝這組技能。官方頂層入口是 convex:Top-level entry point for Convex work. Recommends installing Convex AI files, then routes to a more specific Convex skill。
適合已經在做 Convex、並願意先讓頂層技能推薦再進入具體流程的人。正文給出多種呼叫前綴:Cursor、VS Code (GitHub Copilot)、Claude Code 用 /skill-name,Windsurf 用 @skill-name,Codex (OpenAI) 用 $skill-name。這是呼叫寫法對照,不要理解成只支援這幾家。
頁面: https://github.com/get-convex/agent-skills
3 分鐘完成第一次嘗試
只走這一條主安裝命令:
npx skills add get-convex/agent-skills
前置條件:目前任務屬於 Convex 工作流程;你知道同一頁面還有 --all 變體,但第一次不要用。官方沒有寫出落盤目錄,不要自行指定路徑。
安裝後先做唯讀核對,不要跑認證建置。向代理確認:頂層 convex 技能做什麼,以及在你目前工具裡應使用哪一種前綴。成功訊號是代理覆述 recommends installing Convex AI files, then routes to a more specific Convex skill,並能對照表格說出 /skill-name、@skill-name 或 $skill-name 之一。若代理直接開始改認證或寫入未點名的 Convex AI files,先停住。
使用案例
案例一:從頂層 convex 入口開始。先呼叫該技能,讓它推薦是否安裝 Convex AI files,再路由到更具體的 Convex skill。這可能寫檔案,執行前先確認你接受它推薦的檔案安裝。頁面沒有寫出那些檔名,不要編造;只要求代理按原文推薦並分流。
案例二:啟動認證建置。官方示例是 For example, to kick off auth setup in Cursor or Claude Code: /convex-setup-auth。這會改專案認證相關內容,呼叫前先確認。成功訊號是代理按這條已寫出的命令開始 auth setup,而不是另造未出現的認證命令。其他具體技能名正文沒有寫出,不要補。
使用界線
同一段還寫了 npx skills add get-convex/agent-skills --all,註釋是 Install all skills。這是可選變體,不是第一次嘗試的主路徑。
呼叫前綴隨工具而變,按表格使用,不要把一種前綴推廣到所有環境。
除 convex 與 /convex-setup-auth 外,沒有其他技能名。表格裡的 skill-name 是佔位寫法,不是可安裝的真實名字。
沒有金鑰步驟或解除安裝命令。未寫出的資料庫、部署和函數名單都不要補。