Provides visibility and troubleshooting for active monitoring and observability alerts.

Install

mkdir -p .claude/skills/obs-alerts && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12223" && unzip -o skill.zip -d .claude/skills/obs-alerts && rm skill.zip

Installs to .claude/skills/obs-alerts

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.

Show active alerts and their resolution steps. Use this skill whenever the user asks about alerts, wants to know if anything is broken or firing, asks about Alertmanager state, mentions alert silences, or wants to troubleshoot a specific alert like OTelCollectorDown, LokiDown, HighSessionCost, or SensitiveFileAccess. Also use when the user says "any alerts?" or "is everything ok" in the context of the obs stack.
415 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • Query Alertmanager for active alerts
  • Query Alertmanager for active silences
  • Query Prometheus for firing or pending rule states
  • Query Prometheus for the total rule count
  • Provide alert-specific resolution hints from a reference document
  • Present alert information in a structured table format

How it works

The skill executes `obs-api.sh` to query Alertmanager and Prometheus for alert and silence states, then provides resolution hints from a reference document.

Inputs & outputs

You give it
A query about alerts, system status, or Alertmanager state
You get back
A table of active alerts, active silences, resolution hints, and total rule count

When to use obs-alerts

  • Check active alerts
  • List silenced notifications
  • Troubleshoot system failures

About this skill

Obs Alerts

Active alerts, silences, and resolution guidance.

Queries to run

Use scripts/obs-api.sh. Run independent queries in parallel.

Active alerts

scripts/obs-api.sh am /api/v2/alerts --raw --jq 'if length == 0 then "No active alerts" else .[] | "\(.labels.alertname)\t\(.labels.severity // "?")\t\(.status.state)\t\(.startsAt)" end'

Silences

scripts/obs-api.sh am /api/v2/silences --raw --jq '.[] | select(.status.state == "active") | "\(.matchers | map("\(.name)=\(.value)") | join(", "))\tuntil \(.endsAt)"'

Prometheus rule states (firing/pending)

scripts/obs-api.sh prom /api/v1/rules --raw --jq '.data.groups[].rules[] | select(.state == "firing" or .state == "pending") | "\(.name)\t\(.state)\t\(.annotations.summary // "")"'

Total rule count

scripts/obs-api.sh prom /api/v1/rules --raw --jq '[.data.groups[].rules | length] | add'

Resolution hints

For alert-specific fix instructions, read references/resolution-hints.md in this skill directory.

Output columns

ColumnSource
Alertalertname label
Severityseverity label
Statusfiring/pending
SincestartsAt timestamp
Descriptionsummary annotation

For output format options (table/csv/json), read .claude/skills/obs-shared/assets/output-formats.md.

Presentation

  1. Alert table: Alert | Severity | Status | Since
  2. If alerts are firing, read references/resolution-hints.md and provide the fix
  3. If silences are active, mention them
  4. If no alerts: "All clear. 0 of 16 rules firing."
  5. Show total rule count for context

When not to use it

  • When the user is not asking about alerts or the observation stack
  • When the user is not interested in Alertmanager or Prometheus states
  • When the user wants to troubleshoot issues unrelated to alerts

Prerequisites

scripts/obs-api.sh

Limitations

  • Relies on `scripts/obs-api.sh` for queries
  • Resolution hints are read from `references/resolution-hints.md`
  • Output format options are defined in `output-formats.md`

How it compares

This skill automates the querying of Alertmanager and Prometheus for alert status and provides specific resolution hints, which is more efficient than manually checking multiple systems and documentation.

Compared to similar skills

obs-alerts side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
obs-alerts (this skill)05moReviewIntermediate
agent-performance-monitor36moReviewAdvanced
agent-performance-optimizer36moNo flagsAdvanced
coderabbit-observability125dReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry