安裝
npx skills add clerk/skills適合誰
當你要用編碼 Agent 更順暢地處理 Clerk 身分認證，尤其是給新專案或任意框架補上 Clerk，或對使用者、組織、應用、環境金鑰和部署做檢查時，使用這套技能。技能遵循 Agent Skills 格式，面向需要把 Clerk 接到程式庫、又希望 Agent 先選對技能再動手的開發者。官方把 /clerk 標成路由器，並寫明始終從這裡開始；不要一上來就點名某個子技能。開始前必須能打開 Clerk Dashboard 並拿到可寫入環境檔的金鑰，否則後續接入和檢查都會停在缺金鑰。
3 分鐘完成第一次嘗試
推薦只走官方倉庫給出的安裝命令：
npx skills add clerk/skills
裝好後先準備金鑰，不要用佔位符湊數。打開 Clerk Dashboard，複製可發佈金鑰與金鑰，寫入專案 .env，鍵名必須是 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 與 CLERK_SECRET_KEY。寫入前讓 Agent 只複述這兩個鍵名和目標檔，你確認後再允許改檔。
第一次任務選可逆檢查，而不是改框架。在已載入技能的用戶端裡輸入 /clerk，說明要做部署檢查或核對環境金鑰，讓路由把你帶到 clerk-cli。執行任何命令前，要求 Agent 說出將呼叫的是 CLI 檢查、不會新建使用者或改組織。確認後才執行。
成功訊號：Agent 從 /clerk 進入 clerk-cli，並回傳環境金鑰或部署檢查結果，而不是報缺失技能或缺失金鑰。若你用的是 Codex，官方另有市場新增命令，新增後需重啟、打開 /plugins、選擇 Clerk Skills、安裝並啟用 clerk-skills，再開新執行緒；那是 Codex 專用步驟，不要把它當成預設安裝。
使用案例
案例一：新專案或任意框架接入。官方技能 clerk-setup 的職責是把 Clerk 加到任意框架，適用於新專案和框架初始化。走法是先 /clerk，說明目前框架和「只新增 Clerk 接入」，再讓路由落到 clerk-setup。這類任務會改專案檔，必須先讓 Agent 列出將改動的檔案，你確認後再寫入。說明沒有給出具體框架清單或逐步補丁，框架細節以安裝後的技能說明為準。
案例二：用 CLI 做唯讀營運檢查。clerk-cli 覆蓋使用者、組織、應用、環境金鑰和部署檢查。適合在金鑰已寫入 .env 後，查現有應用是否可部署、金鑰是否齊全，或唯讀查看使用者和組織。同樣先 /clerk 再進入 clerk-cli。說明沒有列出具體 CLI 子命令，因此不要編造命令名；能確認的是上述檢查類別，輸出格式以實際執行為準。
使用邊界
沒有 Dashboard 金鑰就不要開始接入。環境檔只使用官方寫出的兩個鍵名，不要改成未記載的變數。預設安裝是 npx skills add clerk/skills；Codex 市場安裝只適用於 Codex，且必須按官方順序啟用 clerk-skills。始終從 /clerk 起步，頁面沒有把其他入口寫成可跳過路由。官方未列出完整用戶端名單，不能從 Codex 範例推斷獨家支援，也不能從頁面範例推斷語言範圍。未寫明的技能目錄、市場命令和金鑰樣例都不要補全。倉庫頁：
https://github.com/clerk/skills
Dashboard：
https://dashboard.clerk.com/