К основному содержанию
скилл CX Codex

service-omni-sidebar-configure — скилл для Claude Code: что делает

Скилл service-omni-sidebar-configure для Claude Code включает и проверяет боковую панель Omni-Channel в консольных приложениях Lightning. Активирует закреплённую область оператора через метаданные CustomApplication.

Apache-2.0 103 установок ★ 1 183 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill service-omni-sidebar-configure -a claude-code
Открыть на GitHub

Что делает service-omni-sidebar-configure

Включает закреплённую боковую панель Omni-Channel в консоли Lightning, выставляя флаг isOmniPinnedViewEnabled=true в метаданных CustomApplication. Скрипт проверяет текущее состояние флага: если он уже включён, повторный деплой пропускается, а если выключен — обновляет метаданные через Metadata API и верифицирует результат повторной выгрузкой.

Для работы требуются авторизованная организация через sf CLI (версия от 2.139.6), лицензия Service Cloud, python3 от 3.8 и jq от 1.6. Скилл работает строго с одним консольным приложением Lightning за запуск. Если имя приложения не передано, скрипт выберет его автоматически только при наличии ровно одной консоли в организации; при нескольких приложениях выполнение остановится со статусом blocked.

Какие задачи решает

  • закрепить боковую панель Omni-Channel в консоли Lightning
  • проверить флаг isOmniPinnedViewEnabled перед выдачей прав операторам
  • развернуть точечные изменения CustomApplication без затрагивания вкладок

Примеры запросов агенту

  • Включи боковую панель Omni-Channel в приложении ServiceConsoleApp для организации test-org
  • Проверь статус закреплённой панели оператора в текущей консоли Salesforce

Как установить service-omni-sidebar-configure

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-sidebar-configure -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-omni-sidebar-configure/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-omni-sidebar-configure/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-omni-sidebar-configure

Как установить service-omni-sidebar-configure в Claude Code?

Выполните команду npx skills add forcedotcom/sf-skills --skill service-omni-sidebar-configure -a claude-code.

Что делает service-omni-sidebar-configure?

Выставляет и верифицирует флаг isOmniPinnedViewEnabled в метаданных консольного приложения Lightning, закрепляя виджет Omni-Channel на боковой панели.

Что нужно для работы service-omni-sidebar-configure?

Нужны sf CLI версии 2.139.6 или новее, python3 от 3.8, jq от 1.6, лицензия Service Cloud и предварительно настроенные базовые параметры Omni-Channel.

Исходный текст

SKILL.md · Apache-2.0
---
name: service-omni-sidebar-configure
description: "Use to enable or verify the Omni-Channel sidebar on a Lightning console app. Triggers: enable the Omni sidebar, pin Omni-Channel in a console app, configure the Omni sidebar, turn on the Omni-Channel utility region, verify the pinned Omni widget. Do not use for Aura apps, standard apps, utility-bar-only Omni widgets, or to create a console app."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-base-settings-configure"
    - "service-omni-channel-setup-coordinate"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["python3"]
      semver: ">=3.8"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-sidebar-configure

Enable the Omni-Channel **sidebar** — the pinned Omni utility region that docks to the side of a Lightning console app — by setting `isOmniPinnedViewEnabled=true` on that app's `CustomApplication` metadata and confirming the flag round-trips. This is the recommended Omni surface for console/demo orgs: reps see incoming work, presence, and the work list docked beside the record, rather than only in the collapsible utility bar. It runs once per console app and is invoked by `service-omni-channel-setup-coordinate` as the final rep-experience step.

## Inputs

```bash
bash scripts/enable-and-report.sh <org-alias> [app_developer_name]
```

- `org-alias` (required).
- `app_developer_name` (optional). The `CustomApplication` DeveloperName of the Lightning console app. When omitted, the skill queries `AppDefinition` for Lightning console apps: exactly one → adopt it; zero or many → `blocked` (name it explicitly).

## Preconditions and safety

- Target org authenticated via `sf` CLI, Service Cloud license, `sf` CLI ≥ 2.139.6.
- Omni-Channel base settings enabled (`service-omni-base-settings-configure`).
- The target must be a **Lightning console** app that is deployable as `CustomApplication` metadata. Standard apps and Aura apps are out of scope.
- The three-way `safe_to_write` production guard applies.

## Run

`enable-and-report.sh` resolves the target app, retrieves its `CustomApplication`, and reads the current `isOmniPinnedViewEnabled` value:

- already `true` → `reused` (no deploy).
- `false` or absent → sets it to `true` and deploys the single `CustomApplication` in one atomic Metadata API call, then **re-retrieves** to confirm the flag is `true` before reporting success.

The deploy uses explicit `--metadata "CustomApplication:<name>"` (never `--source-dir`) and is done on its own — Metadata deploys are atomic, so the app is left unchanged on any failure.

## Behavior

