WorkOS

What WorkOS does

WorkOS packages implementation guidance for AI coding agents working with WorkOS products and SDKs. Its coverage spans AuthKit, SAML and OIDC SSO, Directory Sync, RBAC, Vault, webhooks, audit logs, admin portals, MFA, custom domains, email configuration, provider integrations, and organization APIs. It also includes migration references for Auth0, Firebase Auth, Clerk, AWS Cognito, Stytch, Supabase Auth, Descope, Better Auth, custom authentication systems, and the standalone SSO API.

The package contains two registered skills: workos, which chooses the relevant reference for a task, and workos-widgets, which supports widget integration across multiple frameworks and can query OpenAPI specifications on demand.

How it works

The workos skill acts as a router. It maps the developer's request to one of the reference files instead of requiring each reference to be installed separately. References use a consistent structure that can include source documentation URLs, implementation cautions, and endpoint tables. AuthKit and backend SDK references add installation procedures, decision trees, verification checklists, and error-recovery guidance.

The reference set covers frontend integrations for Next.js, React, React Router, TanStack Start, SvelteKit, and vanilla JavaScript. Backend guidance covers Node.js frameworks, Python frameworks, ASP.NET Core, Go, Ruby on Rails, PHP, Laravel, JVM languages, and Elixir.

Setup and configuration

Install the skills for Claude Code or another agent that supports the skills.sh format with:

npx skills add workos/skills

The package can also be installed from the Cursor Marketplace by searching for “WorkOS”. For local Cursor development, the plugin directory can be symlinked into ~/.cursor/plugins/local/, followed by a Cursor window reload.

For programmatic access, install the npm package:

npm install @workos/skills

Its TypeScript API exposes getReference() and getSkill() for reading content, plus getReferencePath(), getSkillsDir(), and getSkillPath() for retrieving filesystem paths. Reference names such as workos-authkit-nextjs identify individual content files.

Tools and capabilities

• Route WorkOS implementation questions to the appropriate reference.
• Load AuthKit setup guidance for supported frontend frameworks.
• Provide backend SDK references for multiple languages and frameworks.
• Cover SSO, Directory Sync, RBAC, Vault, events, audit logs, MFA, and related WorkOS features.
• Explain migrations from common authentication providers.
• Expose skill and reference content through a TypeScript package API.

Limitations and notes

References are content files loaded through the workos router, not independent skills that need separate installation. The package also includes a distinct widget skill for multi-framework integrations. Its documented use centers on supplying agent guidance and reference content; the package's management material covers CLI-oriented resources such as organizations, users, roles, webhooks, and data seeding.