CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/promql-validator

Comprehensive toolkit for validating, optimizing, and understanding Prometheus Query Language (PromQL) queries. Use this skill when working with PromQL queries to check syntax, detect anti-patterns, identify optimization opportunities, and interactively plan queries with users.

Overall
score

93%

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

Discovery

100%

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

This is an excellent skill description that hits all the key criteria. It provides specific concrete actions, includes comprehensive trigger terms that users would naturally use, explicitly states both what the skill does and when to use it, and carves out a distinct niche in the Prometheus/PromQL domain that won't conflict with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'validating, optimizing, and understanding', 'check syntax, detect anti-patterns, identify optimization opportunities, and interactively plan queries'. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('validating, optimizing, understanding PromQL queries, check syntax, detect anti-patterns, identify optimization opportunities, interactively plan queries') AND when ('Use this skill when working with PromQL queries, prometheus queries, metrics queries, alerting rules, recording rules, or grafana dashboards').

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'PromQL queries', 'prometheus queries', 'metrics queries', 'alerting rules', 'recording rules', 'grafana dashboards'. These are terms users naturally use when working in this domain.

3 / 3

Distinctiveness Conflict Risk

Very clear niche focused specifically on PromQL/Prometheus ecosystem. The specific mention of PromQL, Prometheus, alerting rules, recording rules, and Grafana dashboards creates distinct triggers unlikely to conflict with general coding or other query language skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a well-structured skill with excellent workflow clarity and progressive disclosure. The two-phase interactive workflow with explicit checkpoints is particularly strong. The main weakness is some verbosity in explanatory sections that could be tightened without losing clarity.

Suggestions

Condense the 'Known Limitations' section - Claude can infer many of these caveats; focus only on non-obvious limitations

Shorten the 'Interactive Dialogue' example to a single exchange rather than three turns

DimensionReasoningScore

Conciseness

The content is reasonably efficient but includes some unnecessary explanation (e.g., the interactive dialogue example could be shorter, and some sections like 'Known Limitations' are verbose). The workflow steps are clear but could be tightened.

2 / 3

Actionability

Provides fully executable bash commands for validation scripts, specific citation formats, concrete example dialogue, and clear step-by-step instructions. The commands are copy-paste ready with proper paths.

3 / 3

Workflow Clarity

Excellent workflow structure with explicit two-phase approach, numbered steps, a clear STOP checkpoint between phases, and well-defined validation sequence. The feedback loop between user intent and query refinement is explicit.

3 / 3

Progressive Disclosure

Clear overview with well-organized reference materials section at the top, linking to separate files for best practices, anti-patterns, and examples. References are one level deep and clearly signaled with descriptive labels.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Install with Tessl CLI

npx tessl i pantheon-ai/promql-validator@0.2.1

Reviewed

Table of Contents