Axiom alerting skill

This page explains how to use the Axiom alerting skill to give AI coding agents the ability to create and manage monitors and notifiers in Axiom.

The Axiom alerting skill helps AI agents manage Axiom alerting end-to-end:

  • Notifier management: Create, update, list, and delete notifiers for email, Slack, and webhooks
  • Monitor lifecycle: Create, update, inspect, and delete monitors for threshold, match-event, and anomaly workflows
  • Validation workflow: Check monitor history and tune alert behavior based on real execution outcomes
  • Operational guardrails: Structured guidance for payload validation, monitor field choices, and troubleshooting API errors

Prerequisites

Install Axiom Skills

Install all Axiom skills at once for Claude Code, Cursor, and other Claude-compatible agents:

npx skills add axiomhq/skills

Configure Axiom credentials

All Axiom Skills share the same credential configuration. Create a configuration file at ~/.axiom.toml:

[deployments.dev]
url = "https://api.axiom.co"
token = "API_TOKEN"
org_id = "ORGANIZATION_ID"
edge_url = "AXIOM_DOMAIN"

Use Axiom alerting skill

The Axiom alerting skill activates automatically when you ask your AI agent to:

  • Create or manage monitors and notifiers
  • Route alerts to the right destination
  • Validate monitor behavior and alert noise
  • Maintain and tune existing alert configurations

Example prompts:

  • "Create a monitor that alerts when error count exceeds 100 in 5 minutes"
  • "List available notifiers and create a Slack notifier for on-call alerts"
  • "Show monitor history for the last day and help tune alert thresholds"
  • "Update this monitor to reduce noisy alerts with N-of-M triggering"