forcedotcom/sf-skills/service-omni-queue-members-assign
Claude Code and agent skill by forcedotcom/sf-skills
- community
Checking that the SKILL.md file is still in the repository.
Use to bind agent users into a Salesforce Queue via GroupMember Data API POSTs, with SOQL-based idempotency (safe re-run — only inserts missing bindings). Binds either the generated demo agents (agent{1..N}.<suffix>@example.com) or an explicit list of real agents passed as usernames/User Ids. Triggers: add agents to a Case/Voice queue, assign agent users to a queue, populate queue membership for Omni routing. Do not use to create the queue (service-omni-queue-deploy), to create the agent users…
Install
npx vskill@latest install forcedotcom/sf-skills/service-omni-queue-members-assignSKILL.md
The same SKILL.md was published earlier as forcedotcom/sf-skills/service-omni-queue-members-assign.
service-omni-queue-members-assign
Bind N agent users into a Salesforce Queue via GroupMember Data API POSTs. Without queue membership, Omni-Channel routing sees an empty pool for the queue and never assigns work. Detection is SOQL-based (the same detect-then-POST shape as service-omni-queue-routing-config-deploy), so only missing memberships are created and the skill is safe to re-run. Agent users come from service-omni-agent-users-create, the queue from service-omni-queue-deploy, and the users' Omni permissions from service-omni-permission-set-assign.
Inputs
org-alias(required).queue-developer-name(optional, defaultCaseQueue).count(optional, default3, range1..10) — must match the agent user count; ignored in explicit mode.explicit-members-csv(optional 4th positional, orMEMBER_USERNAMES_CSV/MEMBER_USER_IDS_CSV) — each token is a Username or a 15/18-char User Id; the count is derived from the list.
Preconditions and safety
- Target org authenticated via
sfCLI (My Domain URL), Service Cloud license,sfCLI ≥ 2.139.6. - The executing user has
PermissionsModifyAllData(standard on System Administrator). - The agent users exist (
service-omni-agent-users-create) and the queue exists (service-omni-queue-deploy); a missing user set or queue blocks with a pointer to the right skill (queues cannot be created via the Data API). - The three-way
safe_to_writeproduction guard applies — adding users to a production queue mis-routes real customer work, so it blocks with no override.
Run
verify-and-bind.sh runs the whole cycle:
- Compute
safe_to_write; derive the 8-char org suffix. - Resolve the queue
Group.Idby DeveloperName +Type='Queue'; block if missing. - Resolve the member set — generated mode queries
Userforagent{1..N}.<suffix>@example.com(block if any expected user is missing); explicit mode resolves each supplied token and requires every one to be an ACTIVE user. - Query existing
GroupMemberfor the queue; compute the users not yet bound. - POST one
GroupMemberper missing user (individual POSTs, noallOrNone). - Re-query to confirm final membership and emit the report.
Behavior
Two member sources, never mixed. The default generated pattern keeps the user-create → member-assign handoff deterministic; explicit mode is opt-in for real agents and takes over count derivation. In explicit mode, a token that does not resolve to an active user blocks the run — binding a typo'd or inactive user would silently under-populate the queue.
Idempotency and honesty. POSTs are individual so one failed binding (e.g. a race with another admin) never rolls back its successful siblings, and the skill re-queries after all POSTs — a 201 only means the write was accepted; a subsequent SOQL confirms the row is visible to the routing engine. The before snapshot includes members already present, even non-demo users added out-of-band, so the coordinator can see full membership state.
Non-destructive. Create-only; it never removes or reassigns existing members.
Output contract
A single JSON object with status ∈ bound | reused | partial | blocked, the resolved queue, org_suffix, member_source (generated_pattern | explicit), requested_count, a before snapshot, bound_this_run/bound_count, reused_count, an after snapshot, manual_actions, and blocking_issue.
bound— at least one new member created; final state matches the expected count.reused— all expected users were already members; nothing POSTed.partial— some POSTs failed; the re-query shows fewer members than requested (details inblocking_issue).blocked— precondition failed (production org, missing queue, missing users, missing permissions).
bound_count + reused_count == requested_count unless partial; blocking_issue is non-null only for blocked/partial.
Limitations
- Generated and explicit modes are mutually exclusive per run.
- Create-only; removing or reassigning members is out of scope.
- Does not create the queue or the users, and does not assign permission sets or presence configs.
References
| File | When to read | |
|---|---|---|
references/api-notes.md | Before the detect/bind cycle — GroupMember schema, the queue-vs-public-group distinction, why UserOrGroupId is polymorphic, and common POST failures | |
scripts/tests/test_queue_members_contracts.py | When validating changes — run python3 scripts/tests/test_queue_members_contracts.py from this skill directory |
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/service-omni-queue-members-assign/SKILL.md
Popularity
- Repository stars
- 1,054
- Repository forks
- 353
- 7-day trend score
- 40
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/forcedotcom/sf-skills/service-omni-queue-members-assign)