sumsub-api-generic — скилл для Claude Code: функции и установка
Помогает находить и безопасно вызывать методы Sumsub API через официальную схему OpenAPI. Пригодится для задач, не закрытых узкими скиллами интегратора.
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a claude-codeЧто делает sumsub-api-generic
Скилл служит запасным инструментом для любых запросов к api.sumsub.com, когда профильные сценарии вроде создания уровней или опросников не подходят. Вместо ручного подбора URL агент обращается к локально кэшированной спецификации OpenAPI 3.0.1. Встроенный поиск через скрипт find_endpoint.py отбирает точный путь, после чего show_endpoint.py разбирает обязательные поля, параметры пути и структуру тела.
Запросы отправляются через скрипт sumsub_curl.sh, рассчитывающий подпись HMAC-SHA256 из таймстемпа, метода, пути и тела. Здесь действует жёсткое правило безопасности: утилита принимает только токены песочницы с префиксом sbx: и блокирует боевые ключи. Подставлять пути наугад запрещено, поэтому агент сначала сверяет структуру со спецификацией.
Какие задачи решает
- найти нужный маршрут в спецификации OpenAPI без угадывания путей
- проверить обязательные поля и параметры перед отправкой запроса
- подписать вызов HMAC-SHA256 тестовыми ключами песочницы
- запросить актуальный статус заявителя или проверить совпадения по AML
Примеры запросов агенту
- Найди в Sumsub API эндпоинт для добавления тегов заявителю
- Покажи схему тела запроса для обновления данных заявителя
- Сделай тестовый запрос к песочнице Sumsub и проверь статус проверки заявителя
Как установить sumsub-api-generic
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a claude-code2Вручную: положить файлы
~/.claude/skills/sumsub-api-generic/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sumsub-api-generic/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a codex2Вручную: положить файлы
.agents/skills/sumsub-api-generic/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a cursor2Вручную: положить файлы
.cursor/skills/sumsub-api-generic/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-api-generic2Вручную: положить файлы
.github/skills/sumsub-api-generic/SKILL.md1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a gemini-cli2Командой платформы
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-api-genericВручную: положить файлы
.devin/skills/sumsub-api-generic/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sumsub-api-generic
Как установить sumsub-api-generic в Claude Code?
Выполните команду npx skills add sumsub/agent-skills --skill sumsub-api-generic -a claude-code.
Для чего предназначен скилл sumsub-api-generic?
Он закрывает любые нестандартные вызовы к API Sumsub, для которых нет специализированных скиллов. Инструмент сверяет пути по OpenAPI, собирает тело запроса и проверяет ответы.
Работает ли скилл с боевыми API-ключами?
Нет, встроенный скрипт sumsub_curl.sh сразу отклоняет ключи без префикса sbx:. Работа разрешена только в тестовой песочнице.
