skills.json

{
  "$schema": "https://raw.githubusercontent.com/anthropics/skills/main/schema/skills.json",
  "name": "@sumsub/agent-skills",
  "version": "1.1.0",
  "skills": [
    {
      "name": "sumsub-api-auth",
      "path": "./skills/sumsub-api-auth",
      "entry": "SKILL.md",
      "description": "Authenticate to the Sumsub API with an App Token + secret key (HMAC-SHA256 request signing). Sandbox tokens only."
    },
    {
      "name": "sumsub-create-questionnaire",
      "path": "./skills/sumsub-create-questionnaire",
      "entry": "SKILL.md",
      "description": "Create or update a Sumsub KYC questionnaire definition. POST /resources/api/agent/questionnaires to create (409 if id exists), PATCH same path to update (404 if id is unknown), GET /resources/api/agent/questionnaires/{id} to read."
    },
    {
      "name": "sumsub-create-poa-preset",
      "path": "./skills/sumsub-create-poa-preset",
      "entry": "SKILL.md",
      "description": "Create or update a Sumsub PoaStepSettings (Proof-of-Address preset). POST /resources/api/agent/poaStepSettings to create, PATCH same path to update (id in body), GET /resources/api/agent/poaStepSettings/{id} to read. Returned id attaches to a level's PROOF_OF_RESIDENCE doc-set."
    },
    {
      "name": "sumsub-create-level",
      "path": "./skills/sumsub-create-level",
      "entry": "SKILL.md",
      "description": "Create or update a Sumsub ApplicantLevel. POST /resources/applicants/-/levels to create, PATCH same path to update (id in body), GET /resources/applicants/-/levels/{id} to read. Compact docSet spec → full payload."
    },
    {
      "name": "sumsub-create-cross-check-preset",
      "path": "./skills/sumsub-create-cross-check-preset",
      "entry": "SKILL.md",
      "description": "Create or update a Sumsub cross-check preset (POI↔POA name/address comparison rules) via POST/PATCH /resources/api/agent/crossCheckPresets. Use ONLY when the user explicitly asks to override cross-check defaults; Sumsub's default preset is tuned for best approval rate and should not be replaced casually."
    },
    {
      "name": "sumsub-create-workflow",
      "path": "./skills/sumsub-create-workflow",
      "entry": "SKILL.md",
      "description": "Create a Sumsub applicant workflow (verification routing or action workflow) via the public API: compact node/edge spec → draft → validate → publish, gated by live traffic (automatic when low, confirmed when high). Publishing changes live traffic — see the Danger section."
    },
    {
      "name": "sumsub-create-transaction",
      "path": "./skills/sumsub-create-transaction",
      "entry": "SKILL.md",
      "description": "Submit a transaction to Sumsub Transaction Monitoring (KYT). Compact spec → full KytTxnData payload → POST /resources/applicants/{id|-}/kyt/txns/-/data (auto-routed for existing vs non-existing applicants). Covers finance, travelRule, and userPlatformEvent variants."
    },
    {
      "name": "sumsub-integrate-websdk",
      "path": "./skills/sumsub-integrate-websdk",
      "entry": "SKILL.md",
      "description": "End-to-end Sumsub WebSDK integration for a web app. Covers level setup, server-signed access-token endpoint, snsWebSdk init (vanilla + React), client lifecycle events, webhook signature verification (including ngrok-based local testing), server-side status reads, sandbox testing, and go-live checklist."
    },
    {
      "name": "sumsub-api-generic",
      "path": "./skills/sumsub-api-generic",
      "entry": "SKILL.md",
      "description": "Fallback catch-all for Sumsub API tasks not covered by a more specific skill. Searches the bundled OpenAPI schema, builds the payload, signs with App Token, and validates."
    },
    {
      "name": "sumsub-check-permissions",
      "path": "./skills/sumsub-check-permissions",
      "entry": "SKILL.md",
      "description": "Fetch the current tenant's allowed entitlements (BackgroundCheckTarget list). Returns JSON with `allowed` (array of permission keys) and `descriptions` (map of key → label). Called by create-* skills before building a payload to gate entitlement-required features."
    },
    {
      "name": "sumsub-check-skills-version",
      "path": "./skills/sumsub-check-skills-version",
      "entry": "SKILL.md",
      "description": "Check whether the installed Sumsub agent-skills package is up to date. Fetches the canonical version from https://api.sumsub.com/llms.txt and compares it to the locally installed version: warns on a patch-level drift, and recommends re-running `npx skills add SumSubstance/agent-skills --all` on a minor/major drift."
    },
    {
      "name": "sumsub-analyze-regulation",
      "path": "./skills/sumsub-analyze-regulation",
      "entry": "SKILL.md",
      "description": "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). Entry point before invoking create-level, create-questionnaire, create-poa-preset, create-workflow, and other skills."
    },
    {
      "name": "sumsub-manage-webhooks",
      "path": "./skills/sumsub-manage-webhooks",
      "entry": "SKILL.md",
      "description": "Manage Sumsub clientWebhooks (event subscriptions): list (oldest 50) and GET /{id} via /resources/api/clientWebhooks; create (POST), update (PATCH), and disable/enable via /resources/api/agent/clientWebhooks. Sandbox only — production webhooks must be created by a human directly in the dashboard. Delete and per-webhook delivery stats are dashboard-only and not covered by this skill."
    }
  ]
}