convex-setup-auth

Set up Convex authentication with identity mapping and role-based access control.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Atemndobs/ops-central --skill convex-setup-auth-atemndobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-setup-auth
Source: https://github.com/Atemndobs/ops-central/tree/main/.agents/skills/convex-setup-auth
Command: npx skills add https://github.com/Atemndobs/ops-central --skill convex-setup-auth-atemndobs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex apps often require cohesive authentication, user identity mapping, and robust access control across multiple providers. This skill guides you through choosing and wiring an auth strategy (Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT), ensuring queries and mutations are protected and a user model with identity mapping exists.

Core Features & Use Cases

  • Supports Convex Auth, Clerk, WorkOS AuthKit, Auth0, and custom JWT setups to secure backend and gate UI.
  • Wires authentication config, identity mapping, and role-based access control, with guidance for production vs development environments.
  • Use cases include first-time auth setup, migrations between providers, and adding login/signup flows for Convex apps.

Quick Start

Choose an auth provider (Convex Auth, Clerk, WorkOS AuthKit, Auth0, or a custom JWT) and wire Convex authentication, identity mapping, and access control accordingly.

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 Convex with Clerk or Auth0?

To set up Convex authentication with Clerk or Auth0, you configure the provider, establish user identity mapping, and enforce role-based access control. This skill guides provider selection, wiring, and protecting backend functions using ctx.auth.getUserIdentity().

What is the best way to add role-based access control to a Convex backend?

The best way to add role-based access control to a Convex backend is to wire authentication configuration with identity mapping. This ensures protected queries and mutations validate user roles through ctx.auth.getUserIdentity() before executing.

Can I use WorkOS AuthKit or a custom JWT provider with Convex auth?

Yes, you can use WorkOS AuthKit or a custom JWT provider with Convex auth. This skill supports wiring these providers, mapping user identities, and aligning environment variables for both development and production deployment environments.

How do I migrate between authentication providers in a Convex app?

Migrating between authentication providers in a Convex app involves selecting a new strategy like Convex Auth, Clerk, or Auth0, then rewiring the authentication configuration and updating identity mapping. This skill guides the provider migration and environment alignment process.

Does Convex Auth support user management and identity mapping out of the box?

Convex Auth supports user management and identity mapping when properly wired with access control rules. This skill guides setting up a user model and ensures protected backend functions correctly use ctx.auth.getUserIdentity() for identity verification.