promql-generator

Generate PromQL queries with Prometheus best practices and validation.

290|32|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/akin-ozer/cc-devops-skills --skill promql-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promql-generator
Source: https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/promql-generator
Command: npx skills add https://github.com/akin-ozer/cc-devops-skills --skill promql-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps DevOps engineers and SREs generate correct, efficient PromQL queries that follow Prometheus best practices, enabling reliable dashboards, alerts, and SLO monitoring.

Core Features & Use Cases

  • Guided planning: Engage in an interactive planning process before generating queries to ensure alignment with goals.
  • Pattern templates: Leverages RED and USE patterns, histogram_quantile workflows, and common PromQL practices.
  • Validation & references: Validates queries with built-in references and produces explanations, ready for dashboards and alerts.

Quick Start

Provide a PromQL request with goal, metric, and time window, and the skill will generate and validate a query plan and the final PromQL expression.

Frequently Asked Questions about promql-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write production-ready PromQL queries for Prometheus dashboards?

Production-ready PromQL queries require proper label filtering, correct aggregations, and histogram_quantile usage with rate on bucketed metrics. Following these Prometheus best practices ensures reliable dashboard visualizations and accurate SLO monitoring across distributed systems.

What is the correct way to use histogram_quantile with rate for monitoring latency?

Using histogram_quantile with rate for latency monitoring requires applying the rate function to bucketed metrics first. This Prometheus best-practice workflow ensures accurate percentile calculations and reliable SLO tracking across distributed systems.

Can I generate PromQL alerts using RED and USE patterns for distributed systems?

Yes, generating PromQL alerts using RED and USE pattern templates is fully supported for distributed systems. These common patterns produce validated query expressions with documented references, ready for immediate deployment in alerting and SLO monitoring configurations.

How do I validate PromQL queries before adding them to alerts?

To validate PromQL queries before adding them to alerts, check them against built-in references and Prometheus best practices. The skill validates generated expressions and produces explanations, ensuring proper aggregations and label filtering are present for reliable alerting rules.

What do I need to provide to generate a PromQL expression for SLO monitoring?

To generate a PromQL expression for SLO monitoring, provide a request containing your monitoring goal, the specific metric, and the time window. The skill uses these inputs in an interactive planning process to align with your objectives before generating the validated query.