К основному содержанию
плагин

workos — плагин для Claude Code: функции и установка

Плагин подбирает справочные материалы WorkOS по задаче и помогает подключать AuthKit, SSO, Directory Sync и другие функции. Пригодится при настройке интеграции или переносе авторизации.

MIT ★ 47 обновлён 2026-10-20

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin install workos@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install workos@claude-community
/plugin marketplace add anthropics/claude-plugins-official
Открыть на GitHub

Что делает workos

В плагин входят скиллы workos и workos-widgets, а также справочные материалы по AuthKit, SSO, Directory Sync, RBAC, Vault, миграциям и API. Скилл workos выбирает справку по запросу: например, для настройки AuthKit или переноса с Auth0. Материалы подгружаются по мере необходимости, отдельно ставить каждую справку не нужно.

workos-widgets помогает подключать виджеты в разных фреймворках и запрашивает OpenAPI-спецификацию по мере работы. Справки по SDK охватывают, среди прочего, Node.js, Python, Go и Ruby. Для проекта на другой платформе эти материалы не заменят нужную документацию SDK.

В Claude Code плагин ставится командами /plugin marketplace add anthropics/claude-plugins-official, затем /plugin install workos@claude-plugins-official. В описании также указаны Codex и Goose, но этот способ установки относится к Claude Code.

Какие задачи решает

  • подключить AuthKit в приложении на Next.js или React
  • настроить SSO через SAML или OIDC
  • перенести авторизацию с Auth0 или Firebase Auth
  • добавить RBAC и синхронизацию каталогов пользователей

Примеры запросов агенту

  • Настрой подключение AuthKit в моём приложении на Next.js.
  • Подскажи, как перенести авторизацию с Auth0 на WorkOS.
  • Помоги подключить SSO через SAML и настроить роли RBAC.

Как установить workos

Через маркетплейс плагинов

/plugin install workos@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install workos@claude-community
/plugin marketplace add anthropics/claude-plugins-official

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о workos

Как установить workos в Claude Code?

Сначала добавьте каталог плагинов командой /plugin marketplace add anthropics/claude-plugins-official, затем установите плагин командой /plugin install workos@claude-plugins-official.

Что делает плагин workos?

Он включает скиллы для интеграции WorkOS и выбирает подходящие справочные материалы под задачу. Среди тем — AuthKit, SSO, миграции и API.

Нужно ли устанавливать справки WorkOS отдельно?

Нет. Скилл workos сам подгружает нужную справку по запросу; отдельно доступны два скилла: workos и workos-widgets.

Исходный текст

workos · MIT
# @workos/skills

![](./workos-logo.svg)

WorkOS skills for AI coding agents. Two skills and 40 reference files covering AuthKit, SSO, Directory Sync, RBAC, Vault, Migrations, backend SDKs, and more.

## Install as Claude Code Plugin

```bash
npx skills add workos/skills
```

This installs two skills: `workos` and `workos-widgets`. The `workos` skill acts as a router that automatically loads the right reference for your task (AuthKit setup, SSO, migrations, etc.) so you don't need to install references individually.

Works with Claude Code, Codex, Goose, and any agent that supports the skills.sh format.

## Install as Cursor Plugin

