add-alert-policy

Create notification alert policies with escalation steps and severity thresholds.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/michaelayoade/dotmac_crm --skill add-alert-policy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-alert-policy
Source: https://github.com/michaelayoade/dotmac_crm/tree/main/.claude/skills/add-alert-policy
Command: npx skills add https://github.com/michaelayoade/dotmac_crm --skill add-alert-policy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams define reliable notification alert policies that route alerts by severity, deliver to the right channels, and escalate through on-call rotations with audit logging.

Core Features & Use Cases

  • Severity-based routing: Apply a severity_min threshold so low-severity events are skipped.
  • Escalation chains: Configure ordered multi-step delivery with per-step delays (e.g., email now, SMS later).
  • On-call rotation support: Resolve step recipients from an OnCallRotation using round-robin logic (priority + last_used_at).
  • Template-driven notifications: Use NotificationTemplate records and render messages with Jinja2 variables for consistent content.
  • Operational audit trail: Create AlertNotificationLog entries and queue delayed escalation steps for traceability.

Quick Start

Use the add-alert-policy skill to generate an alert policy that sends an immediate email, escalates via SMS after 15 minutes, and then routes to the active on-call member after 30 minutes.

Frequently Asked Questions about add-alert-policy

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

FAQPage Schema
How do I configure alert escalation policies for on-call rotations?

Configure alert escalation policies by defining ordered, multi-step delivery chains with per-step delays. The policy resolves on-call rotation recipients deterministically using round-robin logic and queues delayed steps for execution.

What's the best way to route system alerts by severity threshold?

Route system alerts by applying a severity_min threshold to your notification policy. This ensures low-severity events are skipped entirely, triggering escalation chains only for critical operational health events.

How do I add delayed notification steps to an alert policy?

Add delayed notification steps by scheduling ordered delivery chains within the alert policy. You can configure an immediate email, an SMS after a 15-minute delay, and route to an active on-call member after 30 minutes.

Does this alert policy support template-driven notifications?

Yes, the alert policy supports template-driven notifications. It uses NotificationTemplate records and renders messages with Jinja2 variables to ensure consistent content delivery across all escalation steps.

Can I audit alert notification deliveries within the escalation workflow?

Yes, you can audit deliveries because the policy creates AlertNotificationLog entries during execution. These logs tie notifications to templates and policy steps, providing an operational audit trail for traceability.

How does round-robin logic work for on-call rotation recipients?

Round-robin logic for on-call rotations resolves step recipients deterministically by evaluating priority and last_used_at timestamps. This ensures fair distribution of alerts among qualified team members.