sumsub-integrate-id-connect — Claude Code skill
Walks your agent through the whole Sumsub ID Connect integration: sign-in button, code-to-token exchange, user consent and applicant creation in your workspace.
npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -a claude-codeWhat sumsub-integrate-id-connect does
The skill covers the OIDC-based “Verify with Sumsub ID” flow. A user signs in on Sumsub's side, approves sharing, and your app ends up with a signed token carrying verified claims such as age, name, nationality, email and country of residence.
Inside are a preconditions checklist, a scripts/preflight.sh script for automated validation, and a stage-by-stage recipe: the frontend button with a PKCE authorize redirect, the backend code → access_token exchange using client_secret_basic, share-token minting, the partner-consent shareLink branch, and applicant materialisation through /resources/api/reusableIdentity/reuse. Order matters here. The skill insists that Sumsub-side setup is confirmed and preflight exits clean before any code gets written; ask for a demo too early and the agent will explain what is still missing.
You need a sandbox App Token and secret pair from the Sumsub cockpit, plus ID Connect switched on for your workspace. That switch is a support action, not a self-serve toggle. Preflight checks for the sbx: prefix and fails on a production token. OIDC client registration and sharing-partner setup also live only in the dashboard UI. For the plain WebSDK widget, reach for sumsub-integrate-websdk instead.
What it helps with
- wire a “Verify with Sumsub ID” button into an app
- exchange the OIDC code for an access_token on the backend
- mint a share token and route the user through the consent screen
- create an applicant in your workspace from already-verified claims
- validate the environment before writing integration code
Example prompts for the agent
- Integrate Sumsub ID Connect: add the “Verify with Sumsub ID” button and the code-to-token exchange on the backend
- Check the preconditions and run
scripts/preflight.shbefore writing any code - The user didn't approve sharing — walk them through the shareLink and retry the share-token minting
How to install sumsub-integrate-id-connect
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-integrate-id-connect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-integrate-id-connect/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -a codex2Manually: put the files in place
.agents/skills/sumsub-integrate-id-connect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -a cursor2Manually: put the files in place
.cursor/skills/sumsub-integrate-id-connect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-integrate-id-connect2Manually: put the files in place
.github/skills/sumsub-integrate-id-connect/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-integrate-id-connectManually: put the files in place
.devin/skills/sumsub-integrate-id-connect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -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-integrate-id-connect
How do I install sumsub-integrate-id-connect in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-integrate-id-connect -a claude-code. The skill file lands at ~/.claude/skills/sumsub-integrate-id-connect/SKILL.md.
What does sumsub-integrate-id-connect do?
It guides your agent through the full Sumsub ID Connect OIDC flow: preconditions and preflight, the sign-in button, the code-to-token exchange, and applicant creation in your workspace.
What do I need before running the skill?
A sandbox App Token and secret pair from the Sumsub cockpit, and ID Connect enabled for your workspace. Enabling it is a Sumsub support action, not something you can toggle yourself.