**Idempotent + non-destructive.** The skill only flips the single boolean; it never rewrites tabs, brand, or nav config. When the field is missing it is inserted in its XSD-ordered position (immediately before `<label>`); when present its value is replaced in place.

**Auto-detect is conservative.** It adopts an app automatically only when exactly one Lightning console app exists, so it can never silently pin the wrong app on an org with several.

## Output contract

A single JSON object: `status` ∈ `enabled` | `reused` | `blocked`, `app_developer_name`, `app_label`, `before` (bool), `after` (bool), `deploy_id`, `manual_actions`, `blocking_issue`.

- `enabled` — the flag was `false`/absent and is now verified `true`.
- `reused` — the flag was already `true`.
- `blocked` — no/many console apps found, retrieve/deploy failure, or the post-verify did not confirm `true`; `blocking_issue` explains and `manual_actions` names the fix or prerequisite skill.

## Limitations

- One app per invocation; run again for each console app that needs the sidebar.
- Lightning console `CustomApplication` only — not Aura, not standard apps, not the utility-bar Omni widget.
- Does not create or lay out the console app, its tabs, or the Omni utility item.

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | CustomApplication `isOmniPinnedViewEnabled` schema/order, AppDefinition detection query, and retrieve/deploy notes |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
cmux-custom-sidebar manaflow-ai Скилл cmux-custom-sidebar для написания кастомной боковой панели cmux на SwiftUI-подобном языке. Панель привязывается к рабочим пространствам, вкладкам, PR и часам, горячо перезагружается при сохранении и выполняет команды cmux по нажатию. CX Codex +1 5 100установок callidescope-configure organizzolini Скилл callidescope-configure помогает настроить параметры запуска Callidescope через CLI-флаги и callidescope.config.ts. CX Codex +1 361установок alibabacloud-maxcompute-migration-service aliyun Скилл alibabacloud-maxcompute-migration-service управляет переносом данных в Alibaba Cloud MaxCompute через MMS. Помогает составить план миграции, настроить маппинг схем и отслеживать Spark-задачи. CX Codex +1 127установок cx-service-catalog coralogix Скилл cx-service-catalog для Claude Code запрашивает каталог сервисов Coralogix и метрики APM. Он подключается к задачам поиска сервисов, проверки схемы и анализа показателей за период. CX Codex +1 3 700установок omni-sync-cloud cheaper-inference Скилл omni-sync-cloud синхронизирует конфигурацию OmniRoute, подключения к провайдерам и настройки с облачным хранилищем. Управляет аутентификацией cloud worker и удалёнными бэкапами. CX Codex +1 1 300установок warden-service getsentry Скилл для чтения данных Warden Service: поиск и экспорт запусков, находок, затрат и метрик через персональный токен. Работает во всех популярных AI-редакторах. CX Codex +1 189установок

Из того же набора232

Весь набор →
service-omni-queue-members-assign Скилл service-omni-queue-members-assign для Claude Code привязывает агентов к очередям Salesforce через Data API. Наполняет очереди Case и Voice участниками для распределения нагрузки в Omni-Channel. CX Codex +1 106установок service-omni-skills-based-routing-configure Скилл service-omni-skills-based-routing-configure для Claude Code связывает Omni Skill с активными пользователями агентов. Запускается при настройке маршрутизации Omni по навыкам. CX Codex +1 106установок service-omni-permission-set-assign Скилл service-omni-permission-set-assign для Claude Code назначает агентам наборы разрешений Omni. Запускается по просьбе выдать доступ к Omni-Channel или исправить назначения для виджета Omni. CX Codex +1 104установок service-omni-supervisor-config-deploy Скилл service-omni-supervisor-config-deploy для Claude Code разворачивает конфигурацию классического Omni-Channel Supervisor в Salesforce. Запускается по просьбе настроить Omni Supervisor или Supervisor Command Center. CX Codex +1 104установок service-omni-presence-status-deploy Скилл service-omni-presence-status-deploy для Claude Code развёртывает статусы доступности Omni-Channel. Запускается при настройке Available-статусов для Case, Incident, Messaging или Voice и стандартного Busy. CX Codex +1 103установок service-omni-base-settings-configure Скилл service-omni-base-settings-configure для Claude Code и других ассистентов настраивает базовые параметры Omni-Channel в Salesforce через Metadata API. Включает пять главных флагов маршрутизации перед созданием очередей. CX Codex +1 103установок service-omni-supervisor-surface-deploy Скилл service-omni-supervisor-surface-deploy для Claude Code заполняет интерфейс Omni-Channel Supervisor в Salesforce стандартными кнопками и вкладками через Data API. Запускается при настройке панели супервизора. CX Codex +1 102установок service-omni-supervisor-users-create Скилл service-omni-supervisor-users-create для Claude Code создаёт учётные записи супервайзеров Omni-Channel в Salesforce. Запускается по запросу создать или подготовить таких пользователей. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой