sumsub-api-generic — Claude Code skill: what it does, how to install
Finds and tests Sumsub API endpoints using an OpenAPI specification. Designed for developer tasks not handled by dedicated workflow skills.
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a claude-codeWhat sumsub-api-generic does
This skill handles calls against api.sumsub.com when specialized modules like questionnaire or level builders do not fit. It fetches the official OpenAPI 3.0.1 specification and caches it for 24 hours. The agent avoids path guessing by checking routes through find_endpoint.py and reading schemas with show_endpoint.py.
Calls go through sumsub_curl.sh, which generates an HMAC-SHA256 signature for each payload. The script strictly rejects production credentials and requires sandbox tokens starting with sbx:. Path parameters must be resolved before signing, and the agent asks for confirmation before sending destructive write actions.
What it helps with
- find matching endpoints in the OpenAPI schema without guessing paths
- inspect request payloads and response shapes for Sumsub routes
- sign requests using HMAC-SHA256 and sandbox App Tokens
- fetch applicant verification states and review AML screening hits
Example prompts for the agent
- Find the Sumsub API endpoint for attaching tags to an applicant
- Inspect the request body schema for updating applicant records
- Send a signed sandbox request to fetch AML hits for applicant sbx_test
How to install sumsub-api-generic
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-api-generic/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-api-generic/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a codex2Manually: put the files in place
.agents/skills/sumsub-api-generic/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a cursor2Manually: put the files in place
.cursor/skills/sumsub-api-generic/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-api-generic2Manually: put the files in place
.github/skills/sumsub-api-generic/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-api-genericManually: put the files in place
.devin/skills/sumsub-api-generic/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-generic -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sumsub-api-generic
How to install sumsub-api-generic in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-api-generic -a claude-code in your terminal.
What does sumsub-api-generic do?
It serves as a fallback tool for any Sumsub API action not covered by dedicated skills. It discovers endpoints from the schema, explains parameters, and dispatches signed sandbox calls.
Does the skill allow production API keys?
No. The execution helper halts immediately if the App Token lacks the sbx: sandbox prefix.