# promql

> Claude/Codex skill by [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars · Updated 2026-10-17

Write, validate, and optimize PromQL for Prometheus / Grafana Mimir / Grafana Cloud Metrics. Covers \`rate\` vs \`irate\` vs \`increase\`, label matchers and regex, \`sum / avg / topk / by / without\` aggregation, classic + native \`histogram\_quantile\`, ratios with divide-by-zero guards, \`absent\` / \`changes\` for staleness, time offsets and \`predict\_linear\`, recording-rule naming, SLO + burn-rate math, and a cardinality-hunting playbook. Use when writing a metric query, fixing wrong p95s, building an error-budget alert, debugging "query is slow", finding the noisy label that blew up cardinality, or migrating a dashboard query to a recording rule — even when the user says "calculate the error rate", "p99 latency", "sum by service", "why is this query slow", or "what's filling Mimir" without naming PromQL.

## Install

```sh
git clone https://github.com/grafana/skills /tmp/skills && ln -s /tmp/skills/skills/grafana-core/promql ~/.claude/skills/promql
```

## From README

PromQL Query Patterns Docs: https://prometheus.io/docs/prometheus/latest/querying/basics/ PromQL returns either an instant vector, a range vector, or a scalar. Golden rule: rate() / increase() require a range vector ≥ 4× the scrape interval. 60s scrape → use \[5m\] minimum. Prerequisites A Prometheus / Mimir / Grafana Cloud endpoint to query (/api/v1/query or via Grafana Explore) The PromQL pattern library in references/patterns.md Common Workflows Write + validate a query Common patterns to copy Per-status request rate (aggregate AFTER rate): p95 latency (must keep le in the inner aggregation): Error rate with divide-by-zero guard: Full library (recording rules, SLO burn-rate, offsets, cardinality hunt, native histograms): references/patterns.md.

## Links

- HTML page: https://omgskills.com/library/grafana/skills/promql/
- GitHub: https://github.com/grafana/skills
- Author: [@grafana](https://omgskills.com/library/grafana/index.md)

## More from this repo

- [k6-docs](https://omgskills.com/library/grafana/skills/k6-docs/index.md) — Used to write or review k6 documentation across the three k6 repositories - k6-DefinitelyTyped (TypeScript types),...
   - [@grafana](https://omgskills.com/library/grafana/index.md) · 295 stars
- [adaptive-metrics](https://omgskills.com/library/grafana/skills/adaptive-metrics/index.md) — Cut Grafana Cloud Metrics cost by shrinking active-series count with Adaptive Metrics aggregation rules —...
   - [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars
- [admin](https://omgskills.com/library/grafana/skills/admin/index.md) — Used to manage Grafana Cloud accounts — organizations, stacks, RBAC roles and assignments, SSO/SAML/OAuth/GitHub auth,...
   - [@grafana](https://omgskills.com/library/grafana/index.md) · 286 stars