安装
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/