forcedotcom/sf-skills / plugins/builder/service-omni/skills/service-omni-command-center-configure
service-omni-command-center-configure
VerifiedUse to enable Command Center for Service V2 and configure its supported supervisor controls through the OmniChannel Settings Metadata API while preserving unrelated settings. Requires explicit apply consent, refuses production customer orgs, and verifies the seeded V2 page and tab. TRIGGER when: enable Command Center V2, configure conversation monitoring, enable agent sneak peek, enable customer sneak peek, configure whisper messaging, or enable queues and skills actions. Do not use to assign supervisor permissions or configure classic OmniSupervisorConfig metadata.
service-omni-command-center-configure
Enable Command Center for Service V2 through Settings:OmniChannel and optionally configure the five supervisor controls exposed by the same Metadata API contract. The writer retrieves the org's complete settings document, changes only requested elements, deploys that preserved document, retrieves it again, and verifies both the values and the platform-created CommandCenterForServiceV2_L page and V2 tab.
The skill fails closed with platform_api_unavailable when the retrieved settings document does not expose enableCommandCenterForServiceV2.
Run service-omni-base-settings-configure first so the Omni foundation is enabled. If the org does not support Command Center V2, use service-omni-supervisor-config-deploy for the classic supervisor configuration instead.
For an end-to-end setup, service-omni-channel-setup-coordinate invokes this skill only when OMNI_COMMAND_CENTER_V2=1; the coordinator's default supervisor path remains unchanged.
Inputs
bash scripts/configure-and-report.sh plan <org-alias> [options]
bash scripts/configure-and-report.sh run <org-alias> --apply [options]
Options:
| Option | Metadata element | Values |
|---|---|---|
--conversation-monitoring | enableConversationMonitoring | true or false |
--agent-sneak-peek | enableAgentSneakPeek | true or false |
--customer-sneak-peek | enableClientSneakPeek | true or false |
--whisper-messaging | enableWhisperMessaging | true or false |
--queues-and-skills | enableSkillsAndQueueActions | true or false |
enableCommandCenterForServiceV2=true is always requested. Unspecified supervisor controls are preserved exactly as retrieved. The skill intentionally does not disable V2 because disabling an org-level supervisor experience is a materially different operation.
Safety
planis read-only and never deploys.runrequires the literal--applyflag before any mutation.- Writes are allowed only when
IsSandbox=true,TrialExpirationDateis non-null, orOrganizationTypeisDeveloper EditionorBase Edition. There is no production override. Settingsis a whole-document Metadata API type. Never deploy a partial or hardcodedOmniChannel.settings-meta.xml; doing so can reset unrelated Omni settings.- The target org must have Enhanced Omni-Channel and the Command Center for Service V2 release gater. The API field is also permission-gated by
Customize Application.
Behavior
- Authenticate and retrieve
Settings:OmniChannelat API v66. - Confirm the V2 field is present. If it is absent, return
blockedwithreason_code=platform_api_unavailable; do not attempt a deploy. - Build a requested-value set containing V2=
trueplus only the optional controls explicitly supplied by the caller. - In
plan, returnaction_neededorreusedwithout writing. - In
run, enforce--applyand the non-production guard, mutate a private copy of the retrieved document, and deploy it. - Retrieve the settings again and require every requested value to match.
- Require both the seeded
FlexiPage(CommandCenterForServiceV2_L) and V2TabDefinitionto be observable. Missing or unreadable provisioning evidence returnsblocked; the skill never guesses.
The platform's ON-transition hook is idempotent: it creates missing profile tab configuration and seeds the baseline FlexiPage only when needed. Existing page customizations are not overwritten. If the preference is already true but its seed artifacts are missing, the skill returns seed_incomplete; it does not force a destructive OFF→ON cycle.
Output contract
The script emits one JSON object with:
status:configured,reused,action_needed, orblockedreason_code: a stable reason such aschanges_required,already_configured,platform_api_unavailable,unsafe_target,deploy_failed,verification_failed, orseed_incompleterequested,before, andafter: setting values, with presence retained in the snapshotssafe_to_write,deploy_id, andverificationmanual_actions: permission assignment and any required follow-upblocking_issue: populated only when blocked
Enabling the org preference does not grant user access. Assign a permission set containing CommandCenterForServiceUser to each intended supervisor, then run service-omni-command-center-analyze <org> <supervisor> to verify end-to-end readiness.
References
| File | When to read |
|---|---|
references/api-notes.md | Metadata names, platform gates, seed behavior, and known limitations |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |