forcedotcom/sf-skills / plugins/builder/service-itsm/skills/service-itsm-agentic-setup-fulfiller-agent-configure
service-itsm-agentic-setup-fulfiller-agent-configure
UnverifiedCreate and activate the IT Service Fulfiller agent as a Next-Gen Authoring (NGA) native agent from the shipped ITSM Fulfiller template's Agent Script, using the Salesforce CLI (sf): read the template, check idempotency, create the NGA bundle then publish and activate it, then verify it is live. Idempotent per developer name. The Fulfiller agent is the IT-technician-facing assistant for incident triage, case summarization, field updates, and related-record automations. Use when asked to create the Fulfiller agent, set up the IT Service Fulfiller agent, provision the fulfiller assistant, or activate the Fulfiller agent. Triggers: create fulfiller agent, set up fulfiller agent, provision fulfiller agent, activate fulfiller agent. DO NOT TRIGGER: checking org prerequisites (service-itsm-agentic-setup-agentforce-studio-validate), or CMDB CRUD.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 34.0 KB |
| references/action-availability.md | markdown | 6.2 KB |
| references/cli-invocation.md | markdown | 21.3 KB |
| references/error-taxonomy.md | markdown | 4.1 KB |
| references/reactivation.md | markdown | 4.0 KB |
| references/report-format.md | markdown | 4.2 KB |
| references/workflow-detail.md | markdown | 16.7 KB |
| scripts/build-create-body.mjsexecutable | script | 5.2 KB |
| scripts/classify-action-availability.mjsexecutable | script | 12.3 KB |
| scripts/classify-activate-result.mjsexecutable | script | 5.5 KB |
| scripts/classify-agent-existence.mjsexecutable | script | 13.6 KB |
| scripts/classify-preflight.mjsexecutable | script | 10.3 KB |
| scripts/create-scratch-dir.mjsexecutable | script | 2.3 KB |
| scripts/render-report.mjsexecutable | script | 11.8 KB |
| scripts/strip-release-management.mjsexecutable | script | 8.8 KB |
scripts/build-create-body.mjs
View on GitHub#!/usr/bin/env node
// Build the NGA createBundleWithVersion request body from the shipped
// Fulfiller template's agentScript.
//
// The legacy `agent-templates` read already returns the template's full Agent
// Script (AFScript) content in its `agentScript` field, HTML-entity-encoded
// (sometimes double-encoded). This script:
// 1. Locates the matching template item by masterLabel in the
// agent-templates response.
// 2. Fully HTML-decodes `agentScript` (named + numeric entities, multi-pass
// to unwind double-encoding).
// 3. Substitutes the script's internal `config.developer_name` /
// `config.agent_label` with the collected <developerName> / <label> —
// the bundle's outer apiName must match the script's internal
// developer_name or the two diverge (the platform will otherwise
// auto-suffix the apiName).
// 4. Writes the createBundleWithVersion body
// { apiName, label, assets: [{ resourceName: "agentDefinition",
// resourceType: "agentDefinition", sections: [], resourceContent }] }
// to <outPath>.
//
// Usage:
// node build-create-body.mjs <agent-templates.json> <masterLabel> <developerName> <label> <outPath>
//
// Exits 2 on missing/bad args, 3 if the template or its agentScript can't be found.
import { readFileSync, writeFileSync } from 'node:fs';
import { stripReleaseManagement, decodeAgentScriptEntities } from './strip-release-management.mjs';
const [templatesPath, masterLabel, developerName, label, outPath] = process.argv.slice(2);
if (!templatesPath || !masterLabel || !developerName || !label || !outPath) {
process.stderr.write('usage: node build-create-body.mjs <agent-templates.json> <masterLabel> <developerName> <label> <outPath>\n');
process.exit(2);
}
let templatesData;
try {
templatesData = JSON.parse(readFileSync(templatesPath, 'utf8'));
} catch {
process.stderr.write(`error: could not read/parse ${templatesPath}\n`);
process.exit(3);
}
const items = Array.isArray(templatesData?.data) ? templatesData.data : [];
const wanted = String(masterLabel).trim().toLowerCase();
const match = items.find((it) => String(it?.masterLabel ?? '').trim().toLowerCase() === wanted);
if (!match) {
process.stderr.write(`error: no template with masterLabel "${masterLabel}" found in ${templatesPath}\n`);
process.exit(3);
}
if (!match.agentScript || typeof match.agentScript !== 'string' || !match.agentScript.trim()) {
process.stderr.write(`error: template "${masterLabel}" (id=${match.id}) has no agentScript content\n`);
process.exit(3);
}
// Escapes a value for use as a YAML double-quoted scalar — the agentScript's
// developer_name/agent_label fields are plain `"..."` strings, so a raw
// double-quote or backslash in a user-supplied label would otherwise break
// out of the scalar (e.g. label `Sam "Ops"` -> `agent_label: "Sam "Ops""`).
function yamlDoubleQuoteEscape(text) {
return String(text).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
}
const decodedRaw = decodeAgentScriptEntities(match.agentScript);
// Strip the Release Management subagent so the created agent never
// references `svc_itsm_intelligence__SummarizeRelease` — that action is gated
// behind Release Management (`ReleaseManagementPref`) and would otherwise make
// `activate` fail with a `{success:false}` silent-failure body on any org that
// has not enabled the pref. The strip is a no-op if the block is absent.
const { text: decoded, removed } = stripReleaseManagement(decodedRaw);
if (removed.topic > 0) {
process.stderr.write(
`note: stripped Release Management subagent (topic:${removed.topic} goto:${removed.goto} bullet:${removed.bullet} lines)\n`,
);
}
// Completeness guard: if a ReleaseManagement/SummarizeRelease reference survives
// the strip (e.g. a future template references the gated action outside the
// three stripped surfaces), the shipped bundle would dangle it and `activate`
// could still return the {success:false} silent-failure body. Warn loudly.
if (removed.residual > 0) {
process.stderr.write(
`warning: ${removed.residual} residual ReleaseManagement/SummarizeRelease token(s) survive after strip — the template may reference the gated action outside the three stripped surfaces; the created agent's activation could still fail\n`,
);
}
const developerNameEscaped = yamlDoubleQuoteEscape(developerName);
const labelEscaped = yamlDoubleQuoteEscape(label);
const substituted = decoded
.replace(/developer_name:\s*"[^"]*"/, `developer_name: "${developerNameEscaped}"`)
.replace(/agent_label:\s*"[^"]*"/, `agent_label: "${labelEscaped}"`);
if (!substituted.includes(`developer_name: "${developerNameEscaped}"`)) {
process.stderr.write('error: failed to substitute config.developer_name in the decoded agentScript\n');
process.exit(3);
}
if (!substituted.includes(`agent_label: "${labelEscaped}"`)) {
process.stderr.write('error: failed to substitute config.agent_label in the decoded agentScript\n');
process.exit(3);
}
const body = {
apiName: developerName,
label,
assets: [
{
resourceName: 'agentDefinition',
resourceType: 'agentDefinition',
sections: [],
resourceContent: substituted,
},
],
};
writeFileSync(outPath, JSON.stringify(body), 'utf8');
process.stdout.write(outPath + '\n');
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 | Unverified | 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 |