auth-setup

SKILL.md

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, getCurrentUser helpers, 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.ts configuration

Covers both local-only and production-ready setup workflows with validation checklists for login state, protected queries, and environment configuration

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: