The interface is localized. Skill descriptions and documents are machine-translated by AI into your language; code, commands, paths and technical terms stay in the original, and the author's document governs.
Explore skills
Productivity · SKILL.md

incident-management

incident-management

Manage IT incidents with structured processes: severity classification, escalation paths, communication templates, resolution procedures, and SLA tracking for rapid service restoration. TRIGGER when: user says /incident-management, "incident management", "IT incident", "severity classification", "escalation", "outage", "service disruption", "P1 incident", o…

Independent GitHub snapshot · Automated classification · Original documentation governs

Skill documentation

GitHub

name: incident-management description: > Manage IT incidents with structured processes: severity classification, escalation paths, communication templates, resolution procedures, and SLA tracking for rapid service restoration. TRIGGER when: user says /incident-management, "incident management", "IT incident", "severity classification", "escalation", "outage", "service disruption", "P1 incident", or "incident response plan". argument-hint: "[incident_description or severity]" user-invocable: true

IT Incident Management

You are an expert IT service management practitioner specializing in incident management. When the user asks you to manage an IT incident or design incident processes, follow this structured approach to ensure rapid service restoration with clear communication.

Step 1: Incident Detection and Logging

Capture complete incident details immediately:

FieldDescriptionExample
Incident IDAuto-generated unique IDINC-2026-0842
TitleConcise description"Payment processing service returning 500 errors"
ReporterWho detected or reportedMonitoring alert / Customer report / Help desk
Detection methodHow it was foundAutomated alert, user report, proactive monitoring
Affected serviceBusiness service impactedOnline payment processing
Impact scopeUsers/systems affectedAll customers attempting checkout
Start timeWhen the incident began (or was first detected)2026-04-08 14:23 UTC
EnvironmentProduction, staging, DRProduction
Related CIsConfiguration items involvedpayment-api-prod, stripe-gateway
SymptomsObservable behaviorHTTP 500 on /api/v2/payments, timeout after 30s
Initial categoryClassificationApplication — API Failure

Detection Sources

SourceTypical LatencyReliabilityAction
Synthetic monitoring< 1 minHighAuto-create incident ticket
APM alerts1-5 minHighAuto-page on-call engineer
Log anomaly detection2-10 minMediumAlert Slack channel, manual triage
Customer reports5-30 minVariableHelp desk creates ticket
Internal reportsVariableVariableLogged via self-service portal

Step 2: Severity Classification

Assign severity based on impact and urgency:

Severity Matrix

SeverityImpactUrgencyResponse TimeUpdate CadenceExample
P1 — CriticalEntire service down, revenue loss, data loss riskImmediate15 minEvery 30 minPayment system fully offline
P2 — HighMajor feature unavailable, significant user impactWithin 1 hour30 minEvery 1 hourSearch not returning results for 30% of queries
P3 — MediumPartial degradation, workaround availableWithin 4 hours2 hoursEvery 4 hoursSlow report generation, minor UI bug
P4 — LowMinimal impact, cosmetic, single userWithin 1 business day8 hoursDailyTypo in email template, minor display issue

Classification Decision Criteria

FactorQuestions to Assess
Business impactRevenue loss? Customer-facing? Regulatory exposure?
User scopeAll users, segment, single user?
WorkaroundIs there an alternative path for users?
Data integrityIs data at risk of loss or corruption?
SecurityIs there a security breach component?
ReputationalMedia or social media exposure risk?
Cascading riskCould this trigger failures in other systems?

Step 3: Escalation Paths

Define clear escalation procedures for each severity:

Escalation Matrix

SeverityLevel 1 (0-30 min)Level 2 (30-60 min)Level 3 (1-2 hours)Level 4 (2+ hours)
P1On-call engineerEngineering lead + Ops managerVP Engineering + CTOCEO (if customer/revenue impact)
P2On-call engineerTeam leadEngineering managerVP Engineering
P3Support engineerSenior engineerTeam leadEngineering manager
P4Support engineerSenior engineer——

Escalation Triggers

TriggerAction
No response within SLA response timeAuto-escalate to next level
No progress after 30 min (P1) or 2 hours (P2)Escalate to subject matter expert
Impact scope increasesRe-classify severity upward
Customer or executive inquiryNotify incident commander
Estimated resolution exceeds SLAEscalate for additional resources
Security component identifiedEngage security incident response team

Step 4: Communication Management

Communicate clearly throughout the incident lifecycle:

Communication Templates

Initial Notification (Internal)

INCIDENT ALERT — [Severity] — [INC-ID]
Service: [affected service]
Impact: [who/what is affected]
Status: Investigating
Started: [time UTC]
Incident Commander: [name]
Bridge: [call link or channel]
Next update: [time]

Customer-Facing Status Update

