Skip to main content

Convex Agent Skills

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 get-convex/agent-skills

# Or install all of them at once
npx skills add get-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​

SkillDescription
/convex-quickstartSet up a new Convex project from scratch
/convex-setup-authConfigure authentication for your Convex app
/convex-migration-helperPlan and run data migrations
/convex-create-componentCreate a new Convex component
/convex-performance-auditAudit and optimize Convex queries and mutations

Skills are added and updated regularly, so this list may not be exhaustive. See the get-convex/agent-skills repo for the latest.

Using Skills​

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

ToolManual invocation
Cursor/skill-name
VS Code (GitHub Copilot)/skill-name
Claude Code/skill-name
Windsurf@skill-name
Codex (OpenAI)$skill-name

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

/convex-setup-auth

In Windsurf:

@convex-setup-auth

Learn More​