Sumsub Analyze Regulation
Analyze a regulation document (PDF or text) and produce a Sumsub configuration plan — mapping regulatory requirements to Sumsub entities (levels, questionnaires, PoA presets, TM rules, workflows, AML resolution rules). TRIGGER when the user provides a regulation PDF, legal act, or compliance requirement document and wants to know what to configure in Sumsub. Acts as the entry point before invoking sumsub-create-level, sumsub-create-questionnaire, sumsub-create-poa-preset, sumsub-create-workflow, sumsub-create-aml-resolution-rules, and other skills. SKIP for direct entity creation requests (no regulatory context) or Sumsub API calls.
- Skill ID
- sumsub/agent-skills/sumsub-analyze-regulation
- Publisher
- sumsub
- Repository
- agent-skills
- Installs
- 0
- Files
- 1
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
sumsub/agent-skills/sumsub-analyze-regulationInstalls these files- SKILL.md
What this skill tells the agent
Sumsub — Analyze Regulation
Reads a regulation document and produces a structured Sumsub configuration plan — mapping each regulatory requirement to the Sumsub entities that satisfy it, with a clear split between what can be configured now via skills and what requires the Sumsub Dashboard.
This is a planning skill only. It produces a text description, never JSON payloads or API calls.
Workflow
Step 1 — Gather context
Before analyzing, collect:
- Jurisdiction — if the document covers multiple countries or is ambiguous, ask explicitly: _"This regulation covers [list of countries]. Which jurisdiction should the plan focus on?"_ Do not generate a plan for all jurisdictions simultaneously without a direct request to do so.
- Business type — crypto exchange, neobank, iGaming, fintech, or other. Ask if not clear from the document.
- Client types — individuals, companies, or both.
- Existing Sumsub setup — has the user already configured anything? Avoid suggesting duplicates.
Step 2 — Analyze (think before responding)
Use extended thinking before formulating the response. Extract from the document:
- Customer identification requirements (who must be identified, what data is required)
- Acceptable identity documents (national ID, passport, tax number, etc.)
- Address verification requirements (what documents are accepted, maximum age)
- Enhanced Due Diligence conditions (what triggers EDD)
- Source of funds / wealth / PEP data collection requirements
- AML screening obligations (PEP / sanctions / adverse media) and how screening hits must be handled (false-positive clearing, PEP review policy, escalation of confirmed matches)
- Transaction monitoring requirements (thresholds, suspicious patterns, crypto Travel Rule)
- Periodic re-KYC obligations (how often customers must be re-verified)
- What is out of scope for Sumsub (data retention timelines, regulatory reporting, sanctions list maintenance)
Step 3 — Validate understanding first
After analysis, present a short "My Understanding" block — bullet points of extracted requirements — and ask: _"Have I understood the key requirements correctly? Anything to add or correct?"_
Do not generate the full plan until the user confirms. This is mandatory.
Step 4 — Generate the plan
Only after user confirmation, produce the full configuration plan using the output format below.
Sumsub Capability Map
A. Verification Levels — sumsub-create-level
Defines the sequence of verification steps an applicant must complete. Each step is a docSet.
Available docSet types:
| Type | Purpose |
|---|---|
IDENTITY | Document verification: PASSPORT, ID_CARD, DRIVERS, RESIDENCE_PERMIT, VOTER_ID, etc. Can be restricted by issuing country. |
SELFIE / SELFIE2 | Biometrics and liveness. |
APPLICANT_DATA | Personal data collection: full name, date of birth, address, nationality, tax number (TIN/CPF/CNPJ/etc.). |
PROOF_OF_RESIDENCE / PROOF_OF_RESIDENCE2 | Address document verification. References a PoA preset by poaStepSettingsId. |
PHONE_VERIFICATION / EMAIL_VERIFICATION | Contact verification via OTP. |
QUESTIONNAIRE / QUESTIONNAIRE2–4 | Custom form. References a questionnaire definition by questionnaireDefId. |
E_KYC | Non-document electronic verification against external databases. See E-KYC section. |
DEVICE_CHECK | Device intelligence and fingerprinting. Requires DEVICE_INTELLIGENCE license. |
COMPANY | KYB: company info collection. |
COMPANY_DATA | KYB: company data fields. |
COMPANY_DOCUMENTS | KYB: corporate documents upload. |
COMPANY_BENEFICIARIES | KYB: UBOs and representatives verification. |
ACCREDITED_INVESTOR | Accredited investor qualification. |
E_SIGN | Electronic signature capture. |
TR_RECIPIENT_INFORMATION | Travel Rule recipient data collection. |
Level properties:
applicantType:individualorcompanyrequiredIdDocs: the ordered list of docSets + optionalincludedCountries/excludedCountriesdisableWatchlists: set totrueif tenant hasWATCHLISTSentitlement but needs to disable AML Screening for a particular levelcrossCheckPresetId: cross-check preset for AML screening
IDENTITY — document type codes
Sumsub uses generic IdDocType values regardless of what the document is locally called. Map the regulation's document names to these types:
| Generic document class | Sumsub IdDocType |
|---|---|
| International / biometric passport | PASSPORT |
| National identity card (any country) | ID_CARD |
| Driver's licence | DRIVERS |
| Residence / immigration permit | RESIDENCE_PERMIT |
| Voter ID | VOTER_ID |
| Documents with no dedicated Sumsub type (e.g. tax cards, social security cards) | OTHER_DOCS |
includedCountries / excludedCountries use ISO-3166 alpha-3 (e.g. BRA, USA, DEU).
Two-sided capture should be specified whenever a mandatory identifier (tax number, national number) appears on the back of the document.
SELFIE — liveness options (videoRequired)
| Value | Description | Use when |
|---|---|---|
passiveLiveness | Default. Advanced passive liveness, no movement required. | Standard KYC — no stricter regulatory mandate. |
activeLiveness | Active motion challenge (head movement detection). | Regulation explicitly requires active/dynamic liveness. |
enabled | Short video — applicant pronounces displayed digits. | Regulation requires video identity check. |
photoRequired | Photo-only selfie, no liveness. | Use only when explicitly requested; generally insufficient for AML compliance. |
staticLiveness | Single-frame analysis. | Use only when explicitly requested. |
For most AML/KYC regulations without a specific liveness requirement, default to passiveLiveness.
APPLICANT_DATA — common field names
Standard personal-data fields:
| Field name | Meaning |
|---|---|
firstName | First / given name |
lastName | Last / family name |
dob | Date of birth |
country | Country of residence (ISO-3166 alpha-3) |
town | City / town |
street | Street address |
postCode | Postal / ZIP code |
nationality | Nationality (ISO-3166 alpha-3) |
placeOfBirth | Place of birth |
tin | Tax identification number (TIN, CPF, SSN, BSN, etc.) |
When a regulation mandates collection of a national tax or identity number, map it to tin and mark it required: true.
DEVICE_CHECK — what it detects
When DEVICE_INTELLIGENCE license is active, this step flags: emulators, rooted/jailbroken devices, VPN/proxy/Tor connections, remote-desktop software, and crypto-mixer tools. Always note in the plan that this step silently falls back to disabled if the tenant lacks the entitlement — add a GET-back verification step.
B. Questionnaires — sumsub-create-questionnaire
Custom forms for collecting applicant data not captured by document checks.
Common use cases: source of funds, source of wealth, employment, PEP self-declaration, trading experience, risk profile.
Question types: text, textArea, date, dateTime, bool, select, selectDropdown, multiSelect, phone, countrySelect, countryMultiSelect, fileAttachment, multiFileAttachments.
Conditional logic: sections and items can be shown/hidden based on previous answers.
Risk scoring: each answer option can carry a score (0–100); scores sum automatically and can be referenced in downstream transaction monitoring rules.
More from sumsub
Use this skill in a project
Open any RiverX project, search the Skills panel for sumsub/agent-skills/sumsub-analyze-regulation, and install it in one click.
