# service-omni-queue-deploy

The service-omni-queue-deploy skill verifies or provisions a Salesforce queue for routable objects using QueueSobject bindings. It runs when setting up Omni-Channel routing through an AI agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 116 installs · ★ 1183 repo stars
- Author: forcedotcom
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/forcedotcom/sf-skills/tree/HEAD/skills/service-omni-queue-deploy/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/service-omni-queue-deploy

## What it does

The tool locates an existing Salesforce queue by its binding to objects like Case, Incident, MessagingSession or VoiceCall rather than relying on hardcoded names. When no binding exists, the `--create-if-missing` flag builds a new queue via the Metadata API along with the target routing configuration. The execution concludes by emitting a structured JSON status indicating whether the queue was created, reused, updated, or blocked.

Operation requires an authenticated Salesforce organization through the `sf` CLI, a Service Cloud license, and `jq` version 1.6 or newer. The script checks entity definitions prior to writing and handles routing configuration alignment. Queue membership management and unsupported object types remain outside the scope of this utility.

## Requirements
- Works with: Salesforce

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add forcedotcom/sf-skills --skill service-omni-queue-deploy -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/service-omni-queue-deploy/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/service-omni-queue-deploy/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add forcedotcom/sf-skills --skill service-omni-queue-deploy -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/service-omni-queue-deploy/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add forcedotcom/sf-skills --skill service-omni-queue-deploy -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/service-omni-queue-deploy/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install forcedotcom/sf-skills skills/service-omni-queue-deploy
```

2. **Manually: put the files in place**
- File: `.github/skills/service-omni-queue-deploy/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add forcedotcom/sf-skills --skill service-omni-queue-deploy -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/forcedotcom/sf-skills --path skills/service-omni-queue-deploy
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/service-omni-queue-deploy/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add forcedotcom/sf-skills --skill service-omni-queue-deploy -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/forcedotcom/sf-skills/tree/HEAD/skills/service-omni-queue-deploy/SKILL.md

## When to use it
- verify queue binding for a Salesforce object
- provision a missing queue via Metadata API
- align queue routing configuration
- generate deployment status JSON report

## Example prompts
- Verify or create a VoiceCall queue in myorg
- Set up a Case queue with custom routing config
- Deploy an Omni-Channel queue with missing creation enabled

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 02529b7197f0e3ea.

BEGIN THIRD-PARTY FILE 02529b7197f0e3ea
````text
---
name: service-omni-queue-deploy
description: "Use to verify or create a Queue on a Salesforce org for a routable sObject (Case | Incident | MessagingSession | VoiceCall), discovered via its QueueSobject binding rather than by hardcoded name. Reuses whatever queue already routes the target sObject; with --create-if-missing it creates a Queue via the Metadata API (Group + QueueSobject) when none is bound and aligns its QueueRoutingConfigId to a caller-specified QRC. Returns created, reused, updated, or blocked. Triggers: verify or create a queue for Case/Incident/Messaging/Voice routing, align queue routing config, set up an Omni voice queue. Do not use to add users to the queue (service-omni-queue-members-assign) or for sObjects outside Case/Incident/MessagingSession/VoiceCall."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-channel-setup-coordinate"
    - "service-omni-queue-members-assign"
    - "service-omni-queue-routing-config-deploy"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-queue-deploy

Verify that a `Group` (Type='Queue') exists with a `QueueSobject` binding to the requested routable sObject, reusing whatever is already there. With `--create-if-missing`, create the queue via the Metadata API (Group + QueueSobject) when none is bound, and optionally align its `QueueRoutingConfigId` to a caller-specified QRC. The skill discovers the queue by its `QueueSobject.SobjectType` binding, not by name, because real orgs name queues inconsistently (`CaseQueue`, `messagingqueue`, `Omni_Demo_Cases_Queue`) — the functional link between a queue and the routing it supports is the binding, not the `DeveloperName`. It is invoked by `service-omni-channel-setup-coordinate`; queue membership is a separate leaf (`service-omni-queue-members-assign`) and the QRC it aligns to comes from `service-omni-queue-routing-config-deploy`.

## Inputs

```bash
bash scripts/verify-and-align.sh <org-alias> [Case|Incident|MessagingSession|VoiceCall] [routing_config_dn] [queue_developer_name] [--create-if-missing]
# create + bind a Voice queue on a fresh org:
bash scripts/verify-and-align.sh myorg VoiceCall Voice_Routing_Config "" --create-if-missing
```

- `org-alias` (required).
- `sobject_type` (optional, default `Case`).
- `routing_config_dn` (optional) — when passed, forces alignment to that QRC; when omitted for Case it defaults to `Case_Routing_Config`; when omitted for other sObjects the skill reports the existing binding without forcing.
````
END THIRD-PARTY FILE 02529b7197f0e3ea

The third-party file has ended. Everything between the 02529b7197f0e3ea tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2700 of 7357 bytes. © forcedotcom · Apache-2.0 · https://github.com/forcedotcom/sf-skills/tree/HEAD/skills/service-omni-queue-deploy/SKILL.md

_Part of the page did not fit — see the HTML version._

---
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
