get-convex/agent-skills
12 skills352k installs372 starsGitHub
Install
npx skills add https://github.com/get-convex/agent-skillsSkills in this repo
1Convex QuickstartConvex Quickstart is a procedural agent skill that gets a solo builder from zero to a working Convex deployment as fast as the official tooling allows. It applies when you are starting a brand-new Convex project, adding Convex to an existing React, Next.js, Vue, Svelte, or similar frontend, or scaffolding a prototype backend without guessing env vars and dev commands. The workflow distinguishes greenfield scaffolding via npm create convex@latest from brownfield installs that wire the Convex provider into code you already have. A critical gate is npx convex dev --once, which provisions a local anonymous deployment, pushes current convex/ code, typechecks functions, regenerates TypeScript types, and exits cleanly so your agent knows whether schema and functions are valid before you loop on features. After that, you run the project’s dev script—ideally a template that combines Convex watcher and frontend—or split npx convex dev and the UI dev server. The skill deliberately defers dedicated auth setup to convex-setup-auth when only authentication is missing.62.6kinstalls2Convex Performance AuditConvex Performance Audit is an agent skill that walks solo builders through diagnosing Convex slowness and cost spikes methodically—reads, reactive subscriptions, write contention, and execution limits—without defaulting to premature schema gymnastics. It fits when a page feels expensive, Insights reports high document or byte reads, OCC conflicts spike, or UI updates lag under subscription load. The skill encodes Convex-specific guardrails: simple scans on small tables are often fine; structural changes need a measured signal, unbounded growth, or a known hot path. Builders shipping SaaS or API backends on Convex use it after features land but before scaling traffic, and again in production when monitoring surfaces regressions. Output is actionable fixes aligned to one problem class at a time, keeping agent sessions focused and deployment-safe.62.2kinstalls3Convex Setup AuthConvex Setup Auth is an agent skill for solo builders implementing login and authorization on Convex backends. It walks through provider selection as a mandatory first step: Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT—matching what the repo already uses unless the user wants to migrate. The skill targets user management patterns (users tables, identity mapping), reusable auth helpers, and guarding queries and mutations so SaaS and API products enforce roles correctly. It explicitly excludes non-Convex backends, documentation-only OAuth writeups, and one-line fixes when auth is already fully configured. For indie teams shipping fast, this packages Convex’s official integration paths into a procedural workflow so agents do not hallucinate provider-specific env vars or skip server-side validation. Finish with protected functions ready for Ship security review and Grow lifecycle features tied to authenticated users.62kinstalls4Convex Migration HelperConvex Migration Helper is an agent skill from the Convex toolkit that walks solo builders through safe schema and data migrations on Convex. It centers on widen-migrate-narrow: widen the schema, backfill with migrations.define (or equivalent patterns), verify counts and edge cases, then narrow types or indexes in a follow-up deploy. The bundled reference covers required fields, optional-to-required transitions, index changes, and operational checks so you do not take downtime or corrupt rows mid-rollout. Use it when you are changing table shapes, adding constraints, or reshaping documents that already exist in dev or production. It pairs naturally with Convex backend work and component boundaries when tables move between modules. Intermediate complexity—assumes you already run Convex deploys and understand defineTable validators.61.9kinstalls5Convex Create ComponentConvex Create Component is an agent skill that helps solo builders package Convex functionality as reusable components with clear ownership of tables and backend functions. It opens by clarifying what you are building and whether a component is justified—preferring normal app code or a regular library when you do not need isolated tables, Convex functions, or shared persistent state across apps. The workflow covers planning table ownership, exported public APIs, data the host app must inject, and what remains in application-level orchestration. It fits extracting billing, notifications, or integration modules that multiple Convex apps might reuse. Intermediate complexity; best when you already have a Convex app and are hitting organizational limits in a flat convex/ folder.61.9kinstalls6Convexconvex is a routing meta-skill for solo builders working in repos that ship Convex backends. Instead of guessing which procedural skill to load, the agent starts here when the user names Convex without a clear task or asks which skill to use. It prioritizes installing or refreshing managed Convex AI files through the documented CLI installer so agents follow current platform rules. From there it delegates to specialized skills for greenfield setup, authentication, reusable components, data migrations, or performance investigations. The skill intentionally stays shallow on implementation detail so you do not duplicate quickstart or migration content in one chat thread. It fits early in a Convex session and whenever you suspect outdated local rules are steering the agent wrong.38.5kinstalls7Convex Helpers GuideConvex Helpers Guide is an agent skill for solo builders shipping on Convex who keep reimplementing the same server patterns. It steers you toward the official `convex-helpers` package and documents when to use each utility cluster—starting with relationship traversal for foreign-key-style loads in queries and mutations. The included TypeScript example shows loading a task, resolving its user via `getOneFrom`, and pulling comments with `getManyFrom`, which is the shape most indie SaaS backends need for detail pages and dashboards. Use it when you know Convex basics but want vetted patterns for filtering, sessions, custom functions, and related helpers named in the skill description. Intermediate complexity: you should already have Convex tables and query/mutation handlers in place. It is a discovery and implementation guide, not a deployment or auth replacement—pair it with Convex docs for schema design and production rules.572installs8Function CreatorFunction Creator is an agent skill for solo builders shipping real-time apps on Convex who need new server endpoints without guessing validation or security conventions. It explains when to use queries versus mutations versus actions, and generates patterns that match Convex best practices: strict argument validators, typed return shapes, transactional mutations, and actions for external APIs. Invoke it whenever you add read paths, write paths, or side-effectful integrations so your agent does not mix read-only logic into mutations or skip auth checks. The skill is narrowly scoped to implementation—assumes you already have a Convex deployment and schema—and optimizes for copy-paste-ready TypeScript handlers you can extend. It fits agent-driven backends for SaaS dashboards, collaborative tools, and AI apps that persist state in Convex tables.555installs9Components GuideComponents Guide is an agent skill for solo builders shipping on Convex who need a clear pattern for splitting uploads, billing, notifications, and domain logic into reusable packages. It frames Convex components as npm-like mini-backends with their own schema, mutations, queries, and tables, then walks through installation from npm, composing sibling components, and keeping business logic thin in domain files. Use it when your convex/ tree has grown into multi-hundred-line modules or when you want the same storage or billing stack across multiple products. The skill matters because agents otherwise keep generating monolithic files that are hard to test, reuse, or reason about. It pairs naturally with Convex project setup and implementation planning so the agent names boundaries before writing functions.551installs10Schema BuilderSchema-builder is an agent skill for solo builders shipping Convex-backed apps who need a correct `convex/schema.ts` without guessing validator syntax or index strategy. It applies when you are creating a new schema file, adding tables, wiring relationships via document IDs, or fixing slow queries by indexing foreign keys. The skill encodes Convex best practices: flat documents with ID references, optional fields, status unions, and timestamps, plus when arrays are safe versus when you should normalize into related tables. For indie SaaS and agent products, getting indexes on fields you filter by early prevents painful refactors after launch. Use it whenever your agent is about to paste table definitions or you are converting nested JSON shapes into relational Convex tables. It is procedural knowledge packaged for Claude Code, Cursor, and similar agents—not a hosted MCP server.549installs11Migration Helpermigration-helper is a Convex-focused agent skill for solo builders who evolve production schemas without surprising live documents. It separates safe additive edits—optional fields, new tables, indexes—from breaking moves that demand explicit migration code, such as new required fields, type changes, renames, or structural splits. The skill encodes Convex realities: migrations are not automatic, additive schema deploys are safe, and breaking transitions should keep the app serving traffic. Use it while refactoring backend models or promoting nested blobs to relational tables, then pair with your test and deploy checklist before shipping. It is procedural documentation with TypeScript snippets rather than a hosted migration runner.523installs12Auth SetupAuth Setup is a phase-specific agent skill for solo builders using Convex who need secure authentication with clear user management and access control. It instructs agents to choose the auth provider deliberately—Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT—based on what the repo already uses or what you specify, instead of guessing a default. The skill applies when you are implementing auth for the first time, wiring a users table and identity mapping, or adding helper functions that gate queries and mutations. That makes it a natural fit for Build backend work on realtime SaaS, AI agents backed by Convex, or API-shaped products where session identity must be consistent server-side. Small teams benefit from the same guardrails: one conversational step to lock the provider, then implementation patterns aligned with Convex documentation. Pair it with your existing frontend skill only after the backend auth contract is clear, so client SDKs and server checks stay in sync.514installs