labs/zava-learning/sre-config/agent-config/skills/servicenow-change-management/SKILL.md
Use whenever a Zava Learning investigation produces a durable fix that needs change management — after a GitHub PR is opened for an Infrastructure-as-Code or application code root cause, raise a ServiceNow Change Request referencing the PR and attach the RCA report. The single owner of ServiceNow Change Request and attachment operations.
npx skillsauth add microsoft/sre-agent servicenow-change-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill to record a durable remediation in ServiceNow once the root cause is fixed in code or
IaC. It is the single owner of ServiceNow Change Request and attachment operations, and applies
after a GitHub PR has been opened (by pr-delivery) for the durable fix.
infra/) or
application (src/) change, and a GitHub PR has been opened with the fix.Do not raise a Change Request for live mitigations alone (deleting an NSG rule, restarting/rolling back a revision) — those are tracked as PagerDuty incident notes. The Change Request tracks the durable code/IaC fix.
CreateServiceNowChangeRequest:
short_description: one-line summary of the change (symptom + fix).description: the RCA summary including the GitHub PR URL.change_type: normal (default), standard, or emergency for active customer-impacting fixes.implementation_plan / risk as appropriate.number (e.g. CHG0030042), sys_id, and the ready-to-use
clickable link the tool returns. Surface the CR in the Artifacts & links section as a
markdown hyperlink [<number>](<link>) using that returned link — never the bare CHG number,
which is not clickable. (Do not try to build the URL from a SERVICENOW_URL env var — it is not
available in the agent environment; the tool already returns the full clickable link.)UploadServiceNowAttachment:
table_sys_id: the Change Request sys_id from step 1.file_name: e.g. rca-<symptom>.md.content: the full RCA report (timeline, root cause, fix, verification).zava-redaction standard to the description, implementation_plan, and the attached
RCA before submitting — mask any secret, token, connection string, or learner PII as
[REDACTED:<CLASS>]. The Change Request and its attachment are operator-visible records.SERVICENOW_URL/USER/PASS) are injected from the agent environment (Key Vault-backed);
never request or hardcode them.success: false — report that the
Change Request could not be created and continue the incident lifecycle in PagerDuty.development
Use to package a completed Zava Learning incident analysis for the audience. First present a branded in-thread executive summary (markdown with the before/after visuals inline), then produce the downloadable deliverables — a PowerPoint deck, an HTML email, and a Teams notification — using the Zava corporate template. The calling agent may narrow this to a subset (e.g. only the HTML report). Produces content and artifacts; it does not send them. Assembles the output of rca-analysis, evidence-before-after, recommendations-next-steps, and pr-delivery.
development
Use to package a completed Zava Learning weekly governance audit (NSG / network security, RBAC / least-privilege, or cloud cost) into a single branded, downloadable PowerPoint deck in the Zava house style. The calling audit agent passes its findings (a list of rows with severity) and a short posture summary; this skill renders the deck, applies redaction, and returns the attachment download link. Produces the artifact; it does not send it.
development
Use whenever you are about to emit operator-visible content — a chat/thread message, a PagerDuty or ServiceNow note, a commit message or pull-request body, or any report artifact (HTML, PowerPoint, Teams card). Deterministically masks secrets, credentials, tokens, private keys, URI-embedded passwords, and PII so they never appear in the thread or in any deliverable. This is a cross-cutting guardrail invoked by the output-producing skills, not a runbook step.
testing
Use to produce the forward-looking recommendations and next steps for a Zava Learning incident — prioritized preventive, detective, and process actions with owners, target dates, and the risk of inaction. Its output is used in the zava-reporting deliverables.