skill CX Codex

sumsub-create-questionnaire — Claude Code skill for Sumsub forms

Q: How do I install sumsub-create-questionnaire in Claude?

Run `npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a claude-code`. The skill lands in `~/.claude/skills/sumsub-create-questionnaire/SKILL.md`.

Q: What permissions and tokens does the skill need?

The `QUESTIONNAIRE` key must be present in `allowedChecks`; the skill verifies this through `sumsub-check-permissions` and stops if it is missing. Only sandbox tokens work — the script rejects anything that does not start with `sbx:`.

Turns a short spec into a Sumsub KYC questionnaire definition, pushes it to the API and hands back the id for level wiring.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a claude-code

Open on GitHub

What sumsub-create-questionnaire does

The skill takes a compact list of sections and questions, expands it into the full JSON payload and sends it to Sumsub. New questionnaires go through POST /resources/api/agent/questionnaires, updates through PATCH on the same path, and GET /resources/api/agent/questionnaires/{id} reads one back. The work sits in build_questionnaire.py, post_questionnaire.sh, patch_questionnaire.sh and get_questionnaire.sh; the spec arrives on stdin, so you never hand-write the localized payload.

Before anything else it checks tenant entitlements with sumsub-check-permissions: QUESTIONNAIRE has to appear in allowedChecks. Miss it and the skill stops, pointing you at your CSM or Sumsub support. Auth uses an App Token plus secret, and only sandbox pairs are accepted — the helper script rejects tokens that do not start with sbx:. A production token gets refused, so this is not the route for a live tenant.

POST and PATCH are strict now. POST returns 409 CONFLICT when the id is taken, PATCH returns 404 NOT_FOUND for an unknown one. Unsure whether the questionnaire exists? Call get_questionnaire.sh first. The response carries id and clientId, which the skill turns into a sandbox dashboard link.

What it helps with

build a KYC questionnaire definition from a list of questions
update an existing Sumsub questionnaire by its id
read a questionnaire back and check what landed
wire conditional questions to real section and item ids
get a sandbox link to the questionnaire for review

Example prompts for the agent

create a Sumsub questionnaire with a source-of-funds section and a salary question
update the source-of-funds questionnaire and add an other-source question
read the source-of-funds questionnaire and show me what is in it now

How to install sumsub-create-questionnaire

1Skills CLI (Vercel)

npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a claude-code

2Manually: put the files in place

~/.claude/skills/sumsub-create-questionnaire/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sumsub-create-questionnaire/

1Skills CLI (Vercel)

npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a codex

2Manually: put the files in place

.agents/skills/sumsub-create-questionnaire/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a cursor

2Manually: put the files in place

.cursor/skills/sumsub-create-questionnaire/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install sumsub/agent-skills sumsub-create-questionnaire

2Manually: put the files in place

.github/skills/sumsub-create-questionnaire/SKILL.md

1Skills CLI (Vercel)

npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a gemini-cli

2Platform CLI

gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-create-questionnaire

Manually: put the files in place

.devin/skills/sumsub-create-questionnaire/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sumsub-create-questionnaire

How do I install sumsub-create-questionnaire in Claude?

Run npx skills add sumsub/agent-skills --skill sumsub-create-questionnaire -a claude-code. The skill lands in ~/.claude/skills/sumsub-create-questionnaire/SKILL.md.

What does sumsub-create-questionnaire do?

It builds a Sumsub questionnaire definition from a compact spec and sends it to the API — POST for a new one, PATCH for an existing one. The response gives you the id and a sandbox link.

What permissions and tokens does the skill need?

The QUESTIONNAIRE key must be present in allowedChecks; the skill verifies this through sumsub-check-permissions and stops if it is missing. Only sandbox tokens work — the script rejects anything that does not start with sbx:.

Similar skills

All skills for Backend and APIs →

to-questionnaire Matt Pocock Turns a decision you cannot answer alone into a Markdown questionnaire for someone with the missing context. Use it to collect answers asynchronously or work through questions in a meeting. 498,319installs connect-required-verification-information stripe Guides the agent through Stripe Connect verification rules to determine KYC requirements, onboarding fields, and documents for connected accounts. CX Codex +1 1,400installs create-tool vapi Helps design, create, and attach tools to Vapi voice assistants through the public API. Supports native telephony controls, external integrations, declarative HTTP requests, and MCP servers. CX Codex +1 925installs create-squad vapi Decides whether a use case needs a multi-assistant Squad or a single assistant, then builds and verifies the Squad through the public Vapi API. CX Codex +1 884installs chainlink-ace-skill smartcontractkit A skill for Chainlink ACE work: PolicyEngine, Cross-Chain Identity, KYC and AML, sanctions screening, and onchain compliance rules. CX Codex +1 310installs x-ray-a-company UseOSINT Works a company in four layers: legal entity, ownership, people, infrastructure and risk. Useful before you sign a contract or pay an invoice. CX Codex +1 2,100installs

From the same set11

sumsub-create-cross-check-preset 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. CX Codex +1 1,200installs sumsub-create-level Turns a short list of verification steps into a Sumsub applicant level, posts it to the API and shows what the server actually kept. CX Codex +1 1,200installs sumsub-integrate-websdk Walks a web project through the full Sumsub KYC integration, from picking a level to the webhook that finally grants the user access. CX Codex +1 1,200installs sumsub-check-skills-version Compares your installed Sumsub agent-skills package against the published version and warns you when the skills are stale. Runs before Sumsub work. CX Codex +1 1,200installs sumsub-conformance 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. CX Codex +1 973installs sumsub-integrate-dint-websdk Adds Sumsub Device Intelligence to an existing WebSDK flow. Use it to bind device signals to an applicant and read device risk labels. CX Codex +1 960installs sumsub-integrate-id-connect 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. CX Codex +1 960installs sumsub-integrate-msdk Walks an agent through adding Sumsub Mobile SDK to a native iOS or Android app, from dependency install to launching the verification screen. CX Codex +1 958installs