Pagerduty

PagerDuty incident management — manage incidents, services, schedules, escalation policies, and on-call via REST API

Security Scan

The skill is internally coherent: it implements a PagerDuty CLI, only needs a PagerDuty API key, and the code and instructions line up with that purpose, with a small note about an undocumented .env lookup.

Purpose & Capability

Name, description, and commands map to PagerDuty REST API operations. The declared primaryEnv is PAGERDUTY_API_KEY and the code uses that token to call api.pagerduty.com; required binaries and install footprint are minimal and proportional to the stated purpose.

Instruction Scope

SKILL.md instructs running the included Python CLI which only issues PagerDuty API requests. The runtime code does attempt to read an optional .env file (see environment detail), which is reasonable for finding the API key but is not documented in SKILL.md. The request code can accept a full URL if given a path starting with 'http', but the provided CLI subcommands do not expose a generic path argument that would let arbitrary URLs be supplied in normal usage.

Install Mechanism

No install spec; this is instruction-only plus a single Python script that uses only the standard library. Nothing is downloaded or extracted, and no binaries are created on disk by an install step.

Credentials

Declared requirement is a single PAGERDUTY_API_KEY which is appropriate. However, the script also checks WORKSPACE (an undocumented env var) and will read a .env file under that workspace (~/.openclaw/workspace/.env by default) to find the key. SKILL.md does not declare WORKSPACE or mention the .env lookup; this mismatch should be noted because it means the script may read a local file to obtain the token if the env var isn't set.

Persistence & Privilege

The skill is not forced-always, does not request system-wide changes, and does not modify other skills or global agent settings. It runs a CLI script on demand and does not persist credentials beyond reading them from environment or a local .env file.

Assessment

This skill appears to do what it claims: a small Python CLI that calls the PagerDuty API and requires a PAGERDUTY_API_KEY. Before installing, verify you are comfortable providing a PagerDuty API token and prefer to give a token scoped with least privilege. Be aware the script will try to read WORKSPACE (if set) or ~/.openclaw/workspace/.env to find the key if PAGERDUTY_API_KEY isn't exported — the SKILL.md does not document that .env lookup. If you want to be cautious, review the included scripts/pagerduty.py yourself, run it in an isolated environment, and ensure the API key you provide has minimal necessary permissions. Finally, the skill's source is listed as unknown and the homepage is a third-party vendor; if provenance matters, confirm the publisher before widespread use.

PagerDuty incident management — manage incidents, services, schedules, escalation policies, and on-call via REST API

Requirements

Variable	Required	Description
PAGERDUTY_API_KEY	✅	API token from pagerduty.com

Quick Start

# List incidents
python3 {{baseDir}}/scripts/pagerduty.py incidents --statuses[] <value> --since <value> --until <value>

# Get incident
python3 {{baseDir}}/scripts/pagerduty.py incident-get id <value>

# Create incident
python3 {{baseDir}}/scripts/pagerduty.py incident-create --title <value> --service_id <value> --urgency <value>

# Update incident
python3 {{baseDir}}/scripts/pagerduty.py incident-update id <value> --status <value>

# List incident notes
python3 {{baseDir}}/scripts/pagerduty.py incident-notes id <value>

# Add note
python3 {{baseDir}}/scripts/pagerduty.py incident-note-add id <value> --content <value>

# List services
python3 {{baseDir}}/scripts/pagerduty.py services --query <value>

# Get service
python3 {{baseDir}}/scripts/pagerduty.py service-get id <value>

All Commands

Command	Description
incidents	List incidents
incident-get	Get incident
incident-create	Create incident
incident-update	Update incident
incident-notes	List incident notes
incident-note-add	Add note
services	List services
service-get	Get service
service-create	Create service
oncalls	List on-calls
schedules	List schedules
schedule-get	Get schedule
escalation-policies	List escalation policies
users	List users
user-get	Get user
teams	List teams
vendors	List vendors
notifications	List notifications
abilities	List abilities

Output Format

All commands output JSON by default. Add --human for readable formatted output.

python3 {{baseDir}}/scripts/pagerduty.py <command> --human

Script Reference

Script	Description
{{baseDir}}/scripts/pagerduty.py	Main CLI — all commands in one tool

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation