mcpField
W
workos-authkit-base

workos-authkit-base

github.com/workosSecurity4642 installsUpdated today
Repository

About workos-authkit-base

This skill checks the WorkOS AuthKit documentation, detects a project's framework, and routes work to a framework-specific skill. It is for developers choosing an AuthKit integration path based on their project setup.

Key features

  1. 01Fetches AuthKit documentation
  2. 02Detects frameworks from dependencies
  3. 03Routes to framework-specific skills
  4. 04Guides projects with unlisted frameworks

Use cases

  1. 01Choose AuthKit steps for an existing project
  2. 02Find a starting point for an unlisted framework

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/workos/skills --skill workos-authkit-base

After installing, type/workos-authkit-basein Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported