AIKraft/AI/Войти
AIKraft/Skills/Виджеты WorkOS

Виджеты WorkOS

Use when the user is implementing, embedding, or debugging a WorkOS Widget — specifically the User Management, User Profile, Admin Portal SSO Connection, or Admin Portal Domain Verification widgets. Handles the full stack — detecting the frontend (Next.js, React, React Router, TanStack Start, Vite, SvelteKit), generating access tokens via the backend SDK in use (Node, Python, Go, Ruby, PHP, Ja

workos official Дизайн

Что делает навык

Skill обеспечивает интеграцию виджетов WorkOS (User Management, User Profile, Admin Portal SSO Connection, Admin Portal Domain Verification) в проекты на различных фронтенд- и бэкенд-стеках. Он автоматизирует обнаружение окружения, установку зависимостей и реализацию логики взаимодействия с API WorkOS с учетом архитектурных паттернов проекта.

Когда применять

  • Встраивание виджета User Management или User Profile в приложение на Next.js, React Router, TanStack Start, Vite или SvelteKit.
  • Настройка Admin Portal SSO Connection или Admin Portal Domain Verification в проектах с бэкендом на Node, Python, Go, Ruby, PHP или Java.
  • Генерация access token и настройка авторизации для виджетов в существующей архитектуре приложения.
  • Отладка и валидация маршрутизации, импортов и использования API WorkOS в мультисервисных или монолитных приложениях.

Как работает

  1. Определить целевой виджет из запроса пользователя и просканировать проект (manifests, entrypoints, auth utilities) для обнаружения стека и наличия AuthKit/WorkOS.
  2. Если WorkOS не обнаружен, запросить у пользователя запуск команды WORKOS_MODE=agent npx workos@latest install и дождаться подтверждения.
  3. Загрузить соответствующие справочные файлы (references/detection.md, references/token-strategies.md и специфичные для фреймворка/виджета).
  4. Реализовать интеграцию: создать компонент виджета и маршрут/страницу, если UI находится в том же приложении, или токен-эндпоинт и клиентскую интеграцию, если архитектура бэкенд-ориентированная.
  5. Использовать прямые HTTP-запросы (fetch) или клиентские библиотеки для вызова API, соблюдая схемы OpenAPI и конвенции проекта.
  6. Обеспечить явную обработку состояний загрузки, пустых данных и ошибок, а также обновление данных после успешных мутаций.

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

Добавь виджет User Profile в мой Next.js проект, используя существующую систему аутентификации.
Настрой Admin Portal SSO Connection для приложения на Python FastAPI с фронтендом на React.
Внедри виджет Domain Verification в SvelteKit приложение и обеспечь генерацию токена через бэкенд.

Что понадобится

  • Наличие или возможность установки пакета workos через npx (команда WORKOS_MODE=agent npx workos@latest install).
  • Доступ к OpenAPI спецификации WorkOS для валидации путей и схем запросов/ответов.
  • Определенный пакет менеджер проекта (npm, yarn, pnpm, pip, go mod и т.д.) для установки зависимостей.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «workos-widgets» из репозитория: # https://github.com/workos/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r workos-widgets/ ~/.claude/skills/workos-widgets/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.