Service Omni Queue Routing Config Deploy

What it does

When your agent uses it

• Update a QueueRoutingConfig record on a Salesforce org via the Data API (idempotent SOQL detect + REST upsert)
• Attribute-based routing (IsAttributeBased=true is out of scope)
• Routing models other than MostAvailable/LeastActive

Example prompts

• “/service-omni-queue-routing-config-deploy”

Requirements

• Python 3
• A Bash shell
• Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Query QueueRoutingConfig WHERE DeveloperName = '', capturing the existing Id and field values.
2. 2Compare against the requested/canonical values.
3. 3POST a new record when none exists; no-op (reused) when all fields already match; PATCH when a field differs.
4. 4Re-query to confirm the final state; block if the re-query shows a mismatch.

What it can do on your machine

Read from SKILL.md and the folder at commit e5164d9. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash
  • Read
  • Write
  • Edit
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 3 files in scripts/ (Python and Shell), which the agent can run.

  Shell commands in SKILL.md call:

  • bash
  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Service Omni Queue Routing Config Deploy loads about 2.1k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 190 tokens; SKILL.md has 776 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~190

When it runs · the whole SKILL.md, loaded when a task matches

~2.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Bash, Read, Write, Edit, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from forcedotcom/sf-skills at commit e5164d9, republished under its Apache-2.0 licence (© forcedotcom). 776 words, ~2,143 tokens.

name

service-omni-queue-routing-config-deploy

description

Use to create or update a QueueRoutingConfig record on a Salesforce org via the Data API (idempotent SOQL detect + REST upsert). Naming is target-derived: Case→Case_Routing_Config, VoiceCall→Voice_Routing_Config, Incident→Incident_Routing_Config, MessagingSession→Messaging_Routing_Config (via QRC_ROUTING_TARGET), or pass an explicit developer-name/label/capacity/priority. RoutingModel MostAvailable (default) or LeastActive. Triggers: create a Case or Voice routing config, deploy a QueueRoutingConfig, set up queue routing for Omni Cases/Voice, configure CapacityWeight per queue. Do not use for attribute-based routing (IsAttributeBased=true is out of scope) or routing models other than MostAvailable/LeastActive.

allowed-tools

Bash, Read, Write, Edit, Glob, Grep

metadata.version

1.0

metadata.domains

Service

metadata.minApiVersion

66.0

metadata.relatedSkills

service-omni-base-settings-configure, service-omni-channel-setup-coordinate, service-omni-queue-deploy, service-omni-service-channel-configure

bash scripts/upsert-and-report.sh <org-alias> [routing-model] [developer-name] [master-label] [capacity-weight] [routing-priority] [overflow-assignee] [push-timeout]
# Case_Routing_Config, preserve model / create MostAvailable:
bash scripts/upsert-and-report.sh myorg
# align the Case QRC to LeastActive:
bash scripts/upsert-and-report.sh myorg LeastActive
# Voice_Routing_Config (coordinator path):
QRC_ROUTING_TARGET=VoiceCall bash scripts/upsert-and-report.sh myorg
# set a fallback/overflow assignee (route overflow work to a supervisor):
QRC_OVERFLOW_ASSIGNEE=supervisor@example.com bash scripts/upsert-and-report.sh myorg
# Voice uses 100% capacity and a 30-second push timeout:
QRC_ROUTING_TARGET=VoiceCall QRC_CAPACITY_PERCENTAGE=100 QRC_PUSH_TIMEOUT=30 bash scripts/upsert-and-report.sh myorg MostAvailable

© forcedotcom, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/service-omni-queue-routing-config-deploy of forcedotcom/sf-skills.

• SKILL.md
• references/api-notes.md
• scripts/tests/_bootstrap.py
• scripts/tests/test_queue_routing_config_contracts.py
• scripts/upsert-and-report.sh

Open the folder on GitHubat commit e5164d9