Promql Cli

A wrapper for the promql-cli tool that lets Claude query Prometheus and compatible engines like Thanos, Cortex, or VictoriaMetrics directly from the terminal. Built for debugging production issues: tracking error rates, spotting latency spikes, investigating saturation. The skill bundles installation docs, a PromQL reference, and debugging patterns, plus it enforces good query hygiene like using rate() on counters and filtering early with label matchers. Output formats include ASCII graphs, which work surprisingly well for showing trends in a chat context. The setup instructions are careful about credentials, refusing to create config files that might contain tokens. If you're already using Prometheus for observability, this bridges the gap between metrics and conversation.

skills.sh installs: 5.2K
GitHub stars: 242
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add samber/cc-skills --skill promql-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

promql-cli — Prometheus Query CLI Skill

promql-cli (github.com/nalbury/promql-cli) is a Go CLI for querying, analyzing, and visualizing Prometheus metrics, plus PromQL fundamentals.

Reference Files

Read the relevant reference file(s) before executing tasks:

File	When to read
`references/installation.md`	User needs to install promql-cli or set up configuration (hosts, auth, token, password, multi-host)
`references/usage.md`	User wants to discover metrics/exporters/labels, run queries, or choose output formats
`references/graphing.md`	User wants to visualize Prometheus data as an ASCII chart in the terminal
`references/debugging.md`	User is investigating a performance issue, latency, errors, saturation, data gaps, or query cost issues
`references/promql-reference.md`	User needs help writing PromQL, understanding metric types, functions, or aggregations

For most tasks, read references/usage.md. For PromQL help, read references/promql-reference.md. When debugging, read both references/debugging.md and references/promql-reference.md.