← Back to Skills Marketplace
Promql Cli
by
Samuel Berthe
· GitHub ↗
· v1.1.2
· MIT-0
181
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install promql-cli
Description
CLI for querying Prometheus and PromQL-compatible engines (Thanos, Cortex, VictoriaMetrics, Grafana Mimir, Grafana Tempo...) — instant queries, range queries...
Usage Guidance
This skill appears to do what it claims: it's a wrapper around the promql CLI and uses jq for output parsing. Before installing, verify you trust the upstream Go package (github.com/nalbury/promql-cli) by inspecting its repository or release page. Ensure you have promql and jq on PATH (or allow the go install / brew steps), and do not paste Prometheus tokens or passwords into chat — follow the SKILL.md guidance to create and protect `~/.promql-cli.yaml`/`~/.promql_token` yourself (chmod 600). Note: SKILL.md references additional local `references/*` docs that are not included in the package; if you need those, fetch the upstream docs or ask the skill maintainer.
Capability Analysis
Type: OpenClaw Skill
Name: promql-cli
Version: 1.1.2
The promql-cli skill is a legitimate wrapper for the Prometheus CLI tool. It includes security-conscious instructions in SKILL.md that explicitly forbid the AI agent from creating configuration files containing credentials, advising the user to handle them manually instead. The tool permissions are appropriately restricted to the 'promql' command.
Capability Assessment
Purpose & Capability
The name/description match the declared requirements: promql (the CLI) and jq (output processing) are exactly what a Prometheus/PromQL CLI skill needs. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md provides clear, scoped runtime instructions (how to run queries, error handling, and explicit guidance not to create config files on behalf of users). One minor inconsistency: SKILL.md references several `references/*` files (installation, usage, debugging, etc.) but the package manifest contains only SKILL.md — those reference files are not present in the bundle. This may mean the agent will not be able to read those local reference files and should instead link to upstream docs or ask the user.
Install Mechanism
Install spec uses `go` to build github.com/nalbury/promql-cli (source-built Go package) and `brew` to install jq. Both are standard, traceable mechanisms; no arbitrary downloads or obscure URLs are present.
Credentials
The skill requests no environment variables or credentials. It properly warns about storing tokens in `~/.promql-cli.yaml`/`~/.promql_token` and explicitly instructs the agent not to create or transmit those config files or secrets.
Persistence & Privilege
The skill does not request permanent presence (always: false) and does not attempt to modify other skills or global agent settings. `disable-model-invocation` is false (normal), meaning the agent could call the skill autonomously — this is expected for a usable skill and not problematic here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install promql-cli - After installation, invoke the skill by name or use
/promql-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.2
No changes detected in this release.
- Version update only; no file or documentation changes.
- All existing features and behaviors remain unchanged.
v1.1.1
- Removed all bundled reference and example files from the skill.
- Internal documentation and usage guidance dependent on those files is now unavailable within the skill.
- No changes to code functionality or user interface.
v1.1.0
Version 1.1.0
- Updated SKILL.md to include Openclaw metadata for improved installation and usage details.
- Added explicit instructions for required binaries and installation steps.
- Included new evals/evals.json file.
- Bumped metadata version from 1.0.0 to 1.1.0.
v1.0.0
promql-cli v1.0.0 – Initial release
- Introduces a CLI skill for querying Prometheus and compatible engines (Thanos, Cortex, VictoriaMetrics, Grafana Mimir/Tempo).
- Supports instant and range queries, metric discovery, and multiple output formats (table, CSV, JSON, ASCII graph).
- Includes guided setup checks, configuration troubleshooting, and security best practices (no credential handling by skill).
- Provides practical PromQL usage principles for effective queries and troubleshooting.
- Reference files organize installation, usage, debugging, graphing, and PromQL fundamentals for easy lookup.
Metadata
Frequently Asked Questions
What is Promql Cli?
CLI for querying Prometheus and PromQL-compatible engines (Thanos, Cortex, VictoriaMetrics, Grafana Mimir, Grafana Tempo...) — instant queries, range queries... It is an AI Agent Skill for Claude Code / OpenClaw, with 181 downloads so far.
How do I install Promql Cli?
Run "/install promql-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Promql Cli free?
Yes, Promql Cli is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Promql Cli support?
Promql Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Promql Cli?
It is built and maintained by Samuel Berthe (@samber); the current version is v1.1.2.
More Skills