workos-convex-debug

Community

Diagnose and fix WorkOS AuthKit with Convex.

Authorwaynesutton
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides guidance to diagnose and troubleshoot authentication issues in Convex apps using WorkOS AuthKit, helping teams quickly identify and resolve sign-in failures, missing email claims, and JWT validation problems.

Core Features & Use Cases

  • Comprehensive diagnostic guidance for common issues such as sign-in button not working, identity returning null, missing email fields, admin checks failing, and OAuth callback problems.
  • Environment and configuration validation, including environment variables, WorkOS dashboard JWT templates, and deployment readiness of Convex auth config.
  • Debugging utilities and best practices with logging strategies for frontend and backend to surface root causes.

Quick Start

Follow the diagnostic checklist to reproduce and resolve a WorkOS AuthKit authentication issue in a Convex deployment.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: workos-convex-debug
Download link: https://github.com/waynesutton/teleprompter/archive/main.zip#workos-convex-debug

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.