convex-setup-auth
Set up Convex authentication with the right provider, user management, and access control patterns.
What it does
- 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
- Auth for a non-Convex backend
- Pure OAuth/OIDC documentation without a Convex implementation
- Debugging unrelated bugs that happen to surface near auth code
Requirements & configuration
- The auth provider is already fully configured and the user only needs a
- actually needs user documents in Convex. Not every app needs a users table.
- [ ] Only added app-level user storage if the app actually needs it
- [ ] Added authorization checks where the app actually needs them
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
Set up Convex authentication with the right provider, user management, and access control patterns.
Source
Repository: https://github.com/get-convex/agent-skills
convex-setup-auth FAQ
What does the convex-setup-auth skill do?
Sets up Convex auth, identity mapping, and access control. Use for login, auth providers, users tables, protected functions, or roles in a Convex app. Setting up authentication for the first time Implementing user management (users table, identity mapping)
What does convex-setup-auth require?
The auth provider is already fully configured and the user only needs a actually needs user documents in Convex. Not every app needs a users table. [ ] Only added app-level user storage if the app actually needs it [ ] Added authorization checks where the app actually needs them
How do I install convex-setup-auth?
Run: npx -y skills add https://github.com/get-convex/agent-skills --skill convex-setup-auth --agent claude-code — the source lives at github.com/get-convex/agent-skills.
Maintain convex-setup-auth?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/get-convex-agent-skills-convex-setup-auth?ref=badge) npx agentictools info skills/get-convex-agent-skills-convex-setup-auth The second line is the CLI lookup for this page — handy in READMEs and docs.