# sumsub-manage-client-lists

sumsub-manage-client-lists is a Claude Code skill that creates and updates Sumsub client lists for KYT rules and workflow checks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 352 installs · ★ 7 repo stars
- Author: sumsub
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-client-lists/SKILL.md
- Updated: 2026-10-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sumsub-manage-client-lists

## What it does

Client lists group together identifiers like country codes, emails, device IDs, or IP ranges. Rules and workflow conditions evaluate against them by name. The skill handles creating these sets, querying entries, resolving list IDs, and removing items through helper scripts.

Calls run against the public Sumsub API in sandbox mode. Authentication expects `SUMSUB_APP_TOKEN` starting with `sbx:`, paired with `SUMSUB_SECRET_KEY`. Production credentials are explicitly rejected. Reading data demands `seeClientLists` permission, while write calls require `manageClientLists`.

Values are pushed individually with limits of 2 requests per second and 300 per hour. Exceeding this limit returns a 429 response. When a list reaches 1000 items, the API refuses deletion with a 409 status. The tool blocks any attempt to delete `my_default_blocklist`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-client-lists -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumsub-manage-client-lists/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumsub-manage-client-lists/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-client-lists -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumsub-manage-client-lists/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-client-lists -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumsub-manage-client-lists/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills skills/sumsub-manage-client-lists
```

2. **Manually: put the files in place**
- File: `.github/skills/sumsub-manage-client-lists/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-client-lists -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-manage-client-lists
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumsub-manage-client-lists/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-client-lists -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-client-lists/SKILL.md

## When to use it
- create risk lists for Sumsub KYT rules and workflows
- insert or drop single entries in existing lists
- check if an IP or email address is on a list
- resolve list identifiers from exact list names

## Example prompts
- Create a high_risk_countries list in sandbox and add DEU to it
- Check whether user@example.com exists in our client list
- Remove an IP entry from the client list

## Similar
- [client-onboarding](https://affpapa.org/en/nevibecode/skills/client-onboarding.md) — skill · 723 installs
- [platform-trust-archive-manage](https://affpapa.org/en/nevibecode/skills/platform-trust-archive-manage.md) — skill · 5200 installs
- [client-report](https://affpapa.org/en/nevibecode/skills/client-report.md) — skill · 1200 installs
- [client-reporting-delivery](https://affpapa.org/en/nevibecode/skills/client-reporting-delivery.md) — skill · 707 installs
- [consuming-endpoints-from-client-code](https://affpapa.org/en/nevibecode/skills/consuming-endpoints-from-client-code.md) — skill · 322 installs
- [vscode-rest-client-generator](https://affpapa.org/en/nevibecode/skills/vscode-rest-client-generator.md) — skill · 259 installs

From the same set: [sumsub/agent-skills](https://affpapa.org/en/nevibecode/by/sumsub/agent-skills.md) — 28 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
