CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

elasticsearch-esql

Use this skill when writing or debugging ES|QL queries for Elasticsearch. Activate when the user asks to query logs, metrics, traces, or any Elasticsearch data using ES|QL syntax.

86

1.20x
Quality

84%

Does it follow best practices?

Impact

94%

1.20x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

An efficient, highly actionable reference for ES|QL query authoring: every pattern is executable, the CLI command is concrete, and the tips encode practical safety defaults. The only weaknesses are minor — a slightly redundant intro sentence, no error-recovery/iteration guidance, and function lists that would belong in a separate reference file if the skill expands.

DimensionReasoningScore

Conciseness

The body is a lean, example-driven reference with compact function lists and no padding; the one-sentence intro ("ES|QL (Elasticsearch Query Language) is a piped query language...") is a minor instance of over-explanation that could be trimmed. Not 5 because of that intro and the generic syntax skeleton.

4 / 5

Actionability

Fully executable, copy-paste-ready queries throughout, plus the concrete CLI invocation `elastic es query 'FROM logs-* | WHERE @timestamp > NOW() - 1 HOUR | LIMIT 10'`. The common patterns cover the main cases: time filtering, counting, percentiles, time bucketing, and multi-field filtering with KEEP/SORT/LIMIT.

5 / 5

Workflow Clarity

A single-task skill with an unambiguous action (compose a query from the patterns, run it via the CLI), and the tips section encodes safe defaults (time range, LIMIT). Not 5 because there is no sequencing/validation guidance for iterating when a query errors or returns unexpected results, and not below 4 since queries are read-only so no destructive-operation validation cap applies.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~90-line body is well-sectioned and self-contained with easy navigation (Syntax, Running Queries, Common Patterns, function lists, Tips). Not 5 because the Type/Aggregation function reference and pattern library could plausibly live in separate reference files if the skill grows, but at current size keeping them inline is appropriate.

4 / 5

Total

17

/

20

Passed

Description

78%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 explicit what-and-when structure and good natural trigger terms. Its main weaknesses are limited enumeration of concrete capabilities (only writing and debugging) and slight over-broadening ("any Elasticsearch data") that risks overlap with non-ES|QL Elasticsearch query skills.

Suggestions

Enumerate more concrete capabilities to lift specificity, e.g. "write, debug, and optimize ES|QL queries for filtering, transforming, and aggregating data".

Tighten the trigger scope from "any Elasticsearch data using ES|QL syntax" to explicitly ES|QL contexts and add natural synonyms users say, such as Kibana, ELK, or observability data, to sharpen distinctiveness and trigger coverage.

Keep the existing 'Use this skill when...' + 'Activate when...' pattern; it is the strongest part of the description.

DimensionReasoningScore

Specificity

"writing or debugging ES|QL queries for Elasticsearch" names the domain with two concrete actions, matching the '1-2 concrete actions' anchor; the broader querying capability set (filtering, aggregating, transforming) is only implied. Not 4 because it does not list several distinct specific actions.

3 / 5

Completeness

It explicitly answers both what ("writing or debugging ES|QL queries for Elasticsearch") and when ("Activate when the user asks to query logs, metrics, traces, or any Elasticsearch data using ES|QL syntax") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Natural phrases like "query logs, metrics, traces", "ES|QL", and "Elasticsearch" give good coverage of what users would say. Not 5 because common synonyms and related natural terms (e.g., Kibana, ELK, observability, dashboards) are missing.

4 / 5

Distinctiveness Conflict Risk

ES|QL is a clear niche with distinct triggers, but the phrase "any Elasticsearch data" broadens it into overlap with a generic Elasticsearch/DSL querying skill. Mostly distinct with minor overlap risk, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

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

elastic/elastic-ramen

Path

packages/opencode/src/elastic/skills/elasticsearch-esql/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.