sumsub-create-workflow — скилл для Claude Code: воркфлоу Sumsub
Собирает воркфлоу проверки в Sumsub из компактного описания узлов и связей, валидирует черновик и публикует его. Публикация меняет живой трафик — это главное, что нужно знать.
npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a claude-codeЧто делает sumsub-create-workflow
Скилл превращает короткую схему узлов и связей в JSON-полезную нагрузку ApplicantWorkflow, прогоняет её через dry-run валидацию, сохраняет как черновик и затем публикует через PUT /{id}/revisionStatus. В ответ он сообщает name (kind), revision, revisionStatus и id. Воркфлоу бывает трёх видов: default для каждой проверки, actions для действий заявителя и test — изолированный, запускается вручную по заявителю и не публикуется. Каждое сохранение создаёт новую ревизию, а не новый воркфлоу.
Черновики трафик не маршрутизируют, поэтому создавать, обновлять и валидировать их безопасно. Публикация же переключает на новую ревизию весь реальный продакшен-трафик и автоматически архивирует предыдущую. Песочный токен sbx: тут не защита: ревизии общие для live и sandbox, изолированы только заявители. Поэтому публикация default и actions проходит через шлюз по текущей нагрузке — если на уровнях опубликованной ревизии больше 400 недавних заявителей или счётчик не читается, скилл требует чистую валидацию, сравнение с текущей ревизией, явное «да» и переменную SUMSUB_ALLOW_WORKFLOW_PUBLISH=1. Порог переопределяется через SUMSUB_PUBLISH_TRAFFIC_THRESHOLD. Счётчик считается по именам уровней, так что ревизии с общими именами показывают пересекающиеся числа.
Для работы нужен App Token с правом manageWorkflows и пара ключей из песочницы: SUMSUB_APP_TOKEN вида sbx:... и SUMSUB_SECRET_KEY.
Какие задачи решает
- собрать воркфлоу проверки из описания узлов и связей
- проверить схему маршрутизации до публикации
- добавить правила по стране и возрасту с шагом ручной проверки
- настроить теги и заметки после проверки
- выпустить новую ревизию воркфлоу, не задев живую
Примеры запросов агенту
- Создай воркфлоу: заявители из Германии старше 18 идут на уровень
kyc-de, остальные — на ручную проверку - Собери action-воркфлоу: после проверки ставь тег
verifiedи меняй source-key - Сделай черновик воркфлоу и покажи, что изменится по сравнению с текущей опубликованной ревизией
Как установить sumsub-create-workflow
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a claude-code2Вручную: положить файлы
~/.claude/skills/sumsub-create-workflow/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sumsub-create-workflow/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a codex2Вручную: положить файлы
.agents/skills/sumsub-create-workflow/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a cursor2Вручную: положить файлы
.cursor/skills/sumsub-create-workflow/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-create-workflow2Вручную: положить файлы
.github/skills/sumsub-create-workflow/SKILL.md1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a gemini-cli2Командой платформы
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-create-workflowВручную: положить файлы
.devin/skills/sumsub-create-workflow/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sumsub-create-workflow
Как установить sumsub-create-workflow в Claude Code?
Выполните npx skills add sumsub/agent-skills --skill sumsub-create-workflow -a claude-code. Скилл окажется в ~/.claude/skills/sumsub-create-workflow/SKILL.md.
Что делает sumsub-create-workflow?
Строит JSON воркфлоу Sumsub из компактной схемы, валидирует его dry-run и сохраняет черновик. Дальше публикует ревизию, если позволяет текущая нагрузка на её уровни.
Почему публикация воркфлоу опасна?
Ревизии общие для live и sandbox, поэтому публикация меняет воркфлоу для всего реального продакшен-трафика, а предыдущая ревизия уходит в архив. Песочный токен sbx: этого не отменяет.
