convex-setup-auth
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."
Security Assessment
Detected risks:
About convex-setup-auth
The `convex-setup-auth` skill provides a structured way to implement authentication in Convex applications, enabling secure user management and role-based access control. It addresses the challenges developers face when integrating authentication into Convex apps, such as configuring auth providers, managing user identities, and protecting queries and mutations. By standardizing the setup process, this skill reduces errors, ensures consistent access control, and simplifies the integration of both built-in and third-party authentication solutions.
FAQ
Which authentication providers are supported by this skill?
This skill supports multiple providers including Convex Auth, Clerk, WorkOS AuthKit, Auth0, and custom JWT systems. The choice depends on the app's existing setup or user preference.
Can this skill be used for non-Convex backends?
No, this skill is specifically designed for Convex applications. It is not intended for non-Convex backends or purely OAuth/OIDC integrations without Convex.
How does the skill handle user identity mapping?
It sets up a users table and provides mechanisms to map authentication identities to database entries, allowing consistent access control across the app.
Do I need to manually configure environment variables and auth files?
Yes, the skill guides you to read provider-specific documentation and local reference files for proper setup of environment variables, `auth.config.ts`, and related client wiring.
Is this skill suitable for adding authentication to an existing Convex app?
Yes, it is suitable for both initial setup and extending authentication to existing apps, as long as the provider is supported and not already fully configured.
Install convex-setup-auth
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
get-convex/agent-skills