Convex native skills
Version baseline: Current stable Convex platform and npm package, with configurable Node.js runtimes 20, 22, and 24 supported by current Convex documentation.
Inspect before installing
- Read the lockfile,
convex.json, generated API, and the installedconvexpackage version. - Identify the development or production deployment without printing deploy keys or environment values.
- Inspect project and user skill directories and any existing Convex skills.
- Read the current Convex Agent Skills documentation and first-party
get-convex/agent-skillsrepository.
Enforce compatibility
- Compare each selected native skill with the installed Convex package and current generated API conventions.
- Check Node-runtime guidance against
convex.json; accept only currently supported 20, 22, or 24 targets. - Reject legacy function registration, missing argument validators, table scans presented as scalable queries, or deployment commands that omit the target.
- Treat migration and deployment skills as potentially state-changing; installing instructions does not authorize executing their procedures.
- Do not upgrade Convex, regenerate APIs, modify runtime configuration, or deploy merely to match the native skill.
Install only on request
Use the documented selector:
npx skills add get-convex/agent-skills
Install every first-party skill only when explicitly requested:
npx skills add get-convex/agent-skills --all
Prefer the convex router and only the task-specific skills needed, such as quickstart, auth, migration, component creation, or performance audit. Let the user choose agent and scope; do not overwrite an existing skill without approval.
Verify
Locate each installed skill and report its name, first-party source, destination, scope, revision or release, project package/runtime versions, and compatibility result. If the upstream skill is newer than the installed package, distinguish instructions that remain compatible from those that require an application upgrade.