← Back to Skills Marketplace
137
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install prometheus-query
Description
Query Prometheus metrics, alerts, and cluster status using PromQL with options for direct URL or Kubernetes port-forward access.
Usage Guidance
This skill appears to do only Prometheus queries and requires no credentials. Before installing or running: (1) be aware that queries contact whatever prom_url you provide — only point it at trusted Prometheus endpoints; (2) if you use the Kubernetes port-forward option, you will need kubectl locally (the SKILL.md mentions this but the registry metadata didn't list kubectl); port-forwarding is performed by you in a terminal, not by the script; (3) review the included Python script if you want to confirm there are no additional network calls — it only calls Prometheus HTTP endpoints using urllib. If you do not run any port-forwarding and only point prom_url at trusted hosts, the footprint is minimal.
Capability Analysis
Type: OpenClaw Skill
Name: prometheus-query
Version: 1.0.0
The skill bundle provides a legitimate utility for querying Prometheus metrics and alerts via a Python script (scripts/query_prometheus.py). It uses standard Python libraries (urllib) to interact with the Prometheus API and contains no evidence of data exfiltration, malicious execution, or prompt injection. All instructions in SKILL.md are aligned with the stated purpose of monitoring system health and performance.
Capability Assessment
Purpose & Capability
Name/description match the included script and SKILL.md: all functionality is Prometheus API queries and alerts. One minor mismatch: SKILL.md documents a Kubernetes port-forward workflow (which requires kubectl), but the registry metadata lists no required binaries.
Instruction Scope
SKILL.md limits actions to querying Prometheus (direct URL or via a user-run kubectl port-forward). The instructions do not ask the agent to read unrelated files, system secrets, or send data to other endpoints beyond the user-specified prom_url.
Install Mechanism
Instruction-only skill with a simple Python script; there is no install spec or network download. The script uses only the Python standard library (urllib, json).
Credentials
No environment variables, secrets, or config paths are requested. The script requires only a Prometheus URL (prom_url) provided by the user at runtime.
Persistence & Privilege
Skill is not always-enabled and does not request elevated or persistent privileges; it does not modify other skills or system configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install prometheus-query - After installation, invoke the skill by name or use
/prometheus-query - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Major refactor: Migrated from Node.js CLI-based implementation to a single Python script for querying Prometheus.
- Added scripts/query_prometheus.py as the new entry point; previous Node.js-related files removed.
- SKILL.md rewritten for new workflow: focuses on direct Prometheus URL or Kubernetes port-forward for connectivity.
- CLI usage is now via Python, with support for querying metrics, alerts, and customizable parameters.
- Legacy support for multi-instance, config files, and Node.js CLI commands has been removed.
Metadata
Frequently Asked Questions
What is prometheus-query?
Query Prometheus metrics, alerts, and cluster status using PromQL with options for direct URL or Kubernetes port-forward access. It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.
How do I install prometheus-query?
Run "/install prometheus-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is prometheus-query free?
Yes, prometheus-query is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does prometheus-query support?
prometheus-query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created prometheus-query?
It is built and maintained by GoodAtMe (@peintune); the current version is v1.0.0.
More Skills