forcedotcom/sf-skills / plugins/builder/service-itsm/skills/service-itsm-agentic-setup-itsm-agentforce-permset-assign
service-itsm-agentic-setup-itsm-agentforce-permset-assign
VerifiedResolve 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.2 KB |
| references/cli-invocation.md | markdown | 5.6 KB |
| references/helper-contracts.md | markdown | 7.3 KB |
| references/permset-topology.md | markdown | 3.4 KB |
| scripts/classify-action-surface.mjsexecutable | script | 5.9 KB |
| scripts/classify-assignment-state.mjsexecutable | script | 4.7 KB |
| scripts/classify-permset-availability.mjsexecutable | script | 4.8 KB |
| scripts/resolve-target-user.mjsexecutable | script | 3.0 KB |
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.
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: 472k | 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 |