clerk-setup

Detect a project's framework and apply Clerk quickstart authentication setup.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/awfixers-stuff/opencode-config --skill clerk-setup-awfixers-stuff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clerk-setup
Source: https://github.com/awfixers-stuff/opencode-config/tree/main/skills/clerk-setup
Command: npx skills add https://github.com/awfixers-stuff/opencode-config --skill clerk-setup-awfixers-stuff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates adding Clerk authentication to a project by detecting the framework, fetching the official quickstart, and applying the recommended integration steps so developers avoid manual setup errors and mismatched configurations.

Core Features & Use Cases

  • Framework detection: Reads package.json to identify Next.js, Remix, Astro, Nuxt, React SPA, Express, Fastify, Expo, and other supported platforms.
  • Official quickstart application: Fetches the Clerk quickstart for the detected framework and follows installation, provider/middleware or proxy file creation, environment variable setup, and testing instructions.
  • Migration planning: Audits existing auth systems (for example NextAuth, Supabase, Firebase, Auth0, Passport) and outlines migration strategies including user export/import options and trickle or big-bang approaches.
  • Use Case: Convert a newly scaffolded Next.js app to Clerk with middleware/proxy and shadcn theming, or plan a controlled migration of 2000 users from an existing auth provider.

Quick Start

Use the clerk-setup skill to add Clerk authentication by detecting the framework, fetching the official quickstart, installing the appropriate Clerk SDK, creating provider or middleware/proxy files, and configuring the required environment variables.

Frequently Asked Questions about clerk-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Clerk authentication to a Next.js project?

Adding Clerk to a Next.js project involves detecting the framework from package.json, fetching the official quickstart, installing the Clerk SDK, creating middleware files, and configuring publishable and secret environment variables.

Can I migrate existing users from NextAuth or Firebase to Clerk?

Yes, you can migrate existing users from providers like NextAuth, Firebase, Supabase, Auth0, or Passport to Clerk. The skill audits your current auth system and outlines migration strategies including user export/import and trickle or big-bang approaches.

Does Clerk work with shadcn UI components?

Clerk integration adapts its theming automatically when a components.json file is detected, ensuring the Clerk authentication components match your existing shadcn UI configuration without manual styling conflicts.

What web frameworks support automated Clerk setup?

Automated Clerk setup supports web frameworks and platforms detected from package.json, including Next.js, Remix, Astro, Nuxt, React SPA, Express, Fastify, and Expo, applying official quickstart installation and configuration steps for each.

How does automated Clerk setup handle environment variables?

Automated Clerk setup handles environment variables by configuring the required publishable and secret keys required by the Clerk SDK, ensuring your authentication provider is correctly initialized for your detected framework.

What is the best way to plan a big-bang migration to Clerk?

The best way to plan a migration to Clerk is auditing your existing auth system to outline a strategy, allowing you to choose between a controlled trickle migration or a complete big-bang approach based on your user export and import options.