didit/skills
Official AI Agent Skills for the Didit Identity Verification Platform

didit.me · API Docs · Business Console · Agent Skills Standard

12 production-ready skills that teach AI agents how to call every Didit API — from account registration to identity verification, KYC workflows, AML screening, biometric checks, billing, and user management. Works with Cursor, Claude Code, Codex, OpenCode, and any agent that supports the Agent Skills standard.

Naming convention: Domain-term names that match how users naturally ask — face-match, proof-of-address, aml-screening, kyc-onboarding. Lowercase kebab-case, didit- namespaced. Every standalone skill includes a Getting Started section for account creation + credits.

Agents can go from nothing to a live verification link in 5 API calls:

1. POST /programmatic/register/      → register with any email
2. POST /programmatic/verify-email/   → verify OTP, get api_key
3. POST /v3/workflows/               → create verification workflow
4. PATCH /v3/webhook/                 → set webhook URL (no console needed)
5. POST /v3/session/                  → create session → get verification URL

Install all skills at once:

npx skills add didit-protocol/skills

Or install a specific skill:

npx skills add didit-protocol/skills --skill didit-face-match

Works with Cursor, Claude Code, Codex, and OpenCode. The CLI auto-detects your agent and installs to the correct directory.

git clone https://github.com/didit-protocol/skills.git

Copy the skills you need from skills/ into your agent's skill directory.

Copy any skills/<name>/SKILL.md into your agent's skill directory. Each skill is self-contained.

No console needed — agents can self-register:

# 1. Register (any email works)
curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@gmail.com", "password": "MyStr0ng!Pass"}'

# 2. Check email for 6-char code, then verify
curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@gmail.com", "code": "A3K9F2"}'
# → response includes api_key

export DIDIT_API_KEY="the_api_key_from_response"

1. Get an API key from Didit Business Console → API & Webhooks
2. Set the environment variable:

export DIDIT_API_KEY="your_api_key"

3. (Optional) For webhook verification:

export DIDIT_WEBHOOK_SECRET="your_secret"      # from Console → API & Webhooks

4. Talk to your agent. Once skills are installed, just ask naturally:

"Register a Didit account for me" "Create a KYC workflow with ID scan and liveness" "Create a verification session for this user" "Check my credit balance" "Screen John Smith against AML databases"

51 endpoints total, all tested.

export DIDIT_API_KEY="your_key"
export DIDIT_WORKFLOW_ID="your_workflow_id"
python3 tests/test_all_skills.py

RESULTS: 51/51 passed, 0 failed

skills/                              ← 12 skills (1 hub + 1 KYC recipe + 10 standalone)
├── didit-verification-management/    SKILL.md + scripts/{setup_account,manage_workflows,create_session}.py
├── didit-kyc-onboarding/             SKILL.md + scripts/run_kyc.py
├── didit-id-document-verification/   SKILL.md + scripts/verify_id.py
├── didit-liveness-detection/         SKILL.md + scripts/check_liveness.py
├── didit-face-match/                 SKILL.md + scripts/match_faces.py
├── didit-face-search/                SKILL.md + scripts/search_faces.py
├── didit-biometric-age-estimation/   SKILL.md + scripts/estimate_age.py
├── didit-email-verification/         SKILL.md + scripts/verify_email.py
├── didit-phone-verification/         SKILL.md + scripts/verify_phone.py
├── didit-aml-screening/              SKILL.md + scripts/screen_aml.py
├── didit-proof-of-address/           SKILL.md + scripts/verify_address.py
└── didit-database-validation/        SKILL.md + scripts/validate_database.py
tests/test_all_skills.py            ← 51 endpoint test suite

Each SKILL.md follows the three-tier information architecture:

1. Metadata (always loaded): Domain-term name + trigger-based description in YAML frontmatter (~100 tokens)
2. Skill body (loaded on invocation): Full API documentation, examples, and workflows
3. Scripts (lazy loaded): Python CLI utilities referenced by the skill body

---
name: didit-verification-management
description: >
  Full Didit identity verification platform management...
version: 4.1.0
metadata:
  openclaw:
    requires:
      env: []
    primaryEnv: DIDIT_API_KEY
    emoji: "🛡️"
    homepage: https://docs.didit.me
---

1. Fork the repo
2. Update or add a skill in skills/
3. Run python3 tests/test_all_skills.py to verify
4. Open a PR

MIT — see LICENSE.