Promql Generator

This is a properly opinionated take on PromQL generation. Instead of just spitting out queries, it walks you through an interactive planning workflow: understand what you're monitoring, identify your metrics and labels, set parameters like time ranges and thresholds, then present a plain-English plan before writing any code. It's designed to catch the common mistakes (like using rate() on gauges or averaging quantiles) and ensure the query actually matches what you need. If you're building Grafana dashboards or Prometheus alerts and want to avoid the typical trial-and-error cycle of PromQL, this handles the thinking part before the syntax part. The workflow might feel slow if you just want a quick query, but that's the point.

skills.sh installs: 656
GitHub stars: 337
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add akin-ozer/cc-devops-skills --skill promql-generator --agent claude-code

Installs into .claude/skills of the current project.

Files

PromQL Query Generator

Overview

This skill provides a comprehensive, interactive workflow for generating production-ready PromQL queries with best practices built-in. Generate queries for monitoring dashboards, alerting rules, and ad-hoc analysis with an emphasis on user collaboration and planning before code generation.

When to Use This Skill

Invoke this skill when:

Creating new PromQL queries from scratch
Building monitoring dashboards (Grafana, Prometheus UI, etc.)
Implementing alerting rules for Prometheus Alertmanager
Analyzing metrics for troubleshooting or capacity planning
Converting monitoring requirements into PromQL expressions
Learning PromQL or teaching others
The user asks to "create", "generate", "build", or "write" PromQL queries
Working with Prometheus metrics (counters, gauges, histograms, summaries)
Implementing RED (Rate, Errors, Duration) or USE (Utilization, Saturation, Errors) metrics

Interactive Query Planning Workflow

CRITICAL: This skill emphasizes interactive planning before query generation. Always engage the user in a collaborative planning process to ensure the generated query matches their exact intentions.

SKILL.md on GitHub