convex-setup-auth

Configure Convex authentication with multiple providers and access control.

1|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/liminal-ai/liminal-build --skill convex-setup-auth-liminal-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-setup-auth
Source: https://github.com/liminal-ai/liminal-build/tree/main/.agents/skills/convex-setup-auth
Command: npx skills add https://github.com/liminal-ai/liminal-build --skill convex-setup-auth-liminal-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Sets up Convex authentication with user management, identity mapping, and access control. Use this skill when adding login or signup to a Convex app, configuring Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT providers, wiring auth.config.ts, protecting queries and mutations with ctx.auth.getUserIdentity(), creating a users table with identity mapping, or setting up role-based access control, even if the user just says "add auth" or "make it require login."

Core Features & Use Cases

  • Supports multiple providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT) and guides backend/frontend wiring
  • Creates or maps a user identity model (users table or identity mapping) and enforces access control patterns
  • Provides a provider-agnostic workflow that adapts to the repo signals and ensures secure, authenticated Convex backend

Quick Start

Choose a provider and initialize Convex auth wiring with convex/auth.config.ts and the recommended backend and frontend integration steps.

Frequently Asked Questions about convex-setup-auth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up authentication in a Convex app?

To set up authentication in a Convex app, you configure the auth.config.ts file to connect a provider and use ctx.auth.getUserIdentity() to protect queries and mutations. You also create a users table for identity mapping.

Can I use Clerk or Auth0 for Convex authentication?

Yes, Convex authentication supports multiple providers including Clerk, Auth0, WorkOS AuthKit, Convex Auth, or custom JWT. The setup process adapts to your chosen provider to wire both backend and frontend integrations securely.

What is identity mapping in Convex and when do I need it?

Identity mapping in Convex links an authenticated provider identity to a user record in your database. You need it when creating a users table to manage app-level user data and enforce role-based access control.

How do I protect Convex queries and mutations with auth?

You protect Convex queries and mutations by calling ctx.auth.getUserIdentity() within your backend functions. If the identity is null, you throw an error to prevent unauthorized access to the data.

Do I need a users table for Convex Auth if I don't store app-level user data?

No, you do not need a users table for Convex Auth if you do not require app-level user storage. You can opt out of identity mapping and rely directly on the provider's identity tokens for authentication.