Does this skill expose my Clerk secret keys?

No, the diagnostic scripts are designed to sanitize secret keys, only showing boolean existence checks or truncated strings to ensure your credentials remain secure.

How do I trigger the Clerk debug bundle?

You can activate the skill by asking Claude phrases like 'clerk debug', 'clerk diagnostics', or 'clerk support ticket' within your project workspace.

Can this help with middleware-specific issues?

Yes, it provides a specialized middleware configuration that enables debug logging for pathnames, methods, and header states to pinpoint where auth logic might be failing.

What frameworks are supported by these debug tools?

The bundle is primarily optimized for Next.js and React environments, covering both server-side middleware and client-side hooks provided by the Clerk SDK.

Clerk Debug & Diagnostics Bundle

Name: Clerk Debug & Diagnostics Bundle
Author: jeremylongshore

byjeremylongshore

•

982

Analytics & Monitoring

Diagnoses and troubleshoots Clerk authentication issues by generating comprehensive system reports, health check endpoints, and client-side debug panels.

About

The Clerk Debug Bundle provides a specialized toolkit for resolving complex authentication and session issues within applications using the Clerk SDK. It automates the collection of environment data, package versions, and sanitized configuration details, while offering pre-built components for real-time runtime health checks and client-side JWT token inspection. This skill is essential for developers needing to prepare detailed support tickets or diagnose intermittent middleware and session synchronization problems in Next.js and React environments.

Key Features

Generates sanitized environment and configuration diagnostic reports
Produces a CLI-ready support bundle for Clerk technical support teams
Creates runtime API health check endpoints for auth status verification
982 GitHub stars
Provides a React-based debug panel for client-side token and session inspection
Implements enhanced middleware logging for request-level troubleshooting

Use Cases

Debugging 'Unauthorized' errors or session mismatches in local and staging environments
Preparing comprehensive diagnostic data for Clerk technical support tickets
Verifying SDK compatibility and environment variable configuration across different deployment stages

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jeremylongshore/claude-code-plugins-plus-skills clerk-debug-bundle

For use in Claude.ai and ChatGPT

Download Skill

GitHub