# Convex Auth Setup

> Set up Convex authentication, user mapping, authorization, and custom function wrappers for data protection.

- Skill: `majiayu000/convex-auth-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/convex-auth-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/convex-auth-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/convex-auth-setup

---


# Convex Auth Setup

Use this skill when the task involves auth providers, `users` tables, `getCurrentUser` helpers, access control, or multi-tenant data protection.

## Default approach

- Map auth identity to an application user record.
- Centralize auth helpers instead of repeating lookup logic everywhere.
- Verify both authentication and authorization in public functions.
- Prefer custom function wrappers for repeated access-control behavior.

## AgentForge-specific guidance

- Keep auth in Convex focused on data access, identity mapping, and encrypted key storage where applicable.
- Do not treat Convex auth as a place to run Mastra or general agent orchestration.

## References

- Read [auth-patterns.md](/Users/eduardojaviergarcialopez/AgenticEngineering/agentforge/.agents/skills/convex-auth-setup/references/auth-patterns.md) for helper patterns and data-protection wrappers.