Convex Agent Skills

For AI agents: see llms.txt for the complete documentation index. Markdown versions are available by adding .md to a page URL or requesting Accept: text/markdown.

Agent Skills are portable packages of instructions and workflows that teach AI coding agents how to perform specialized tasks. Convex provides a set of ready-made skills for common workflows like setting up auth, designing a schema, and running migrations.

Install

Use the npx skills CLI to add the Convex skills to your project:

# Choose which skills to install
npx skills add convex/agent-skills

# Or install all of them at once
npx skills add convex/agent-skills --all

Skills are installed into .agents/skills/ in your project and are automatically picked up by compatible agents including Cursor, Claude Code, and GitHub Copilot.

Available Skills

Skill	Description
/convex	Convex is the backend agents get right on the first try: an all-TypeScript reactive platform where the database, server functions, scheduling, file storage, auth, and realtime sync are one type-safe system, every function is a transaction, and tsc catches most mistakes before deploy.
/convex-add	Add a capability to the CURRENT Convex app — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …); falls back to built-in hosting or @convex-dev component search.
/convex-advisor	Read the Convex deployment's 72h insights (read limits, OCC contention), root-cause each event in code, report evidence-backed perf/cost findings with fixes.
/convex-agent	Add an AI agent / RAG backend (@convex-dev/agent) to the Convex app.
/convex-auth	Add authentication (passkeys/OAuth) to the current Convex app, including the auth.config.ts wiring.
/convex-authz	Audit and harden a Convex app's authorization: identity-from-arg impersonation, missing per-document ownership checks, public queries leaking data by a client-supplied id, and writes into a parent/container the caller doesn't own.
/convex-backup	Set up Convex backups and run a restore DRILL that proves recovery — snapshot, restore into a throwaway preview, assert the data came back — plus a schedule matched to your RPO and a gated recovery runbook.
/convex-billing	Add Stripe billing/payments to the Convex app via @convex-dev/stripe (checkout + webhook + gating).
/convex-cost	Preview Convex spend — rank functions by bytes/documents-read × call-volume from insights, project each cost driver's growth curve, name the cheapest fix; confirm-cost for paid actions.
/convex-create-component	Builds reusable Convex components with isolated tables and app-facing APIs.
/convex-crons	Add recurring scheduled jobs (crons) to the Convex app.
/convex-deploy-guard	Classify + announce the target Convex deployment before any deployment-affecting command; fresh explicit consent for prod actions; session read-only mode.
/convex-design	Design and build reactive, type-safe, production-grade backends on Convex.
/convex-docs	Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check node_modules types, freshness hierarchy — instead of writing a possibly-stale API from memory.
/convex-domains	Point a domain you already own at your Convex app (DNS records, custom-domain attach, auth-origin rebind).
/convex-env	Set and wire Convex deployment env vars / secrets for the app.
/convex-expert	Convex backend specialist.
/convex-explain-app	Explain an existing Convex app — data model + relationships, public vs internal functions, auth/ownership model, components, a request→data flow — read from the schema and function surface.
/convex-improve-convex-plugin	Send this coding session's transcript to the Convex team for an AI post-mortem that improves the quickstart system.
/convex-insights	Query a running Convex app's logs + health in natural language (official MCP): failures, slow/expensive functions, deploy causality — scoped, evidence-backed, with a dashboard deep link.
/convex-launch-readiness	Run every Convex audit (authz, reviewer, advisor, insights) into one scored, deduped readiness report with an ordered fix plan — Lighthouse for your backend.
/convex-migrate	Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.
/convex-migrate-rehearse	Rehearse a live-app schema change + backfill on a snapshot-seeded preview deployment, verify, then promote the proven change to prod with the snapshot as rollback.
/convex-monitor	Watch for the next dev/prod error or request in a Convex app and react to it.
/convex-optimize	Audit and optimize an existing Convex app: security, scale, upgrades, observability.
/convex-quickstart	Get a barebones Convex + web template running from a one-sentence idea.
/convex-reviewer	Convex code reviewer — security, auth, validators, performance, and pattern checks for code in a convex/ directory.
/convex-seed	Seed or import data into the Convex database.
/convex-self-heal	Production error → triaged, root-caused, repaired, and certified (tsc + rehearsal + reproduce-then-gone) fix PR for a human to merge — then confirm the error stops recurring.
/convex-sentinel	Set up Sentinel production error capture in your own Convex deployment.
/convex-suggest	Suggest the matching Convex component when the user hand-rolls a pattern it already solves (crons, sharded-counter, rate-limiter, storage, search, presence, workflow, RAG, prosemirror-sync).
/convex-test	Generate convex-test tests for the app's Convex functions.
/convex-verify	Prove a Convex feature works — seed, drive as multiple mocked users via convex-test, assert behavior including the negative authz cases (wrong user refused, data-scope enforced).

Using Skills

Skills are applied automatically when the agent determines they're relevant. How you manually invoke them depends on your tool:

Tool	Manual invocation
Cursor	/skill-name
VS Code (GitHub Copilot)	/skill-name
Claude Code	/skill-name
Codex (OpenAI)	$skill-name

For example, to kick off auth setup in Cursor or Claude Code:

/convex-auth

Learn More

• convex/agent-skills - full list of skills, source code, and contributing guide
• Agent Skills standard - the open standard these skills are built on