sumsub-conformance — Claude Code skill: check a Sumsub config against a regulation
Walks a live Sumsub configuration and answers one question per requirement: is it collected, scored, enforced? Flags the items that are gathered and scored but never acted on.
npx skills add sumsub/agent-skills --skill sumsub-conformance -a claude-codeWhat sumsub-conformance does
Point the skill at a requirements document — PDF or plain text — and it lines that document up against a tenant's deployed Sumsub configuration. Each requirement gets traced through the config graph to the place where the data is collected, where it is scored, and where something actually happens because of it. The finding it surfaces is the collected-but-not-enforced case: a questionnaire that gets scored and then routes nowhere.
Everything runs against read-only Sumsub endpoints, signed with App-Token HMAC. resolve_graph.sh builds the graph, trace.py and report.py produce the verdict, and python3 scripts/graph_summary.py "$CONFIG" prints the section and item indices when you want to look at the graph yourself. Output files land next to the regulation you fed in, named from its stem: <stem>_regulations.json, <stem>_config.json, <stem>_report.md.
You need SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY. Sandbox only — the helper turns down any token that does not start with sbx:, so a production pair has to be swapped out before the run. When the graph cannot be resolved the script stops there, and no verdict comes out of a partial graph. Treat the output as a gap report rather than a compliance guarantee: semantic intent and whatever the SDK does downstream still need a human to sign off.
What it helps with
- verify that every clause of a regulation is actually enforced in a tenant's config
- spot questionnaires and checks that collect data without acting on it
- close the generate-then-verify loop after building config with
sumsub-create-* - audit a client's setup against compliance rules
- get a per-requirement report instead of eyeballing workflow JSON
Example prompts for the agent
- Here's
Level4regulations.pdfand our tenant — show me what's actually enforced - Check whether our live config satisfies this requirements document and list the gaps
- We built the config with
sumsub-create-*, now run the conformance pass against the regulation
How to install sumsub-conformance
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-conformance -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-conformance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-conformance/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-conformance -a codex2Manually: put the files in place
.agents/skills/sumsub-conformance/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-conformance -a cursor2Manually: put the files in place
.cursor/skills/sumsub-conformance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-conformance2Manually: put the files in place
.github/skills/sumsub-conformance/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-conformance -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-conformanceManually: put the files in place
.devin/skills/sumsub-conformance/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-conformance -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-conformance
How do I install sumsub-conformance in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-conformance -a claude-code. The skill lands at ~/.claude/skills/sumsub-conformance/SKILL.md.
What does sumsub-conformance do?
It maps each requirement from a regulation onto a deployed Sumsub configuration and reports whether the data is collected, scored and enforced. Requirements that are collected and scored but never acted on get flagged separately.
Which Sumsub token does the skill need?
A sandbox pair: SUMSUB_APP_TOKEN starting with sbx: plus the matching SUMSUB_SECRET_KEY. Production tokens are rejected by the helper.