sumsub-create-cross-check-preset — Claude Code skill
Creates and edits Sumsub cross-check presets, the rules that decide how names and addresses on POI and POA documents are compared. Useful when the shipped defaults do not fit.
npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -a claude-codeWhat sumsub-create-cross-check-preset does
The skill drives the public Sumsub API. POST and PATCH /resources/api/agent/crossCheckPresets write a preset, and GET /resources/api/agent/crossCheckPresets/{id} reads one back. Helper scripts do the work: build_cross_check_preset.py turns a compact spec on stdin into a request body, while post_cross_check_preset.sh, patch_cross_check_preset.sh and get_cross_check_preset.sh send it. The caller needs the manageClientSettings permission.
A preset picks nameComparisonMode and addressComparisonMode from a short list of values and can carry ignore-flags, such as skipping a middle-name mismatch. Only basic mode is available here. Advanced mode is off limits through the API: POST answers with 403 Forbidden, so it has to be configured in the dashboard.
You supply SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY. Sandbox tokens only — the scripts reject anything that does not start with sbx:. That guard matters, because a workspace-level preset changes every verification running on the account. One more thing to know: if a PoA preset carries its own crossValidator, that block wins for the documents it handles.
What it helps with
- require an exact name match between POI and POA
- allow fuzzy matching on addresses
- stop flagging a middle-name difference as a mismatch
- build the request body for a new preset
- read an existing preset and show the diff before editing
Example prompts for the agent
- Switch name comparison to strict and create a cross-check preset
- Allow fuzzy address matching in the cross-check rules
- Ignore middle-name mismatches and build a minimal preset
How to install sumsub-create-cross-check-preset
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-create-cross-check-preset/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-create-cross-check-preset/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -a codex2Manually: put the files in place
.agents/skills/sumsub-create-cross-check-preset/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -a cursor2Manually: put the files in place
.cursor/skills/sumsub-create-cross-check-preset/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-create-cross-check-preset2Manually: put the files in place
.github/skills/sumsub-create-cross-check-preset/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-create-cross-check-presetManually: put the files in place
.devin/skills/sumsub-create-cross-check-preset/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -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-create-cross-check-preset
How do I install sumsub-create-cross-check-preset in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-create-cross-check-preset -a claude-code. The skill lands at ~/.claude/skills/sumsub-create-cross-check-preset/SKILL.md.
What does sumsub-create-cross-check-preset do?
It creates or updates a Sumsub cross-check preset, the rule set that governs how names and addresses are compared across POI and POA documents. It talks to the public Sumsub API.
What do I need before running it?
A SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY pair, with the token taken from the sandbox — the scripts turn down values without the sbx: prefix. SUMSUB_BASE is optional.
