promql-clilisted
Install: claude install-skill hssh8917/cc-skills
# 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, or saturation |
| `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`.
## Setup Check
Before running any query, verify that a host is configured:
```bash
promql 'up' # succeeds if host is reachable; fails with connection error if not configured
# or
promql --host xxx 'up'
```
Recognize these errors as a configuration/auth problem and refer to `references/installation.md`:
| Error | Cause |
| --- | --- |
| `dial tcp ... connection refused` | No host running at the configured