auth-setup
Installation
Summary
Convex authentication setup with provider selection, user management, and access control patterns.
- Supports multiple auth providers: Convex Auth, Clerk, WorkOS AuthKit, Auth0, and custom JWT, with provider detection from repo signals before setup
- Guides identity mapping to a users table,
getCurrentUserhelpers, and authorization patterns for ownership, admin, and team access checks - Includes provider-specific reference files for package installation, environment variables, client wiring, and
convex/auth.config.tsconfiguration - Covers both local-only and production-ready setup workflows with validation checklists for login state, protected queries, and environment configuration
SKILL.md
Convex Authentication Setup
Implement secure authentication in Convex with user management and access control.
When to Use
- Setting up authentication for the first time
- Implementing user management (users table, identity mapping)
- Creating authentication helper functions
- Setting up auth providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, custom JWT)
First Step: Choose the Auth Provider
Convex supports multiple authentication approaches. Do not assume a provider.
Before writing setup code:
- Ask the user which auth solution they want, unless the repository already makes it obvious
- If the repo already uses a provider, continue with that provider unless the user wants to switch
Related skills
More from get-convex/agent-skills
convex-quickstart
Creates or adds Convex to an app. Use for new Convex projects, npm create
44.9Kconvex-performance-audit
Audits Convex performance for reads, subscriptions, write contention, and
44.4Kconvex-setup-auth
Sets up Convex auth, identity mapping, and access control. Use for login, auth
44.3Kconvex-migration-helper
Plans Convex schema and data migrations with widen-migrate-narrow and
44.2Kconvex-create-component
Builds reusable Convex components with isolated tables and app-facing APIs.
44.2Kconvex
Routes general Convex requests to the right project skill. Use when the user
20.7K