Install from the [Cursor Marketplace](https://cursor.com/marketplace) (search "WorkOS"), or clone and symlink locally — see [Local Development](#local-cursor-development) below.

## Install as npm Package

For programmatic access to skill/reference content (e.g., from the WorkOS CLI):

```bash
npm install @workos/skills
```

```typescript
import { getReference, getSkill } from '@workos/skills';

// Read reference content directly
const content = await getReference('workos-authkit-nextjs');

// Read a skill's SKILL.md content
const router = await getSkill('workos');
```

Path helpers are also available for consumers that need file paths (e.g., skill discovery):

```typescript
import { getReferencePath, getSkillsDir, getSkillPath } from '@workos/skills';

const refPath = getReferencePath('workos-authkit-nextjs'); // absolute path to .md file
const skillsDir = getSkillsDir(); // directory containing workos/ and workos-widgets/
const skillPath = getSkillPath('workos'); // absolute path to SKILL.md
```

### Exports

| Function                  | Returns                                        |
| ------------------------- | ---------------------------------------------- |
| `getReference(name)`      | `Promise<string>` — reference file content     |
| `getSkill(skillName)`     | `Promise<string>` — skill SKILL.md content     |
| `getReferencePath(name)`  | Absolute path to `references/{name}.md`        |
| `getSkillsDir()`          | Absolute path to the `skills/` directory       |
| `getSkillPath(skillName)` | Absolute path to `skills/{skillName}/SKILL.md` |

## Skills

Two registered skills:

| Skill            | Description                                                             |
| ---------------- | ----------------------------------------------------------------------- |
| `workos`         | Router — identifies which reference to load based on the user's task    |
| `workos-widgets` | Multi-framework widget integration with on-demand OpenAPI spec querying |

Everything else is a **reference file** under `references/`. The router dispatches to the right reference via progressive disclosure.

### References

> **Note:** References are not standalone skills. They are loaded automatically by the `workos` skill based on your task. You do not need to install them individually.

<details>
<summary>Full reference list (40+ files)</summary>

#### AuthKit Installation

| Reference                       | Description                    |
| ------------------------------- | ------------------------------ |
| `workos-authkit-nextjs`         | Next.js App Router integration |
| `workos-authkit-react`          | React SPA integration          |
| `workos-authkit-react-router`   | React Router v6/v7 integration |
| `workos-authkit-tanstack-start` | TanStack Start integration     |
| `workos-authkit-sveltekit`      | SvelteKit integration          |
| `workos-authkit-vanilla-js`     | Vanilla JS integration         |
| `workos-authkit-base`           | AuthKit architecture reference |

#### Backend SDK Installation

| Reference            | Description                        |
| -------------------- | ---------------------------------- |
| `workos-node`        | Node.js (Express/Fastify/Hono/Koa) |
| `workos-python`      | Python (Django/Flask/FastAPI)      |
| `workos-dotnet`      | .NET (ASP.NET Core)                |
| `workos-go`          | Go                                 |
| `workos-ruby`        | Ruby (Rails)                       |
| `workos-php`         | PHP                                |
| `workos-php-laravel` | PHP Laravel                        |
| `workos-kotlin`      | Kotlin                             |
| `workos-elixir`      | Elixir                             |

#### Features

| Reference               | Description                                    |
| ----------------------- | ---------------------------------------------- |
| `workos-sso`            | Single Sign-On with SAML/OIDC                  |
| `workos-directory-sync` | User directory sync from IdPs                  |
| `workos-rbac`           | Role-based access control                      |
| `workos-vault`          | Encrypted data storage                         |
| `workos-events`         | Webhook event handling                         |
| `workos-audit-logs`     | Compliance audit logging                       |
| `workos-admin-portal`   | Self-service admin portal                      |
| `workos-mfa`            | Multi-factor authentication                    |
| `workos-custom-domains` | Custom domain configuration                    |
| `workos-email`          | Email delivery configuration                   |
| `workos-integrations`   | Provider lookup table for 60+ IdP integrations |

#### Migrations

| Reference                               | Description                       |
| --------------------------------------- | --------------------------------- |
| `workos-migrate-auth0`                  | Migrate from Auth0                |
| `workos-migrate-firebase`               | Migrate from Firebase Auth        |
| `workos-migrate-clerk`                  | Migrate from Clerk                |
| `workos-migrate-aws-cognito`            | Migrate from AWS Cognito          |
| `workos-migrate-stytch`                 | Migrate from Stytch               |
| `workos-migrate-supabase-auth`          | Migrate from Supabase Auth        |
| `workos-migrate-descope`                | Migrate from Descope              |
| `workos-migrate-better-auth`            | Migrate from Better Auth          |
| `workos-migrate-other-services`         | Migrate from custom auth          |
| `workos-migrate-the-standalone-sso-api` | Upgrade standalone SSO to AuthKit |

#### API References

| Reference                 | Description                           |
| ------------------------- | ------------------------------------- |
| `workos-api-authkit`      | AuthKit/User Management API endpoints |
| `workos-api-organization` | Organizations API endpoints           |

#### Management

| Reference           | Description                                                     |
| ------------------- | --------------------------------------------------------------- |
| `workos-management` | CLI resource management (orgs, users, roles, webhooks, seeding) |

</details>

## Development

```bash
pnpm test          # vitest
pnpm lint          # oxlint
pnpm format        # oxfmt
```

### Local Cursor development

Cursor loads local plugins from `~/.cursor/plugins/local/`. Symlink this repo's plugin directory, then reload Cursor:

```bash
ln -s "$(pwd)/plugins/workos" ~/.cursor/plugins/local/workos
```

Then in Cursor: **Cmd+Shift+P → Developer: Reload Window** (or fully quit and relaunch Cursor if the reload doesn't pick up new skills).

### Eval framework

Measures whether skills improve agent-generated code. Each case runs the same prompt with and without the skill, scores both outputs, and reports the delta.

```bash
pnpm eval -- --dry-run                        # verify cases load
pnpm eval -- --no-cache                       # full run (42 cases, ~$1.70)
pnpm eval -- --no-cache --case=sso-node-basic # single case
pnpm eval -- --no-cache --cases=sso-node-basic,sso-ruby-domain-routing # selected cases
pnpm eval -- --no-cache --fail-on-regression  # with gates
pnpm eval:risk -- --samples=8                 # rerun latest triage cases with saved samples
```

### How it works

Each reference file follows the same pattern:

1. **Doc URLs** — source of truth links (agent fetches these first)
2. **Gotchas** — non-obvious traps the LLM gets wrong from training data
3. **Endpoints** (optional) — API endpoint table for quick reference

AuthKit and backend SDK references are richer — they include step-by-step installation instructions, decision trees, verification checklists, and error recovery.

The router (`workos/SKILL.md`) maps user intent to the right reference file.

## License

MIT

© WorkOS · MIT · workos/skills

Похожие плагины

Все плагины по теме «Безопасность» →
workos-wasp-drone Legion Code Inc. Субагент workos-wasp-drone для интеграции WorkOS: AuthKit (UI и headless), сессии, User Management, RBAC, SSO (SAML/OIDC), Directory Sync, MFA и миграция с Supabase Auth или Clerk. CX Codex ★ 96звёзд репо agentdevx mirajmahmudul57 MCP-сервер agentdevx для Claude Code подключает API, хранит учётные данные в зашифрованном хранилище и применяет политики OPA. Управляет вызовами внешних сервисов. CX Codex +1 10 461установок DataNexus MCP dev-7bd0 MCP-сервер DataNexus MCP даёт агенту доступ к проверенным публичным данным о CVE, SBOM, лицензиях, доменах, патентах и организациях. CX Codex +1 7 877установок URL Safety Validator MCP OjasKord MCP-сервер URL Safety Validator MCP проверяет адреса сайтов на фишинг и вредоносный код перед переходом агента. Пригодится при разборе писем, веб-скрейпинге и обработке чужих ссылок. CX Codex +1 5 626установок Trust Score — Domain & Wallet Safety Scanner axel-belfort MCP-сервер Trust Score — Domain & Wallet Safety Scanner оценивает домены, URL, API и криптокошельки. Агент получает общий балл, оценку буквами и вердикт перед взаимодействием с целью. CX Codex +1 5 454установок SSL Certificate Checker — Validity, Expiry & Grade axel-belfort SSL Certificate Checker — Validity, Expiry & Grade — MCP-сервер для Claude Code, проверяющий SSL/TLS-сертификат домена и возвращающий статус, дату истечения, издателя и оценку безопасности. CX Codex +1 5 042установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой