Agent skill · software engineering · jeremylongshore
clerk-debug-bundle
Collect comprehensive debug information for Clerk issues.
Why this skill is useful
Adds executable scripts for comprehensive Clerk debugging and diagnostics that are not available in public documentation.
What it needs
Requires node, npm installed locally. Requires clerk account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Clerk Debug Bundle Current State !node --version 2>/dev/null echo 'N/A' !npm list @clerk/nextjs @clerk/clerk-react @clerk/express 2>/dev/null grep clerk echo 'No Clerk packages found' Overview Collect all necessary debug information for Clerk troubleshooting and support tickets. Generates an environment report, runtime health check, client-side debug panel, and support bundle. Prerequisites Clerk SDK installed Access to application logs Browser with developer tools Instructions Step 1: Environment Debug Script Run with: Step 2: Runtime Health Check Endpoint Step 3: Client-Side Debug Component Step 4: Request Debug Middleware Step 5: Generate Support Bundle Output Environment debug script showing SDK versions and API connectivity /api/clerk-health endpoint for runtime health checks Client-side debug panel (dev-only) showing auth state and JWT contents Request logging middleware with Clerk cookie inspection Support bundle script for filing Clerk support tickets Error Handling Issue Debug Action ------- -------------- Auth not working Hit /api/clerk-health, check backendApi status Token issues Use debug panel "Inspect JWT" to view claims and expiry Middleware not running Enable CLERKDEBUG=true, check console for request logs Session not persisting Check debug panel for clerk cookies, verify domain Examples Quick One-Liner Debug Check Resources Clerk Support Portal Clerk Discord Community Clerk GitHub Issues Next Steps Proceed to clerk-rate-limits for understanding Clerk rate limits.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clerk-debug-bundle