clerk-auth
Clerk auth with API Keys beta (Dec 2025), Next.js 16 proxy.ts (March 2025 CVE context), API version 2025-11-10 breaking changes, clerkMiddleware() options, webhooks, production considerations (GCP outages), and component reference. Prevents 15 documented errors. Use when: API keys for users/orgs, Next.js 16 middleware filename, troubleshooting JWKS/CSRF/JWT/token-type-mismatch errors, webhook verification, user type inconsistencies, or testing with 424242 OTP.
Why use this skill?
Expert AI agent for Clerk authentication. Fixes Next.js 16 proxy.ts migration, API key implementation, and resolves common Clerk auth errors.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/veeramanikandanr48/clerk-authWhat This Skill Does
The clerk-auth skill provides comprehensive management, troubleshooting, and implementation guidance for Clerk authentication within Next.js 16 environments. It encompasses the latest API version changes (2025-11-10), the mandatory migration from middleware.ts to proxy.ts necessitated by the March 2025 security vulnerability, and the integration of Clerk's new user and organization-scoped API keys (Beta). This agent assists developers in navigating breaking changes, such as the async auth() requirements in v6, and provides expert-level code patterns for verifying tokens, managing webhooks, and preventing session inconsistencies or CSRF/JWKS errors. It is designed to act as a security-focused co-pilot that keeps your Clerk implementation resilient against platform outages and evolving authentication standards.
Installation
To integrate this skill into your environment, use the OpenClaw CLI:
clawhub install openclaw/skills/skills/veeramanikandanr48/clerk-auth
Ensure your project dependencies are updated to the required minimum versions: @clerk/[email protected], @clerk/[email protected], and @clerk/[email protected]. Verify that your Next.js configuration is updated to handle the proxy.ts file pattern for proper middleware execution.
Use Cases
- Migrating existing authentication logic from Next.js 15 to Next.js 16/proxy.ts.
- Configuring and securing user-scoped API keys for programmatic access.
- Troubleshooting complex authentication errors including JWT mismatches, invalid JWKS signatures, and CSRF token failures.
- Implementing force password reset flows for compromised accounts.
- Debugging production auth failures during third-party service outages or platform instability.
Example Prompts
- "My app is failing to authenticate users after upgrading to Next.js 16; how do I refactor my middleware.ts to the new proxy.ts standard correctly?"
- "Show me how to implement the new APIKeys component in my settings dashboard and verify the token types in my server-side API routes."
- "I'm seeing a 401 error related to token type mismatch. Can you help me debug my clerkMiddleware logic to distinguish between session tokens and API keys?"
Tips & Limitations
Always ensure you are using the latest version of the clerk-auth skill to account for rapid updates in the 2025-11-10 API versioning. Note that the API keys feature is currently in Beta and may be subject to pricing changes once it leaves the testing phase. Avoid relying solely on middleware for authorization; prioritize server-side action validation to maintain maximum security. When testing, the 424242 OTP remains the standard for development environments.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-veeramanikandanr48-clerk-auth": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api
Related Skills
earnings-calendar
This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. Use this when the user requests earnings calendar data, wants to know which companies are reporting earnings in the upcoming week, or needs a weekly earnings review. The skill focuses on mid-cap and above companies (over $2B market cap) that have significant market impact, organizing the data by date and timing in a clean markdown table format. Supports multiple environments (CLI, Desktop, Web) with flexible API key management.
better-auth
Self-hosted auth for TypeScript/Cloudflare Workers with social auth, 2FA, passkeys, organizations, RBAC, and 15+ plugins. Requires Drizzle ORM or Kysely for D1 (no direct adapter). Self-hosted alternative to Clerk/Auth.js. Use when: self-hosting auth on D1, building OAuth provider, multi-tenant SaaS, or troubleshooting D1 adapter errors, session caching, rate limits, Expo crashes, additionalFields bugs.
dividend-growth-pullback-screener
Use this skill to find high-quality dividend growth stocks (12%+ annual dividend growth, 1.5%+ yield) that are experiencing temporary pullbacks, identified by RSI oversold conditions (RSI ≤40). This skill combines fundamental dividend analysis with technical timing indicators to identify buying opportunities in strong dividend growers during short-term weakness.
cli-developer
Use when building CLI tools, implementing argument parsing, or adding interactive prompts. Invoke for CLI design, argument parsing, interactive prompts, progress indicators, shell completions.
options-strategy-advisor
Options trading strategy analysis and simulation tool. Provides theoretical pricing using Black-Scholes model, Greeks calculation, strategy P/L simulation, and risk management guidance. Use when user requests options strategy analysis, covered calls, protective puts, spreads, iron condors, earnings plays, or options risk management. Includes volatility analysis, position sizing, and earnings-based strategy recommendations. Educational focus with practical trade simulation.