auth-setup

Automate Convex authentication setup with user tables and access control.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tomrford/dotfiles --skill auth-setup-tomrford
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auth-setup
Source: https://github.com/tomrford/dotfiles/tree/main/.agents/skills/auth-setup
Command: npx skills add https://github.com/tomrford/dotfiles --skill auth-setup-tomrford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Set up Convex authentication with proper user management, identity mapping, and access control patterns to secure apps and simplify onboarding.

Core Features & Use Cases

  • User table and identity mapping: establish a central users store with tokenIdentifier and basic profile fields (name, email, pictureUrl).
  • Access control patterns: implement owner-based, resource-based, and team-based permissions to protect data and actions.
  • Admin and authentication helpers: provide getCurrentUser, getCurrentUserOrNull, and requireAdmin utilities to enforce security bounds.

Quick Start

Run the initial auth setup flow to initialize the users table, identity mapping, and basic access controls.

Frequently Asked Questions about auth-setup

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

FAQPage Schema
How do I set up Convex authentication with user management and identity mapping?

You can implement Convex authentication by creating a users table with tokenIdentifier indexing, using getCurrentUser helpers, and triggering a first-sign-in storeUser mutation for backend identity resolution.

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

Implement role-based access control in Convex by applying owner-based, resource-based, and team-based permissions, using admin helpers like requireAdmin to strictly enforce security bounds.

How does identity resolution work with frontend tokens in Convex?

Convex identity resolution handles frontend authentication tokens and maps them to a central users store via tokenIdentifier, resolving backend identity during initial deployment and ongoing development.

Can I integrate OAuth providers with my Convex user management setup?

Yes, you can integrate optional OAuth providers with your Convex user management setup, extending the central users store and identity mapping to handle external authentication flows.

What access control patterns are needed to secure a Convex application?

Securing a Convex application requires owner-based, resource-based, and team-based access control patterns, alongside getCurrentUserOrNull and requireAdmin utilities to protect data and actions.