WorkOS AuthKit Integration

Step 1: Fetch AuthKit Documentation (BLOCKING)

STOP. Do not proceed until complete.

WebFetch: https://workos.com/docs/user-management/authkit

This page is the source of truth for AuthKit concepts, supported frameworks, and setup requirements. If this skill conflicts with the docs, follow the docs.

Step 2: Detect User's Framework

Run these commands to identify the project's framework. Check each in order; use the first match.

Next.js

grep -q '"next"' package.json 2>/dev/null && echo "DETECTED: nextjs"

React Router / Remix

grep -qE '"react-router"|"@remix-run"' package.json 2>/dev/null && echo "DETECTED: react-router"

TanStack Start

grep -q '"@tanstack/start"' package.json 2>/dev/null && echo "DETECTED: tanstack-start"

React (standalone SPA — check AFTER framework-specific entries)

grep -q '"react"' package.json 2>/dev/null && echo "DETECTED: react"

If none match, check for a plain HTML/JS project:

Vanilla JS — no package.json or no framework dependency

[ ! -f package.json ] && echo "DETECTED: vanilla-js" ls index.html 2>/dev/null && echo "DETECTED: vanilla-js"

Step 3: Route to Framework-Specific Skill

Use the detection result from Step 2 to select the correct skill. Do not continue past this step if a framework matched — switch to the matching skill immediately.

Detection result --> Skill to invoke ───────────────────────────────────────────── nextjs --> workos-authkit-nextjs react-router --> workos-authkit-react-router tanstack-start --> workos-authkit-tanstack-start react --> workos-authkit-react vanilla-js --> workos-authkit-vanilla-js

If a framework is detected: Stop here. The framework-specific skill handles everything from install through verification.

If no framework is detected: Ask the user: "Which framework are you using? (Next.js, React, React Router, TanStack Start, or vanilla JS)". If they name something not listed (e.g., Astro, Remix, SvelteKit), use workos-authkit-vanilla-js as the closest starting point and WebFetch https://workos.com/docs/user-management/authkit for framework-specific guidance.

Related Skills

• workos-authkit-nextjs — Next.js App Router (13+), server-side rendering

• workos-authkit-react — React SPA with client-side AuthKit

• workos-authkit-react-router — React Router / Remix integration

• workos-authkit-tanstack-start — TanStack Start framework

• workos-authkit-vanilla-js — Plain HTML/JS without a framework