service-omni-agent-work-sharing-configure

Original：🇺🇸 English

Translated

3 scripts

Use to configure or verify org-wide AgentWork visibility for supervisors after explicit confirmation. Triggers: let supervisors read AgentWork, configure AgentWork sharing, verify AgentWork OWD, make AgentWork visible to supervisors, change AgentWork internal access. Do not use to filter which reps appear in Command Center; use service-omni-supervisor-config-deploy for that.

3installs

Sourceforcedotcom/sf-skills

Added on2026-09-05

NPX Install

npx skill4agent add forcedotcom/sf-skills service-omni-agent-work-sharing-configure

SKILL.md Content

View Translation Comparison →

service-omni-agent-work-sharing-configure

Detect and optionally configure the standard

AgentWork

object's internal organization-wide default. The supported headless contract is

CustomObject:AgentWork

metadata: retrieve the current metadata, preserve

externalSharingModel

, deploy internal

sharingModel=Read

, and retrieve it again for proof.

This setting grants read visibility broadly to internal users who already have object access. It is not a substitute for an

OmniSupervisorConfig

: that configuration filters which reps, queues, skills, actions, and tabs a supervisor sees, but does not grant record access.

Inputs

bash

bash scripts/configure-and-report.sh <org-alias> --plan
bash scripts/configure-and-report.sh <org-alias> --confirm-org-wide-visibility

```
org-alias
```
is required and must already be authenticated with
```
sf
```
.
```
--plan
```
retrieves and reports the current and desired models without deploying.
```
--confirm-org-wide-visibility
```
is required only when a run must change
```
Private
```
to
```
Read
```
. Omitting it blocks before deployment.

Safety contract

A run refuses production customer orgs. Plan mode remains read-only.
```
externalSharingModel
```
is preserved exactly.
```
Read
```
and
```
ReadWrite
```
already provide internal read visibility and are reused. The skill never narrows
```
ReadWrite
```
to
```
Read
```
.
The only supported mutation is
```
Private
```
to
```
Read
```
; the skill never grants internal edit access.
Failed classification, retrieve, deploy, or read-back blocks. It never reports success from an inconclusive response.
Use a dedicated sandbox or test org because changing an OWD can initiate sharing recalculation.

Workflow

Classify the target org and enforce the production-write guard.
Retrieve
```
CustomObject:AgentWork
```
through Metadata API.
Read internal and external sharing models.
Reuse
```
Read
```
or
```
ReadWrite
```
with no deploy.
In plan mode, report the proposed
```
Private
```
to
```
Read
```
change and exit yellow.
In run mode, require explicit blast-radius confirmation.
Deploy only the standard-object metadata containing preserved external sharing and internal
```
Read
```
.
Retrieve again and require internal
```
Read
```
plus the unchanged external model.

Output

A single JSON object containing

status

,

previous_sharing_model

,

sharing_model

,

external_sharing_model

,

changed

,

dry_run

,

deploy_id

, and

blocking_issue

.

```
configured
```
: a confirmed
```
Private
```
to
```
Read
```
deployment succeeded and read-back matched.
```
reused
```
: current
```
Read
```
or
```
ReadWrite
```
already provides visibility.
```
action_needed
```
: plan mode found
```
Private
```
; no write occurred.
```
blocked
```
: a safety guard or supported-API verification failed.

Limitations

This skill changes visibility, not supervisor scope. Use the supervisor configuration skill for filtering.
It does not create sharing rules or per-record
```
AgentWorkShare
```
rows.
It cannot prove a particular supervisor's complete UI access; validate the end-to-end Command Center journey with the intended supervisor user after configuration.

References

File	When to read
`references/api-notes.md`	Before approving the org-wide change or diagnosing a retrieve/deploy failure

service-omni-agent-work-sharing-configure

NPX Install

Tags

SKILL.md Content

service-omni-agent-work-sharing-configure

Inputs

Safety contract

Workflow

Output

Limitations

References