bulk-user-onboarding-pattern

What problem does it solve?

This Skill solves the problem of safely onboarding many users at once without creating duplicates or missing failures during repeated runs.

Core Features & Use Cases

• CSV/JSON bulk ingestion: Converts each input record into an admin API call, supporting optional per-user device labeling.
• Idempotent duplicate detection: Fetches the existing user list once, caches it in-memory, and skips already-present usernames to prevent duplicate accounts.
• Operational counters and failure signaling: Reports explicit new/dup/fail counters and returns a non-zero exit code when failures occur, making it CI/cron friendly.

Use case example: migrate 50 production users by running a CSV-based import, then re-run the same file to confirm it produces zero new users and only counts duplicates, while key issuance (optional) happens only when registration succeeds.

Quick Start

Use the bulk-user-onboarding-pattern skill to idempotently import users from a CSV by running install.sh bulk-user-onboarding-pattern and then executing the provided bulk-users.sh template with your API_BASE, ADMIN_TOKEN, and users CSV.