We are aware of an issue affecting [service description].
Impact: [user-facing description of symptoms]
Status: Our team is actively investigating and working to resolve this.
Workaround: [if available, describe]
Next update: We will provide an update by [time].

Resolution Notification

RESOLVED — [INC-ID] — [Severity]
Service: [affected service]
Duration: [start time] to [end time] ([total duration])
Root Cause: [brief summary]
Resolution: [what was done to fix it]
Impact: [number of users/transactions affected]
Follow-up: Post-incident review scheduled for [date].

Communication Channels by Audience

AudienceChannelFrequencyOwner
Incident teamWar room (Slack/Teams + bridge call)ContinuousIncident Commander
Engineering leadershipSlack channel + emailPer update cadenceIncident Commander
Customer Success/SupportInternal status page + SlackPer update cadenceCommunications Lead
CustomersPublic status page, in-app bannerPer update cadenceCommunications Lead
ExecutivesEmail + SMS for P1Per escalationIncident Commander

Step 5: Resolution Procedures

Follow structured resolution workflows:

Resolution Process

PhaseActionsDuration Target
TriageConfirm symptoms, verify severity, assign incident commander5-15 min
DiagnosisReview logs, metrics, recent changes; identify probable cause15-60 min
ContainmentApply immediate mitigation (rollback, failover, scale)5-30 min
ResolutionApply permanent or durable fixVariable
VerificationConfirm service restored, run smoke tests, monitor metrics15-30 min
ClosureUpdate stakeholders, close ticket, schedule PIR15 min

Common Resolution Actions

CategoryActions
RollbackRevert recent deployment, restore previous configuration
FailoverSwitch to redundant system, activate DR
RestartRestart service, clear cache, restart dependent services
ScaleAdd capacity (instances, CPU, memory, connections)
HotfixDeploy targeted code fix to production
ConfigurationUpdate config values, feature flags, DNS, firewall rules
VendorEngage vendor support, apply vendor patch
Data fixCorrect corrupted data, replay failed transactions

Step 6: SLA Tracking and Reporting

Monitor and report on incident management SLAs:

SLA Definitions

SLA MetricP1P2P3P4
Response time15 min30 min2 hours8 hours
Update frequency30 min1 hour4 hoursDaily
Resolution target4 hours8 hours3 business days5 business days
Escalation threshold30 min no progress2 hours no progress1 business day3 business days

Incident Metrics Dashboard

MetricCalculationTarget
MTTR (Mean Time to Resolve)Average resolution time across incidentsDecreasing trend
MTTA (Mean Time to Acknowledge)Average time from detection to first response< SLA response time
MTTD (Mean Time to Detect)Average time from incident start to detection< 5 min for P1
Incident volumeCount of incidents per period by severityDecreasing trend
SLA compliance% of incidents resolved within SLA> 95%
Recurrence rate% of incidents that are repeat occurrences< 10%
Escalation rate% of incidents requiring escalationDecreasing trend

Output Format

Present the incident management deliverable as:

  1. Incident Summary (ID, severity, service, impact, timeline)
  2. Severity Classification (matrix used, justification for assigned severity)
  3. Escalation Plan (matrix with contacts at each level)
  4. Communication Plan (templates, channels, cadence per audience)
  5. Resolution Procedure (step-by-step actions taken or planned)
  6. Timeline / Chronology (minute-by-minute or event-by-event log)
  7. SLA Status (response, update, resolution targets vs actuals)
  8. Post-Incident Review Plan (date, attendees, agenda)

Quality Checklist

Before closing the incident or delivering the plan, verify:

  • Severity is correctly classified using the impact/urgency matrix
  • Escalation paths are defined for all severity levels
  • Communication templates are prepared for internal and external audiences
  • Resolution procedure includes containment, fix, and verification steps
  • SLA targets are documented with tracking mechanisms
  • Post-incident review is scheduled (within 48 hours for P1/P2)
  • All affected configuration items are identified and documented
  • Monitoring confirms service is fully restored
  • Incident ticket is complete with timeline and resolution details

Edge Cases

  • Cascading failures across services: Assign a single incident commander for the overall event; create child incidents per affected service; prioritize by customer impact
  • Incident during change freeze: Classify as emergency change if a fix requires deployment; follow emergency change process in parallel with incident management
  • Vendor-caused incidents: Engage vendor support immediately; track vendor SLA separately; maintain internal communication cadence regardless of vendor responsiveness
  • Incidents with security implications: Invoke security incident response alongside IT incident management; restrict communication to need-to-know; preserve evidence
  • Duplicate incidents from same root cause: Link as related incidents; resolve the parent and bulk-close children; avoid inflating incident counts
  • Incidents discovered during post-mortem: If a latent issue is discovered during PIR, create a new problem record rather than reopening the incident
Saved skills