authoring-promql-and-analyzing-metrics
Discovers Prometheus metric schemas, authors and lints type-safe PromQL 3.0 queries (classic and native histograms, UTF-8 OTel selectors, vector joins, subqueries, and zero-fill ratios), and analyzes instant, range, or period-over-period time series. Use when asked to write, lint, fix, or execute a PromQL query, explore available metrics and labels, calculate percentiles or rates, compare current vs historical baseline windows, or render time-series charts. Do not use for authoring or deploying PrometheusRule CRDs and alert unit tests (use authoring-and-testing-prometheus-rules), incident RED/SLO burn-rate triage (use triaging-prometheus-incidents-and-slos), TSDB cardinality FinOps relabeling (use optimizing-tsdb-cardinality-and-finops), LogQL log queries (use authoring-logql-and-analyzing-logs), or TraceQL queries (use authoring-traceql-and-metrics-queries).
- Version
- 0.2.0
- License
- Apache-2.0
Pinned to revision e93452925e25, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/authoring-promql-and-analyzing-metrics/SKILL.md
- skills/authoring-promql-and-analyzing-metrics/references/anti-patterns-and-pitfalls.md
- skills/authoring-promql-and-analyzing-metrics/references/promql-3-syntax-and-functions.md
- skills/authoring-promql-and-analyzing-metrics/scripts/lint_promql.py
Every link opens the file at its source, pinned to the revision this page describes.