sumsub-supported-id-documents — Claude Code skill: what it does
sumsub-supported-id-documents reads Sumsub's document catalogue and edits document-type settings per country via API.
no license 813 installs ★ 7 updated 2026-10-02
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a claude-codeWhat sumsub-supported-id-documents does
The skill works with two layers: the built-in documentsByCountries reference (which document types each country supports, whether they are double-sided, which OCR fields are extracted by default and optionally available) and custom overrides via idDocSettings.countryMappings. It answers queries like 'which countries support field X', 'is the ID card double-sided in France', and edits field sets or toggles document types for a given country. The reference is large — around 250 countries and 1350 country/type pairs — so a local Python script returns only the relevant slice.
Writing to the API works via PUT replacement of the entire countryMappings map: the skill reads current settings, applies the change, and sends the full map back. Requires an App Token with manageClientSettings permission and a secret key, stored in SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY variables. Sandbox tokens only.
Includes build_country_mappings.py (reads, modifies, assembles the full payload) and remove_country_mapping.py (removes one entry from the map). GET /resources/api/agent/supportedDocs/documentsByCountries reads the catalogue, GET /resources/api/agent/globalSettings fetches the client's current settings, PUT /resources/api/agent/globalSettings/idDocSettings/countryMappings replaces the map wholesale.
What it helps with
- find out which document types a country accepts and which fields OCR extracts
- enable or disable a document type for a specific country
- change the set of collected document fields in level settings
- check whether a document is double-sided by Sumsub's standard
Example prompts for the agent
- What OCR fields are available for a passport in Germany?
- Enable ID card collection for France and add the
middleNamefield - Is the driver's licence double-sided by default in Brazil?
How to install sumsub-supported-id-documents
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-supported-id-documents/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-supported-id-documents/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a codex2Manually: put the files in place
.agents/skills/sumsub-supported-id-documents/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a cursor2Manually: put the files in place
.cursor/skills/sumsub-supported-id-documents/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills skills/sumsub-supported-id-documents2Manually: put the files in place
.github/skills/sumsub-supported-id-documents/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-supported-id-documentsManually: put the files in place
.devin/skills/sumsub-supported-id-documents/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -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-supported-id-documents
How to install sumsub-supported-id-documents in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-supported-id-documents -a claude-code, then open ~/.claude/skills/sumsub-supported-id-documents/SKILL.md.
What does sumsub-supported-id-documents do?
Reads Sumsub's document-type reference by country (which are supported, whether double-sided, which OCR fields) and edits custom settings via API — toggles types, changes field sets.
What permissions are required to write document settings?
An App Token with manageClientSettings permission and a secret key. The skill works only with sandbox tokens, which must be placed in SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY variables.