alerting-context

Retrieve incident details, on-call context, and MTTR metrics from PagerDuty.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill alerting-context-erwinv2k-tkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alerting-context
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/sre-agent/.claude/skills/alerting-context
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill alerting-context-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve? During incident response, engineers waste time manually checking PagerDuty to find who is on-call, whether an alert is a recurring issue, and how long similar incidents typically take to resolve. This Skill pulls that alerting context directly into the investigation workflow. ## Core Features & Use Cases - Incident Lookup: Fetch full details of any PagerDuty incident by ID, including status, urgency, assignments, acknowledgements, and an optional timeline of events. - Incident Listing & Filtering: List incidents filtered by status (triggered, acknowledged, resolved), service, and time range to spot recurring alerts or correlated incidents. - MTTR Calculation: Compute mean, median, p95, min, and max resolution times for a service over a configurable number of days. - Use Case: When a new alert fires, run the incident lookup to see who acknowledged it, list the last 30 days of incidents to check if it is a known recurring issue, and compare its duration against the service's historical MTTR to decide whether to escalate. ## Quick Start Ask the agent to pull the PagerDuty context for incident P123ABC, including its timeline and any similar incidents from the last 30 days.

Frequently Asked Questions about alerting-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get PagerDuty incident details from the command line?

Run get_incident.py with the --id flag followed by the PagerDuty incident ID, for example python get_incident.py --id P123ABC. Add the --timeline flag to include the incident's log entries and escalation events.

How do I calculate MTTR for a PagerDuty service?

Run calculate_mttr.py with the --service flag set to the service ID and --days for the analysis window. The script returns mean, median, p95, minimum, and maximum resolution times based on resolved incidents in that period.

Do I need to set a PagerDuty API key environment variable?

No. Credentials are injected automatically by the IncidentFox credential proxy, so scripts should be run directly without checking for PAGERDUTY_API_KEY. A direct token is only used as a fallback for local development.

Can I filter PagerDuty incidents by status or time range?

Yes. list_incidents.py supports --status (triggered, acknowledged, resolved), --service, --days, and --limit flags. Always use a time range to keep queries bounded and avoid timeouts.

Why does the MTTR calculation return no data?

The calculation requires resolved incidents within the selected time window. If no incidents were resolved in the chosen days, or timestamps cannot be parsed, the script reports a zero sample size with an explanatory message.