prometheus-cluster-health SKILL.md skillA

prometheus-cluster-health from tanguille/cluster is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tanguille/cluster/prometheus-cluster-health@git:20261014.1b8131c

Pins git:20261014.1b8131c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tanguille/cluster
Path
.agents/skills/prometheus-cluster-health/SKILL.md
Versions recorded
4
Latest version
git:20261014.1b8131c, committed Oct 14, 2026
First version recorded
May 30, 2026
Size
3,790 bytes
Repository stars
15
License
MIT

Summarize Kubernetes cluster health from Prometheus: firing alerts, CPU/memory hotspots, and workload signal. Default lookback is 30 minutes unless the user specifies another window. user: "cluster health" / "health snapshot" → alerts + top CPU pods over $WINDOW user: "firing alerts" → list_alert_rules or ALERTS PromQL fallback user: "top CPU pods" / "how's the load" → container_cpu usage queries (cores, not sec/min) user: "is karakeep healthy?" → filter namespace/pod + correlate alerts Prefer…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Prometheus cluster health snapshot

Answer “is the cluster OK?” and “who is using CPU?” with **correct units** (CPU in **cores**) via Grafana MCP or Prometheus API.

## Default lookback

- **Default `$WINDOW`:** `30m`. User overrides: `15m`, `1h`, `2h`, etc. — use consistently in all queries.
- **`$STEP`:** `1m` for windows up to ~2h; `5m` for longer windows.
- **Instant snapshots:** subquery patterns `[$WINDOW:$STEP]` around inner `rate(...[5m])`.

## Tool usage (Grafana MCP)

Stack: Grafana MCP (`grafana/mcp-grafana`), behind the ToolHive unified vMCP. Datasource uid `prometheus` (default) — VictoriaMetrics behind `vmauth-victoria-metrics.observability:8427`; second uid `victoriametrics`.

**Before any call:** resolve real tool names in this session (may be prefixed, e.g. `grafana_query_prometheus`).

| Goal | Tools |
|------|--------|
| Datasource UID | `list_datasources`, `get_datasource_by_uid` |
| Firing alerts | **`list_alert_rules`**, `list_alert_groups` |
| PromQL | **`query_prometheus`** (`queryType`, `startTime`, `endTime`, `stepSeconds`) |
| Discovery | `list_prometheus_metric_names`, `list_prometheus_label_*` |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tanguille/cluster/prometheus-cluster-health@sha256:c5de91911cd109c9

The line at the top of this page pins the label git:20261014.1b8131c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fhl4pguexqk6i44x.svg)](https://markdownregistry.com/a/art_fhl4pguexqk6i44x)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between May 30, 2026 and Oct 14, 2026, about one every 46 days.

versioncommittedcommitsizeaudit
git:20261014.1b8131c latest2026-10-14 1b8131c 3,790 BA view · diff
git:20260911.093c4fb2026-09-11 093c4fb 3,797 BA view · diff
git:20260711.18776f82026-07-11 18776f8 3,872 BA view · diff
git:20260530.bb88c152026-05-30 bb88c15 3,792 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3790 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tanguille/cluster · 15 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fhl4pguexqk6i44x
GET https://markdownregistry.com/api/v1/resolve?ref=tanguille/cluster/prometheus-cluster-health
GET https://markdownregistry.com/api/v1/blob/c5de91911cd109c9d579664a7007764c5307be1ec8a3d2eca2915739d764b527

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from tanguille/cluster

add-app-to-cluster SKILL.md skill
tanguille/cluster · .agents/skills/add-app-to-cluster/SKILL.md · Deploy new applications to the Kubernetes cluster via FluxCD GitOps. Creates HelmReleases, Kustomizations, and…
git:20261014.1b8131c · audit A · 15 stars
backup-restore SKILL.md skill
tanguille/cluster · .agents/skills/backup-restore/SKILL.md · Manage kopiur Kopia-based backups and restores for Kubernetes PVs in this cluster. user: "check backup status for app…
git:20261014.1b8131c · audit A · 15 stars
debug-cluster SKILL.md skill
tanguille/cluster · .agents/skills/debug-cluster/SKILL.md · Diagnose and resolve Kubernetes cluster issues using structured fact gathering and 5-Whys root cause analysis. user…
git:20261014.1b8131c · audit A · 15 stars
git-worktree-isolation SKILL.md skill
tanguille/cluster · .agents/skills/git-worktree-isolation/SKILL.md · Use git worktrees for isolated, parallel agent work without polluting the main working tree. user: "work on feature X"…
git:20260928.2939037 · audit A · 15 stars
handoff SKILL.md skill
tanguille/cluster · .agents/skills/handoff/SKILL.md · Write and resume durable work handoffs so tasks that cross a session, compaction, or approval boundary are never lost —…
git:20261014.1b8131c · audit A · 15 stars
k8s-at-home-research SKILL.md skill
tanguille/cluster · .agents/skills/k8s-at-home-research/SKILL.md · Research Kubernetes GitOps patterns from public GitHub repositories tagged `k8s-at-home` and adapt findings to this…
git:20260911.093c4fb · audit A · 15 stars
pr-review SKILL.md skill
tanguille/cluster · .agents/skills/pr-review/SKILL.md · Review GitOps Kubernetes PRs or local diffs: naming, HelmRelease patterns, SOPS/security, structure, and build…
git:20261014.1b8131c · audit A · 15 stars
AGENTS.md AGENTS.md file
tanguille/cluster · AGENTS.md
git:20261010.87a35df · audit A · 15 stars
AGENTS.md@kubernetes AGENTS.md file
tanguille/cluster · kubernetes/AGENTS.md
git:20260711.cf41e08 · audit A · 15 stars
AGENTS.md@talos AGENTS.md file
tanguille/cluster · talos/AGENTS.md
git:20260821.43c029c · audit A · 15 stars

Every file in tanguille/cluster

Browse by kind, by grade A, or by owner.