WorkOS Skills — AuthKit, SSO и RBAC для агентов
WorkOS Skills
Официальные скиллы WorkOS: роутер и 40 справочников по AuthKit, SSO, Directory Sync, RBAC, Vault и миграциям с Auth0 и Clerk
- 46 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скилл направляет агента запускать CLI workos, который создает среду WorkOS, пишет ключи в .env.local и по умолчанию коммитит изменения
- Ключи WORKOS_API_KEY и WORKOS_CLIENT_ID оказываются в файлах проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/workos-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл направляет агента запускать CLI workos, который создает среду WorkOS, пишет ключи в .env.local и по умолчанию коммитит изменения
- Ключи WORKOS_API_KEY и WORKOS_CLIENT_ID оказываются в файлах проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий WorkOS поставляет агентам два скилла и больше 40 справочных файлов. Скилл workos работает роутером: по задаче он подгружает нужный справочник, будь то установка AuthKit, настройка SSO или перенос пользователей, и ставить справочники по отдельности не требуется. Скилл workos-widgets подключает виджеты на нескольких фреймворках и по требованию сверяется со спецификацией OpenAPI. Справочники делятся на установку AuthKit для Next.js, React, React Router, TanStack Start, SvelteKit и чистого JavaScript, установку серверных SDK для Node.js, Python, .NET, Go, Ruby, PHP, Kotlin и Elixir, функции SSO, Directory Sync, RBAC, Vault, события, аудит, портал администратора, MFA, домены и почту. Отдельная группа описывает миграцию с Auth0, Firebase, Clerk, AWS Cognito, Stytch, Supabase Auth, Descope и Better Auth. Каждый справочник открывается ссылками на документацию, затем перечисляет ловушки, в которых модели ошибаются по данным обучения, и при необходимости таблицу эндпоинтов. Для нового проекта скилл первым делом рекомендует WORKOS_MODE=agent npx workos@latest `install`: команда создает неподтвержденную среду WorkOS без аккаунта и записывает ключи в .env.local.
Для кого. Разработчикам, которые подключают WorkOS AuthKit, корпоративный SSO или SCIM-синхронизацию каталогов и просят агента сделать это без выдуманных методов SDK.
Подходит, если
- В Next.js-проекте нужно добавить вход через AuthKit с обратным вызовом и выходом
- Корпоративный клиент просит SAML-вход, и надо подключить его провайдера идентификации
- Пользователей нужно перенести с Auth0 или Clerk в WorkOS без потери паролей и сессий
- Роли и права требуют настройки через RBAC, а API организаций нужен из бэкенда на Go или Python
- Агент ошибается в именах методов SDK и нуждается в справочнике с ловушками
Не подходит, если
- Проект использует другого поставщика авторизации: справочники описывают только WorkOS
- Нужна вся документация WorkOS целиком: скилл ведет по сценариям и документацию не заменяет
- Фреймворка нет среди справочников: для него придется опираться на документацию
- Нужно управлять ресурсами WorkOS из терминала без правки кода, для этого есть сам CLI workos
Пример запроса к агенту
Добавь вход через WorkOS AuthKit в это Next.js приложение и проверь вход, выход и вход, запущенный извне.Ограничения
Скилл учит агента работать с WorkOS, но сам ничего не запускает: действия выполняют CLI workos и SDK. Установка нового проекта командой npx workos@latest `install` создает неподтвержденную среду, и ее нужно привязать к аккаунту командой npx workos@latest `profile` `claim`, а привязка необратима.
Установщик в режиме агента по умолчанию создает ветку и коммит, если не передать --no-branch --no-commit. Справочники привязаны к версии CLI 0.23.0 и могут отстать от релизов. Eval на 42 случая стоит около 1,70 доллара за прогон.
Как отключить. Удалите скиллы workos и workos-widgets из папки скиллов агента. Для плагина Cursor снимите его в маркетплейсе, а npm-пакет убирает npm rm @workos/skills.
Частые вопросы
Как поставить скиллы WorkOS?
Командой npx skills add workos/skills: она ставит два скилла, workos и workos-widgets. Справочники отдельно ставить не нужно, роутер сам подгружает нужный. Для Cursor есть плагин в маркетплейсе, для кода есть пакет npm @workos/skills.
Нужен ли аккаунт WorkOS для первой установки?
Нет. Команда WORKOS_MODE=agent npx workos@latest `install` создает новую неподтвержденную среду и пишет ключи в .env.local. Позже среду привязывают к аккаунту командой npx workos@latest `profile` `claim`, привязка необратима.
С каких сервисов можно мигрировать?
Есть справочники для Auth0, Firebase Auth, Clerk, AWS Cognito, Stytch, Supabase Auth, Descope, Better Auth, собственной авторизации и перехода с отдельного SSO API на AuthKit.
Что делает роутер workos?
Определяет по задаче нужный справочник и загружает его по запросу. Так в контекст попадает один нужный файл из сорока. Каждый справочник начинается со ссылок на документацию, затем идут ловушки и таблица эндпоинтов.
Работает ли скилл в Codex и Goose?
Да. Формат skills.sh поддерживают Claude Code, Codex, Goose и другие агенты с таким форматом, одна установка подходит всем. В Cursor скиллы подключают плагином или локальной ссылкой на папку plugins/workos.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыОфициальные скиллы Clerk учат агента подключать аутентификацию к Next.js, React, Vue, Expo, Swift и Android
Пять скиллов Saleor для агента: приложения, витрина, конфигуратор магазина как кода и внутреннее устройство бэкенда
Пять скиллов от Vercel по Workflow SDK: установка, написание долговечных рабочих процессов и переход между версиями.
Сотни скиллов по провайдерам учат агента принимать вебхуки, проверять подписи и разбирать события; примеры для Express и FastAPI.
Скилл учит агента писать сервисы на go-zero: REST и RPC, генерацию через goctl, базы, устойчивость и очереди
Официальный набор устанавливаемых скиллов Oracle для работы с Oracle Database, OCI, GraalVM, Fusion и APEX
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| WorkOS Skills — AuthKit, SSO и RBAC для агентов (эта карточка) | да | 46 | ||
| Скиллы Better Auth | нет | 230 | скиллы для библиотеки Better Auth, а у WorkOS управляемый корпоративный SSO | |
| Auth0 MCP Server | да | OAuth | 122 | MCP для управления арендатором Auth0, а здесь знания по внедрению WorkOS |
Коротко о README
В README расписана установка плагином для Claude Code и Cursor и как пакет npm с функциями getReference и getSkill. Затем идут таблицы справочников по группам: установка AuthKit, серверные SDK, функции, миграции, ссылки на API и управление. В конце разработка, фреймворк оценки эффективности скиллов и принцип построения справочников.
Бейдж для README
Исходный SKILL.md
--- name: workos description: Start new AuthKit setups with `npx workos@latest install`, which needs no WorkOS account. Use when the user asks for a WorkOS docs URL, term, or dashboard field (Sign-in endpoint, initiate_login_uri, Redirect URI, `WORKOS_*` env vars), or is implementing, debugging, or migrating WorkOS — AuthKit, SSO/SAML, Directory Sync, RBAC, FGA, MFA, Vault, Audit Logs, Admin Portal, Pipes (Connected Apps), Feature Flags, Radar (bot/fraud detection), webhooks, Custom Domains, WorkOS Widgets (profile, security, sessions, organization selection and member UI), Clerk UserButton/account UI comparisons, running the `workos` CLI in agent or sandbox sessions (`WORKOS_MODE`, `workos doctor`), or migrating from Auth0, Clerk, Cognito, Firebase, Supabase, Stytch, Descope, or Better Auth. Also triggers on @workos-inc/* imports. --- # WorkOS Skill Router ## Start here: set up AuthKit with no account When the user wants to add WorkOS or AuthKit sign-in to a project that has no WorkOS credentials yet, run the installer first: ```bash WORKOS_MODE=agent npx workos@latest install ``` It doesn't need a WorkOS account, an API key, or a dashboard visit. Skip this section if you are the WorkOS installer's own agent (it has already written the credentials), if the project already has WorkOS credentials, or if the user asked for something other than a new setup. Go to **How to Use** instead. **What it does.** This describes `workos` CLI 0.23.0, the latest release when this was written. Treat the CLI's output as authoritative over this list. - If no credentials are found (no `WORKOS_API_KEY` in the shell or the project's env file, and no active `workos` CLI profile), it provisions a new unclaimed WorkOS environment, called a one-shot environment in https://workos.com/auth.md. If it finds credentials, it uses them and creates nothing.