workos-integration

Integrate WorkOS SSO, organization management, and directory sync into Battery applications.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/ADLenehan/battery --skill workos-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workos-integration
Source: https://github.com/ADLenehan/battery/tree/main/.claude/skills/workos-integration
Command: npx skills add https://github.com/ADLenehan/battery --skill workos-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Battery deployments require secure, scalable single sign-on and multi-tenant administration. This skill provides ready-to-use patterns for integrating WorkOS SSO, organization management, and directory sync into Battery apps.

Core Features & Use Cases

  • SSO federation integration with multiple IdP providers (Okta, Azure AD)
  • Organization management and directory synchronization patterns for multi-tenant apps
  • Admin portal access, webhook handling, and session management for secure app access
  • Easy middleware and route patterns for authentication flow across apps and deployments

Quick Start

Initialize the WorkOS client in your Battery app with your API key and wire the SSO callback route to complete login.

Frequently Asked Questions about workos-integration

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

FAQPage Schema
How do I integrate WorkOS SSO into a multi-tenant application?

You integrate WorkOS SSO by initializing the WorkOS client with your API key and wiring SSO callback routes. This provides middleware and route patterns for secure login and session handling across multi-tenant environments.

What is directory synchronization and when do I need it for organization management?

Directory synchronization automatically provisions and manages users from identity providers like Okta or Azure AD. You need it for multi-tenant apps requiring automated user lifecycle management and enforced access control across organizations.

How do I handle WorkOS webhooks for user provisioning and event processing?

You handle WorkOS webhooks by using the skill's provided example handlers and webhook secret. This securely processes directory sync events, enabling automated user provisioning and organization management updates.

Does this WorkOS integration support IdP providers like Okta and Azure AD?

Yes, the WorkOS integration supports SSO federation with multiple identity providers including Okta and Azure AD. It enables IT admins to configure connections and manage users across these providers in multi-tenant environments.

What do I need to configure before setting up WorkOS authentication?

Before setting up WorkOS authentication, you need a WorkOS API key, client ID, and webhook secret. These credentials initialize the WorkOS client and secure your SSO callbacks and event processing handlers.