Imported from shepard-system/shepard-obs-stack (.claude/skills/obs-alerts/SKILL.md). Install upstream with npx skills add shepard-system/shepard-obs-stack --skill obs-alerts. Copyright stays with the author.

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

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