技能包

Convex Agent Skills:按常见 Convex 工作流调用技能

适合要做常见 Convex 工作流的任务;先装 get-convex/agent-skills,用顶层 convex 技能分流,认证搭建会改项目,先确认再执行。

官方来源 · Convex Agent Skills

安装

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 文件,先停住。

使用案例

案例一:从顶层 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 是占位写法,不是可安装的真实名字。

没有密钥步骤或卸载命令。未写出的数据库、部署和函数名单都不要补。