$npx -y skills add get-convex/agent-skills --skill convexRoutes 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.
| 1 | # Convex |
| 2 | |
| 3 | Use this as the routing skill for Convex work in this repo. |
| 4 | |
| 5 | If a more specific Convex skill clearly matches the request, use that instead. |
| 6 | |
| 7 | ## Start Here |
| 8 | |
| 9 | If the project does not already have Convex AI guidance installed, or the |
| 10 | existing guidance looks stale, strongly recommend installing it first. |
| 11 | |
| 12 | Preferred: |
| 13 | |
| 14 | ```bash |
| 15 | npx convex ai-files install |
| 16 | ``` |
| 17 | |
| 18 | This installs or refreshes the managed Convex AI files. It is the recommended |
| 19 | starting point for getting the official Convex guidelines in place and following |
| 20 | the current Convex AI setup described in the docs: |
| 21 | |
| 22 | - [Convex AI docs](https://docs.convex.dev/ai) |
| 23 | |
| 24 | Simple fallback: |
| 25 | |
| 26 | - [convex_rules.txt](https://convex.link/convex_rules.txt) |
| 27 | |
| 28 | Prefer `npx convex ai-files install` over copying rules by hand when possible. |
| 29 | |
| 30 | ## Route to the Right Skill |
| 31 | |
| 32 | After that, use the most specific Convex skill for the task: |
| 33 | |
| 34 | - New project or adding Convex to an app: `convex-quickstart` |
| 35 | - Authentication setup: `convex-setup-auth` |
| 36 | - Building a reusable Convex component: `convex-create-component` |
| 37 | - Planning or running a migration: `convex-migration-helper` |
| 38 | - Investigating performance issues: `convex-performance-audit` |
| 39 | |
| 40 | If one of those clearly matches the user's goal, switch to it instead of staying |
| 41 | in this skill. |
| 42 | |
| 43 | ## When Not to Use |
| 44 | |
| 45 | - The user has already named a more specific Convex workflow |
| 46 | - Another Convex skill obviously fits the request better |