pagerduty
Automates the setup of PagerDuty services, escalation policies, and monitoring integrations.
Install
mkdir -p .claude/skills/pagerduty-terminalskills && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11229" && unzip -o skill.zip -d .claude/skills/pagerduty-terminalskills && rm skill.zipInstalls to .claude/skills/pagerduty-terminalskills
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Configure PagerDuty for incident management, on-call scheduling, alert routing, and escalation policies. Use when a user needs to set up PagerDuty services, create escalation policies, configure integrations with monitoring tools, manage on-call rotations, or automate incident workflows.Key capabilities
- →Configure escalation policies
- →Manage on-call rotations
- →Connect monitoring alerts
- →Automate incident workflows
How it works
It provides API-based configuration for PagerDuty services, schedules, and event orchestration.
Inputs & outputs
When to use pagerduty
- →Create new on-call escalation policies
- →Connect monitoring alerts to PagerDuty
- →Configure incident response services
- →Manage on-call schedule rotations
About this skill
PagerDuty
Overview
Set up PagerDuty for incident management with on-call schedules, escalation policies, and integrations. Covers service creation, Events API for triggering alerts, schedule management, and automation via the REST API.
Instructions
REST calls go to https://api.pagerduty.com with Authorization: Token token=${PD_API_KEY} (an OAuth access token uses Authorization: Bearer ...). The API expects Accept: application/vnd.pagerduty+json;version=2 for versioning; the snippets below omit it for brevity, so add -H "Accept: application/vnd.pagerduty+json;version=2" in real scripts. Events API calls need no API key, only the integration's routing key (PD_ROUTING_KEY).
Task A: Create Services and Escalation Policies
# Create an escalation policy
curl -X POST "https://api.pagerduty.com/escalation_policies" \
-H "Authorization: Token token=${PD_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"escalation_policy": {
"name": "Platform Team Escalation",
"escalation_rules": [
{
"escalation_delay_in_minutes": 10,
"targets": [
{ "id": "P1AB2CD", "type": "schedule_reference" }
]
},
{
"escalation_delay_in_minutes": 15,
"targets": [
{ "id": "PXYZ789", "type": "user_reference" }
]
}
],
"num_loops": 2
}
}'
# Create a service with the escalation policy
curl -X POST "https://api.pagerduty.com/services" \
-H "Authorization: Token token=${PD_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"service": {
"name": "Payment Service - Production",
"description": "Payment processing microservice",
"escalation_policy": { "id": "PESCAL1", "type": "escalation_policy_reference" },
"alert_creation": "create_alerts_and_incidents",
"auto_resolve_timeout": 14400,
"acknowledgement_timeout": 1800,
"incident_urgency_rule": {
"type": "use_support_hours",
"during_support_hours": { "type": "constant", "urgency": "high" },
"outside_support_hours": { "type": "constant", "urgency": "low" }
},
"support_hours": {
"type": "fixed_time_per_day",
"time_zone": "America/New_York",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "08:00:00",
"end_time": "20:00:00"
}
}
}'
Alert grouping on a service is configured through the Alert Grouping Settings resource; the alert_grouping_parameters field on a service is deprecated.
curl -X POST "https://api.pagerduty.com/alert_grouping_settings" \
-H "Authorization: Token token=${PD_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"alert_grouping_setting": {
"name": "Payment alerts by component",
"type": "content_based",
"config": { "time_window": 900, "aggregate": "all", "fields": ["summary", "component"] },
"services": [{ "id": "PSVC_PAY", "type": "service_reference" }]
}
}'
Grouping features depend on the plan; the API returns an error if yours does not include the chosen type.
Task B: Send Alerts via Events API
# Trigger an alert
curl -X POST "https://events.pagerduty.com/v2/enqueue" \
-H "Content-Type: application/json" \
-d '{
"routing_key": "'"${PD_ROUTING_KEY}"'",
"event_action": "trigger",
"dedup_key": "payment-service/high-error-rate/prod",
"payload": {
"summary": "Payment Service: Error rate exceeded 5% (currently 8.3%)",
"severity": "critical",
"source": "prometheus-alertmanager",
"component": "payment-service",
"group": "production",
"class": "error_rate",
"custom_details": {
"error_rate": "8.3%",
"threshold": "5%",
"affected_endpoints": ["/api/charge", "/api/refund"],
"runbook": "https://wiki.internal/runbooks/payment-errors"
}
},
"links": [
{ "href": "https://grafana.internal/d/payments", "text": "Grafana Dashboard" }
]
}'
# Acknowledge an alert
curl -X POST "https://events.pagerduty.com/v2/enqueue" \
-H "Content-Type: application/json" \
-d '{
"routing_key": "'"${PD_ROUTING_KEY}"'",
"event_action": "acknowledge",
"dedup_key": "payment-service/high-error-rate/prod"
}'
# Resolve an alert
curl -X POST "https://events.pagerduty.com/v2/enqueue" \
-H "Content-Type: application/json" \
-d '{
"routing_key": "'"${PD_ROUTING_KEY}"'",
"event_action": "resolve",
"dedup_key": "payment-service/high-error-rate/prod"
}'
Task C: On-Call Schedules
# Create a weekly rotation schedule
curl -X POST "https://api.pagerduty.com/schedules" \
-H "Authorization: Token token=${PD_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"schedule": {
"name": "Platform Team Primary On-Call",
"time_zone": "America/New_York",
"schedule_layers": [
{
"name": "Weekly Rotation",
"start": "2026-11-02T09:00:00-05:00",
"rotation_virtual_start": "2026-11-02T09:00:00-05:00",
"rotation_turn_length_seconds": 604800,
"users": [
{ "user": { "id": "PUSER01", "type": "user_reference" } },
{ "user": { "id": "PUSER02", "type": "user_reference" } },
{ "user": { "id": "PUSER03", "type": "user_reference" } }
],
"restrictions": [
{
"type": "daily_restriction",
"start_time_of_day": "09:00:00",
"duration_seconds": 57600
}
]
}
]
}
}'
# Get who is currently on call
curl -s "https://api.pagerduty.com/oncalls?schedule_ids[]=PSCHED1&earliest=true" \
-H "Authorization: Token token=${PD_API_KEY}" | \
jq '.oncalls[] | {user: .user.summary, schedule: .schedule.summary, start: .start, end: .end}'
Task D: Incident Management
# List open incidents
curl -s "https://api.pagerduty.com/incidents?statuses[]=triggered&statuses[]=acknowledged" \
-H "Authorization: Token token=${PD_API_KEY}" | \
jq '.incidents[] | {id: .id, title: .title, status: .status, urgency: .urgency, service: .service.summary, created: .created_at}'
# Add a note to an incident
curl -X POST "https://api.pagerduty.com/incidents/${INCIDENT_ID}/notes" \
-H "Authorization: Token token=${PD_API_KEY}" \
-H "Content-Type: application/json" \
-H "From: [email protected]" \
-d '{
"note": {
"content": "Identified root cause: connection pool exhaustion on db-primary. Scaling up connections from 100 to 200."
}
}'
Task E: Automation with Event Orchestration
# Replace the router rules of a global orchestration (rules left out of the request are deleted)
curl -X PUT "https://api.pagerduty.com/event_orchestrations/${ORCH_ID}/router" \
-H "Authorization: Token token=${PD_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"orchestration_path": {
"sets": [
{
"id": "start",
"rules": [
{
"label": "Route payments alerts",
"conditions": [
{ "expression": "event.component matches part '\''payment'\''" }
],
"actions": {
"route_to": { "service": { "id": "PSVC_PAY", "type": "service_reference" } }
}
},
{
"label": "Suppress health checks",
"conditions": [
{ "expression": "event.summary matches part '\''health check'\''" }
],
"actions": { "suppress": true }
}
]
}
],
"catch_all": {
"actions": {
"route_to": { "service": { "id": "PSVC_DEFAULT", "type": "service_reference" } }
}
}
}
}'
Examples
Example 1: Page the on-call engineer for a failing payment service
User request: "Wire Alertmanager to PagerDuty so a payment error rate above 5% pages whoever is on call."
Create the escalation policy and service (Task A), add an Events API v2 integration to the service in the PagerDuty UI and export its routing key as PD_ROUTING_KEY, then send the trigger from Task B. A successful call returns:
{"status": "success", "message": "Event processed", "dedup_key": "payment-service/high-error-rate/prod"}
Sending the same dedup_key with resolve closes the incident when the error rate recovers.
Example 2: Find who is on call right now
User request: "Who is on call for the platform schedule?"
curl -s "https://api.pagerduty.com/oncalls?schedule_ids[]=PSCHED1&earliest=true" \
-H "Authorization: Token token=${PD_API_KEY}" | jq -r '.oncalls[] | "\(.user.summary) until \(.end)"'
Prints one line per escalation level, for example Dana Whitfield until 2026-11-09T09:00:00-05:00.
Guidelines
- Keep
PD_API_KEYand routing keys in environment variables or a secret store, never in the repository; a REST key can read and change the whole account unless it is read-only - Notes, incident updates and other write calls on incidents need a
Fromheader with the email of a valid PagerDuty user - List endpoints are paginated (
limitup to 100,offset,more); loop untilmoreis false - Use
dedup_keyto prevent duplicate incidents for the same issue - Set intelligent alert grouping to automatically correlate related alerts
- Include runbook links and dashboard URLs in alert custom details
- Configure support hours to route low-urgency alerts during business hours only
- Rotate on-call weekly and limit shifts to avoid burnout
- Use event orchestration to suppress noisy alerts and enrich events before routing
When not to use it
- →Non-PagerDuty incident management
Prerequisites
Limitations
- →Requires PagerDuty API access
How it compares
It automates incident management setup via API, unlike manual web UI configuration.
Compared to similar skills
pagerduty side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| pagerduty (this skill) | 0 | 6mo | Review | Intermediate |
| system-info | 1 | 9mo | Review | Beginner |
| it-operations | 1 | 11mo | No flags | Advanced |
| pagerduty-automation | 0 | 8mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TerminalSkills
View all by TerminalSkills →You might also like
system-info
Xxiii8322766509
系统信息查询技能。用于获取电脑硬件信息、系统状态、进程列表、磁盘空间等。当用户询问电脑配置、系统状态或性能信息时使用。
it-operations
davila7
Manages IT infrastructure, monitoring, incident response, and service reliability. Provides frameworks for ITIL service management, observability strategies, automation, backup/recovery, capacity planning, and operational excellence practices.
pagerduty-automation
T-Sunm
Automate PagerDuty tasks via Rube MCP (Composio): manage incidents, services, schedules, escalation policies, and on-call rotations. Always search tools first for current schemas.
oly
slaveOftime
Use when starting a long-running or interactive CLI command with oly, especially when it may need later input, should be detachable, or should keep durable logs for supervision and resume.
incident-response
fabioc-aloha
Calm, systematic crisis handling — from detection through post-mortem to prevention
monitor-ci
ever-co
Monitor Nx Cloud CI pipeline and handle self-healing fixes. USE WHEN user says "monitor ci", "watch ci", "ci monitor", "watch ci for this branch", "track ci", "check ci status", wants to track CI status, or needs help with self-healing CI fixes. Prefer this skill over native CI provider tools (gh, g