Convex
Pick the right Convex project skill and refresh official Convex AI guidance before touching schema, auth, or migrations.
Overview
convex is an agent skill most often used in Build (also Validate prototype spikes and Operate iterate) that routes Convex requests to the correct specialized skill and refreshes official AI guidance.
Install
npx skills add https://github.com/get-convex/agent-skills --skill convexWhat is this skill?
- Recommends `npx convex ai-files install` before deep implementation when guidance is missing or stale
- Routes to convex-quickstart, convex-setup-auth, convex-create-component, convex-migration-helper, convex-performance-aud
- Explicit “when not to use” if a specific child skill already matches
- Links official Convex AI docs and convex_rules.txt fallback
- Entry point for underspecified “help with Convex” requests in the repo
- Routes to 5 named child skills: quickstart, setup-auth, create-component, migration-helper, performance-audit
Adoption & trust: 38.5k installs on skills.sh; 31 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You said “fix Convex” or “add Convex” but the repo has several Convex skills and the agent might apply stale or generic rules.
Who is it for?
Indie builders with a Convex repo who want the agent to land on the right playbook and up-to-date docs before writing functions or schema.
Skip if: When the task already maps clearly to one child skill (e.g. “run a Convex migration”)—invoke that skill directly instead of staying on the router.
When should I use this skill?
User asks which Convex skill to use or gives an underspecified Convex app task.
What do I get? / Deliverables
The agent installs or refreshes Convex AI files when needed, then switches to the single best-matching Convex skill for quickstart, auth, components, migrations, or performance.
- Handoff to the most specific Convex skill
- Refreshed Convex AI guidance files when install is run
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Build/backend is the canonical shelf because Convex work is backend-centric even when the user’s question sounds like planning or ops. Backend matches routing into quickstart, auth, components, migrations, and performance skills rather than frontend-only tasks.
Where it fits
User asks to add Convex auth—the router sends the agent to convex-setup-auth after refreshing AI files.
New SaaS idea needs Convex—router picks convex-quickstart instead of generic backend chat.
Slow queries prompt convex-performance-audit via the routing table.
How it compares
Convex orchestration router inside the skill pack, not a replacement for convex-quickstart or migration-helper depth.
Common Questions / FAQ
Who is convex for?
Developers using Convex in an agent-assisted workflow who need correct skill selection and fresh Convex AI file guidance before implementation.
When should I use convex?
At the start of ambiguous Convex work in Build; when validating a Convex-backed prototype in Validate; or during Operate when investigating performance or migrations but unsure which skill applies—unless a specific child skill is already obvious.
Is convex safe to install?
It mainly recommends documented Convex CLI install commands and skill handoffs; check the Security Audits panel on this page before running npx installers in sensitive repos.
Workflow Chain
Then invoke: convex quickstart, convex setup auth
SKILL.md
READMESKILL.md - Convex
# 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: ```bash 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: - [Convex AI docs](https://docs.convex.dev/ai) Simple fallback: - [convex_rules.txt](https://convex.link/convex_rules.txt) 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