pagerduty-orchestration

$npx mdskill add automateyournetwork/netclaw/pagerduty-orchestration

Manages event orchestration and routing rules in PagerDuty

  • Solves the task of configuring and reviewing event routing logic
  • Uses PagerDuty APIs to access and modify orchestration settings
  • Applies user input to select and execute specific orchestration actions
  • Returns structured data about orchestrations and router rules

SKILL.md

.github/skills/pagerduty-orchestrationView on GitHub ↗
---
name: pagerduty-orchestration
description: "Manage event orchestration and routing rules in PagerDuty."
version: 1.0.0
license: Apache-2.0
author: netclaw
tags: []
---

# PagerDuty Orchestration Skill

Manage event orchestration and routing rules in PagerDuty.

## Tools

| Tool | Description |
|------|-------------|
| `get_event_orchestration` | Get orchestration details |
| `get_event_orchestration_global` | Get global orchestration settings |
| `get_event_orchestration_router` | Get router rules for an orchestration |
| `get_event_orchestration_service` | Get service-specific orchestration |
| `list_event_orchestrations` | List all event orchestrations |
| `update_event_orchestration_router` | Update router rules (requires write) |
| `append_event_orchestration_router_rule` | Add a new router rule (requires write) |

## Example Queries

```
List all event orchestrations
→ list_event_orchestrations()

Get orchestration details
→ get_event_orchestration(orchestration_id="E1ABCD23")

Get router rules
→ get_event_orchestration_router(orchestration_id="E1ABCD23")

Get global orchestration settings
→ get_event_orchestration_global(orchestration_id="E1ABCD23")
```

## Workflows

### Event Routing Review
1. List orchestrations: `list_event_orchestrations()`
2. Get orchestration details: `get_event_orchestration(orchestration_id="...")`
3. Review router rules: `get_event_orchestration_router(orchestration_id="...")`
4. Check service-specific rules: `get_event_orchestration_service(orchestration_id="...", service_id="...")`

### Add Network Event Routing Rule
1. List current orchestrations: `list_event_orchestrations()`
2. Get current router rules: `get_event_orchestration_router(orchestration_id="...")`
3. Append new rule: `append_event_orchestration_router_rule(orchestration_id="...", rule={...})`
4. Verify rule added: `get_event_orchestration_router(orchestration_id="...")`

### Event Suppression Setup
1. Get global orchestration: `get_event_orchestration_global(orchestration_id="...")`
2. Review existing suppression rules
3. Add suppression rule for maintenance window
4. Verify: `get_event_orchestration_global(orchestration_id="...")`

### Routing Audit
1. List all orchestrations: `list_event_orchestrations()`
2. For each orchestration, get router rules
3. Document routing logic and destinations
4. Identify gaps or misconfigurations

## Prerequisites

- `PAGERDUTY_USER_API_KEY` PagerDuty User API key
- `PAGERDUTY_API_HOST` API host (optional, for EU customers)

## Server

This skill uses the `pagerduty-mcp` server via uvx (stdio transport).

## Notes

- Write operations (update/append rules) require `--enable-write-tools`
- Event orchestration changes affect all incoming events
- Test routing changes in a non-production orchestration first
- Document all routing rule changes in GAIT audit trail

More from automateyournetwork/netclaw

SkillDescription
aap-automationRed Hat Ansible Automation Platform — inventory management, job template execution, project SCM sync, ad-hoc commands, host management, Galaxy content discovery. Use when automating infrastructure with Ansible, running playbooks, managing inventories, or searching for Ansible collections and roles.
aap-edaEvent-Driven Ansible (EDA) — activation lifecycle, rulebook management, decision environments, event stream monitoring. Use when managing event-driven automation triggers, enabling/disabling activations, or reviewing EDA rulebooks.
aap-lintansible-lint playbook and role validation — syntax checking, best practice enforcement, project-wide analysis, rule filtering. Use when validating Ansible playbooks, checking code quality, or enforcing automation best practices before deployment.
aci-change-deploySafe ACI policy change deployment - ServiceNow CR lifecycle, pre/post-change fault baselines, APIC policy application, automatic rollback on fault delta, and GAIT audit trail. Use when deploying ACI policy changes, creating tenants or EPGs, pushing config to APIC, or running a change window with rollback protection.
aci-fabric-auditComprehensive Cisco ACI fabric health audit - node status, tenant/VRF/BD/EPG policy review, contract analysis, fault triage, and endpoint learning verification. Use when auditing ACI fabric health, checking for faults, reviewing tenant policies, or running pre/post-change baselines on APIC.
arista-cvpArista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools). Use when managing Arista devices, checking CloudVision events, monitoring network connectivity probes, or tagging devices in CVP.
aruba-cx-configView and manage Aruba CX switch configurations, perform ISSU upgrades, and firmware operations
aruba-cx-interfacesMonitor Aruba CX switch interface status, LLDP neighbors, and optical transceiver health
aruba-cx-switchingView and manage Aruba CX switch VLANs and MAC address tables for Layer 2 operations
aruba-cx-systemDiscover Aruba CX switch system information, firmware versions, and VSF topology