convex
get-convex/agent-skills
Routes Convex requests to the right specialized skill or guidance.
What is convex?
A routing skill for Convex work that directs users to appropriate specialized skills or recommends installing official Convex AI guidance. Use this when a request is underspecified or you need to determine which Convex workflow applies.
- Routes general Convex requests to the most specific matching skill
- Recommends installing official Convex AI guidance via npx convex ai-files install
- Provides fallback access to convex_rules.txt when guidance is not installed
- Identifies which specialized Convex skill best fits the user's task
How to install convex
npx skills add https://github.com/get-convex/agent-skills --skill convex- Convex project or app in progress
How to use convex
- 1.When receiving a Convex request, check if official Convex AI guidance is installed
- 2.If not installed, recommend running npx convex ai-files install to get current guidelines
- 3.Identify the user's specific Convex workflow (new project, auth, components, migration, or performance)
- 4.Route to the appropriate specialized skill or provide convex_rules.txt as fallback
Use cases
- User asks which Convex skill to use without specifying a workflow
- Determining whether to use convex-quickstart, convex-setup-auth, convex-create-component, convex-migration-helper, or convex-performance-audit
- Setting up Convex AI guidance in a project for the first time
- Handling underspecified Convex app tasks that need clarification
- Developers new to Convex workflows
- Teams setting up Convex AI guidance in a project
- Anyone needing help routing to the right Convex-specific skill
convex FAQ
Use this skill when the request is underspecified or you need to determine which Convex workflow applies. If the user has already named a specific workflow (like authentication setup or migration), switch to the matching specialized skill instead.
It installs or refreshes managed Convex AI files with official guidelines and current Convex AI setup recommendations. This is the preferred starting point for getting Convex AI guidance in place.
Strongly recommend running npx convex ai-files install first. If that is not possible, provide the fallback convex_rules.txt from https://convex.link/convex_rules.txt.
convex-quickstart (new projects), convex-setup-auth (authentication), convex-create-component (reusable components), convex-migration-helper (migrations), and convex-performance-audit (performance issues).
Full instructions (SKILL.md)
Source of truth, from get-convex/agent-skills.
name: convex description: Routes general Convex requests to the right project skill. Use when the user asks which Convex skill to use or gives an underspecified Convex app task.
Convex
Use this as the routing skill for Convex work in this repo.
If a more specific Convex skill clearly matches the request, use that instead.
Start Here
If the project does not already have Convex AI guidance installed, or the existing guidance looks stale, strongly recommend installing it first.
Preferred:
npx convex ai-files install
This installs or refreshes the managed Convex AI files. It is the recommended starting point for getting the official Convex guidelines in place and following the current Convex AI setup described in the docs:
Simple fallback:
Prefer npx convex ai-files install over copying rules by hand when possible.
Route to the Right Skill
After that, use the most specific Convex skill for the task:
- New project or adding Convex to an app:
convex-quickstart - Authentication setup:
convex-setup-auth - Building a reusable Convex component:
convex-create-component - Planning or running a migration:
convex-migration-helper - Investigating performance issues:
convex-performance-audit
If one of those clearly matches the user's goal, switch to it instead of staying in this skill.
When Not to Use
- The user has already named a more specific Convex workflow
- Another Convex skill obviously fits the request better
Related skills
More from get-convex/agent-skills and the wider catalog.
convex-quickstart
Set up a working Convex backend and frontend in minutes, from scratch or in an existing app.
convex-performance-audit
Diagnose and fix Convex performance issues: reads, subscriptions, write contention, and function limits.
convex-setup-auth
Set up secure authentication in Convex with user management and access control.
convex-migration-helper
Plan and execute safe Convex schema migrations with widen-migrate-narrow pattern and batched data backfills.
convex-create-component
Create reusable Convex components with isolated tables and app-facing APIs.