CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

promql-generator

Generate PromQL queries for calculating error rates, aggregating metrics across labels, creating histogram percentiles, writing recording rules, and building SLO burn-rate alerts following Prometheus best practices. Use when creating new PromQL queries, implementing monitoring and alerting rules, building observability dashboards, working with Prometheus metrics (counters, gauges, histograms, summaries), or applying RED (Rate, Errors, Duration) and USE (Utilization, Saturation, Errors) monitoring patterns.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered skill body with fully executable guidance, a sequenced workflow containing a real validation feedback loop, and clean one-level-deep navigation into an 11-file bundle. The main weakness is redundancy: roughly half the Anti-Patterns section re-states the body's own Key Rules or re-inlines content already present in references/best_practices.md.

Suggestions

Cut the Anti-Patterns section to the 3–4 entries unique to SKILL.md (e.g. multi-window ratio mixing, irate for alerting) and route the rest to references/best_practices.md's Common Anti-Patterns section, which already covers regex-vs-exact, rate() on gauges, averaging quantiles, and high-cardinality aggregation.

Drop the anti-patterns that restate the body's own Key Rules or workflow stages — 'never use a regex matcher' (Key Rule 4), 'never omit the for clause' (Core Patterns), 'never write before the user has confirmed the plan' (stage 4), and 'never deliver without validating' (stage 6) — since the rules are already stated where they are applied.

Tighten each WHY paragraph to a single clause; the BAD/GOOD pair already conveys the rule, so the explanation only needs the reason the BAD query misbehaves.

DimensionReasoningScore

Conciseness

Mostly efficient — dense PromQL specifics, no beginner-concept padding — but the 12-entry Anti-Patterns section (~90 lines) duplicates material twice over: entries like 'NEVER use a regex matcher when the label value is known', 'NEVER omit the for clause', and 'NEVER express an error rate as a raw count' restate the body's own Key Rules 1–5, while rate()-on-gauge, averaging-quantiles, and high-cardinality entries already exist in references/best_practices.md's 'Common Anti-Patterns' section. Not 4 because this goes beyond minor trimming, and not 2 because nothing is padded fluff — every entry is domain-specific.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready PromQL patterns (request rate, error ratio, P95 for classic and native histograms, multi-window burn rate), concrete commands ('promtool check rules assets/alerting_rules.yaml', the curl query example, 'grep -n "^# " assets/common_queries.promql'), a YAML alerting/recording snippet, and a scenario→reference routing table. Not 4 because common cases are covered with no gaps — the examples are complete queries, not pseudocode.

5 / 5

Workflow Clarity

The 7-stage workflow is clearly sequenced with an explicit validation feedback loop at stage 6 ('Fix any issues and re-validate until all checks pass'), a structured Validation Checklist output format, a follow-up 'Verifying Generated Rules' section with promtool commands, and an 'Ask vs. Infer' note plus stage-3 pre-filled defaults that prevent needless back-and-forth. This matches the 5-anchor validate→fix→retry pattern.

5 / 5

Progressive Disclosure

Good structure: a scenario→reference routing table, a References section annotating all 11 bundle files, all referenced paths verified to exist, and references confirmed one level deep (intra-file TOCs plus one sibling cross-link, no nesting). Not 5 because the large inline Anti-Patterns block is content that largely belongs in references/best_practices.md, which already covers the same anti-patterns — the body should point there rather than re-inline it.

4 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with concrete, comprehensive capability statements and an explicit multi-trigger 'Use when' clause in correct third-person voice. The only weakness is a handful of missing natural synonyms (latency, availability, file extensions) that keeps trigger coverage just short of comprehensive.

DimensionReasoningScore

Specificity

The description lists five concrete, domain-qualified actions — 'calculating error rates, aggregating metrics across labels, creating histogram percentiles, writing recording rules, and building SLO burn-rate alerts' — which comprehensively covers the query-generation niche. Not 4 because there are no meaningful coverage gaps within the stated scope (validation is deliberately excluded as a separate skill's job).

5 / 5

Completeness

Explicitly answers both questions with concrete trigger phrases: the first sentence states exactly what the skill does, and 'Use when creating new PromQL queries, implementing monitoring and alerting rules, building observability dashboards...' states when with five distinct triggers. This mirrors the rubric's 5-anchor example structure.

5 / 5

Trigger Term Quality

Strong natural triggers users would actually say: 'PromQL queries', 'error rates', 'recording rules', 'SLO burn-rate alerts', 'monitoring and alerting rules', 'observability dashboards', 'counters, gauges, histograms, summaries', 'RED... and USE... monitoring patterns'. Not 5 because a few common phrasings are absent — 'latency'/'availability' queries, file extensions like .promql/.yaml, and 'promtool' are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — PromQL generation for Prometheus — with distinct triggers that separate it from the sibling validator skill, and the body's 'When Not to Use' section reinforces the boundary. Not 5 because 'building observability dashboards' is a broad phrase that could overlap with a general dashboarding skill.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pantheon-org/tekhne

Path

skills/observability/promql/generator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.