AIKraft/Skills/clerk backend api

clerk backend api

Clerk Backend REST API explorer and executor. Browse tags, inspect endpoint schemas, and execute authenticated requests. Use when listing users, managing organizations, or calling any Clerk API endpoint.

clerk official Разработка

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

Навык обеспечивает безопасное взаимодействие с Clerk Backend REST API, позволяя просматривать метаданные, изучать схемы эндпоинтов и выполнять аутентифицированные запросы. Он решает задачу получения списков пользователей, управления организациями и вызова любых API-эндпоинтов Clerk с обязательной предварительной проверкой прав доступа.

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

  • Получение списка пользователей в системе
  • Управление организациями через Clerk API
  • Вызов любого эндпоинта Clerk Backend API
  • Безопасное выполнение операций записи (POST/PATCH/PUT/DELETE) с проверкой scopes

Как работает

  1. Получить пользовательский запрос ($ARGUMENTS) для определения цели обращения к API.
  2. Перед любым запросом на запись (POST, PATCH, PUT, DELETE) проверить наличие переменной окружения CLERK_SECRET_KEY, выполнив команду echo.
  3. Если ключ пуст, остановить выполнение и запросить его у пользователя; не продолжать без валидного ключа.
  4. Проверить переменную окружения CLERK_BAPI_SCOPES, выполнив команду echo, и проанализировать вывод.
  5. Если необходимые права записи отсутствуют, сообщить пользователю о риске и предложить перезапустить с флагом --admin; не выполнять запрос, если права не подтверждены.
  6. После успешных проверок выполнить запрошенное действие (чтение или запись) через Clerk Backend API.

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

Получить список всех пользователей в организации
Создать новую организацию через Clerk API
Обновить профиль пользователя с помощью PATCH запроса

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

  • Переменная окружения CLERK_SECRET_KEY
  • Переменная окружения CLERK_BAPI_SCOPES
  • Доступ к Clerk Backend REST API

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

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

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

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