Skip to content

forcedotcom/sf-skills / plugins/builder/service-itsm/skills/service-itsm-agentic-setup-itsm-agentforce-permset-assign

service-itsm-agentic-setup-itsm-agentforce-permset-assign

Verified

Resolve missing ITSM Intelligence invocable actions so a Fulfiller NGA agent can activate. Reads which of the three Core Fulfiller persona permsets (IncidentFulfiller, ProblemFulfillerPermSet, ChangeRequestFulfillerPermSet) are provisioned, then assigns the running user the selected persona (plus backing PSL when license-gated) so svc_itsm_intelligence__* actions surface; hands off to service-itsm-agentic-setup-agentforce-studio-validate if none are provisioned. Use when the Fulfiller agent-configure skill reports missing actions on activate, when 'Invocable action svc_itsm_intelligence__X does not exist' surfaces, when a user asks to grant themselves Fulfiller prompt-template access, when asked to assign the Incident, Problem, or Change Fulfiller persona permission set, or when resolving missing ITSM Intelligence action access for the Fulfiller agent. DO NOT TRIGGER for Employee-agent access, Agentforce for IT Service toggles, agent creation, CMDB access, or generic permset assignment.

references/permset-topology.md

View on GitHub
# ITSM Fulfiller Persona Permset Topology (Core-shipped)

This skill assigns Core-shipped **StandardPermissionSet** persona permsets — NOT a
managed-package namespaced permset. On a real org there is no
`svc_itsm_intelligence` namespaced `PermissionSet`; the Fulfiller agent's
`svc_itsm_intelligence__*` prompt-template invocable actions surface only once
the running user holds the correct **Fulfiller persona permset** shipped in
Core (namespace `force`).

**Employee agent is out of scope for this skill.** The Employee agent's access
model is separate (org-preferences + a different persona layer) and does not
map onto these three permsets.

## Fulfiller persona ↔ AddOn ↔ PSL ↔ PermSet

| Persona | AddOn (`.add.xml`) | PSL (`.psl.xml`) | **PermSet DeveloperName** (assign this) | Grants userPerm |
|---|---|---|---|---|
| Incident Fulfiller | `IncidentManagementAddOn-1` | `IncidentFulfillerPsl-1` | **`IncidentFulfiller`** | `IncidentFulfillerUser` |
| Problem Fulfiller | `ProblemManagementAddOn-1` | `ProblemFulfillerPsl-1` | **`ProblemFulfillerPermSet`** | `ProblemFulfillerUser` |
| Change Fulfiller | `ChangeManagementAddOn-1` | `ChangeRequestFulfillerPsl-1` | **`ChangeRequestFulfillerPermSet`** | `ChangeFulfillerPerm` |

### Key facts

- **Namespace is `force` on every permset** — the namespace-prefix filter used
  in the previous version of this skill (`svc_itsm_intelligence`) never
  returns any of these rows.
- **Naming inconsistency**: `IncidentFulfiller` has NO `PermSet` suffix; the
  other two DO. The classifier's fixed-name list reflects this exactly —
  do not "normalize" the Incident name to `IncidentFulfillerPermSet`, it does
  not exist on the org.
- **CMDB access is a separate concern** — the CMDB read/write permsets are
  handled by `service-itsm-agentic-setup-cmdb-access-assign` and are not
  gated by any `svc_itsm_intelligence__*` prompt-template invocable, so they
  are intentionally excluded from this skill's fixed-lookup set.

## Fixed-lookup discovery query (Phase 1)

```sql
SELECT Id, Name, Label, LicenseId
FROM PermissionSet
WHERE Name IN (
  'IncidentFulfiller',
  'ProblemFulfillerPermSet',
  'ChangeRequestFulfillerPermSet'
)
```

**Interpreting the result set:**

- **≥1 row present** ⇒ Branch A (assign). Ask the user which persona to
  assign — do NOT auto-select, since a Fulfiller commonly needs only one
  persona (e.g. Incident) even when others are provisioned.
- **Zero rows** ⇒ Branch B (hand-off). The ITSM AddOn(s) are not provisioned
  on this org. Route to `service-itsm-agentic-setup-agentforce-studio-validate`
  so the AddOn(s) can be enabled first.

## `needsPsl` per persona

Whether the PSL POST step in Phase 2 runs is a **per-permset** decision, read
from each row's `LicenseId`:

- `LicenseId != null` ⇒ `needsPsl:true` (license-gated permset — POST the PSL
  before the permset assign).
- `LicenseId == null` ⇒ `needsPsl:false` (standalone permset — skip the PSL
  POST entirely; assign the permset only).

The classifier emits `needsPsl` per candidate row, so the caller reads the
switch from the selected persona and does not need to re-derive it.

## Codesearch sources

Every row above was verified against the Core repo. When the AddOn / PSL /
PermSet metadata drifts on a future release, re-run codesearch on the AddOn
file (`*.add.xml`) — the AddOn's `<permissionSet>` reference is the source of
truth for the DeveloperName this skill must assign.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall