CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/logql-generator

Generate label matchers, line filters, log aggregations, and metric queries in LogQL (Loki Query Language) following current standards and conventions. Use this skill when creating new LogQL queries, implementing log analysis dashboards, alerting rules, or troubleshooting with Loki.

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 a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms users would actually use, explicitly states both what it does and when to use it, and has a clear distinctive niche around LogQL/Loki that minimizes conflict risk with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Generate label matchers, line filters, log aggregations, and metric queries' - these are distinct, technical capabilities that clearly describe what the skill does.

3 / 3

Completeness

Clearly answers both what ('Generate label matchers, line filters, log aggregations, and metric queries') AND when ('Use this skill when creating new LogQL queries, implementing log analysis dashboards, alerting rules, or troubleshooting with Loki').

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'LogQL', 'Loki Query Language', 'log analysis', 'dashboards', 'alerting rules', 'Loki', 'troubleshooting'. Good coverage of both the technology name and common use cases.

3 / 3

Distinctiveness Conflict Risk

Very clear niche focused specifically on LogQL/Loki - unlikely to conflict with other query languages or logging tools. The specific technology name (LogQL, Loki) creates strong distinctiveness.

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 strong, well-structured skill that excels in actionability and workflow clarity. The interactive planning workflow with explicit stages and validation checkpoints is particularly effective for complex query generation. Minor verbosity in the workflow description and some redundant emphasis on reference consultation prevent a perfect conciseness score, but overall the skill provides excellent guidance for LogQL query generation.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundancy (e.g., repeated emphasis on consulting references, verbose stage descriptions). The core query patterns section is well-condensed, but the workflow stages could be tightened.

2 / 3

Actionability

Excellent executable examples throughout - all LogQL queries are copy-paste ready with realistic patterns. The query patterns, advanced techniques, and alerting rules sections provide concrete, working code that Claude can immediately use.

3 / 3

Workflow Clarity

Clear 6-stage workflow with explicit validation checkpoints (Stage 4 plan confirmation, Stage 5a incremental building). The interactive planning approach with AskUserQuestion creates natural feedback loops, and the error handling table provides recovery guidance.

3 / 3

Progressive Disclosure

Well-structured with clear navigation to external references (common_queries.logql, best_practices.md, function_reference.md). The reference lookup table in Stage 4 provides excellent signposting, and content is appropriately split between overview and detailed reference files.

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/logql-generator

Reviewed

Table of Contents