---
title: "Elasticsearch ES|QL: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/elastic-esql/
description: "Pins Elastic's ES|QL skill, which routes queries through the elastic CLI and refuses to treat a Serverless build number as a feature gate."
---

# Elasticsearch ES|QL: review, setup & limitations · Undominated.ai

> Pins Elastic's ES|QL skill, which routes queries through the elastic CLI and refuses to treat a Serverless build number as a feature gate.

[← Explore all skills](/skills/)

OBSERVABILITY / Elastic

# Elasticsearch ES|QL

Pins Elastic's ES|QL skill, which routes queries through the elastic CLI and refuses to treat a Serverless build number as a feature gate.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/elastic/agent-skills/tree/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 5 linked sources
 Publisher Elastic
 Licence [Apache-2.0 ↗](https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/LICENSE)
 Revision baa511126ba2
 [Read what was—and wasn’t—checked ↓](#review)

“Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results.”

 [Elastic · upstream description ↗](https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The catalogue has Elastic's LLM observability skill and not this ES|QL skill from the same repository.
- The file draws a hard line between ES|QL, Query DSL, SQL, and EQL, and it says not to guess index or field names.

### A good fit for

 - Writing an ES|QL query after the elastic CLI has reported build_flavor and the target index mapping

### Weigh up before choosing

 - This review did not execute the resource.
- Version gates such as LOOKUP JOIN at 8.18 and no INLINE STATS fallback before 9.2 are sentences in the skill. The version-history reference and a live cluster were not checked.
- The skill says ES|QL requires _source. That was not tested against an index with _source disabled.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/elasticsearch/elasticsearch-esql/SKILL.md
- README.md
- LICENSE

### Our findings

 - The skill says to use the elastic CLI and not to guess credentials or call the HTTP API directly when the CLI is missing.
- It says a serverless build_flavor means the agent must not use version.number to gate ES|QL features.
- It says INLINE STATS and counter-field RATE have no fallback before 9.2, and that the quick-reference section omits version annotations on purpose.

### Not established by this review

 - The resource was not executed and its tools were not called.
- The elastic CLI was not run.
- No Elasticsearch query was sent.
- references/esql-version-history.md was not opened.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md)

DOCUMENTED COMMAND

 npx skills add elastic/agent-skills --skill elasticsearch-esql Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 - The README's per-skill example is the command above.
- The same README also shows npx skills add elastic/agent-skills for an interactive selection.
- The skill itself requires the elastic CLI at 0.2 or newer with stack es support, which this review did not install.

### Before you start

 - A skills-compatible agent
- The elastic CLI if the skill's commands are followed
- A reachable Elasticsearch deployment, which this review did not use

### Compatibility

Claude Code · Cursor · GitHub Copilot · Windsurf · Gemini CLI · skills CLI

### Implementation

esql

### Skill text plus an operator-configured elastic CLI

 - Read the skill
- Run elastic es commands only if the operator has configured the CLI
- Query indices the CLI's credentials can read

### Cost model

Apache-2.0; no Elasticsearch request was made

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [elasticsearch-esql SKILL.md ↗](https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md) Checked 2026-10-14 https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md Supports: CLI boundary, serverless version rule, and feature fallbacks
- [Repository README ↗](https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md) Checked 2026-10-14 https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md Supports: per-skill install line
- [Repository LICENSE ↗](https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/LICENSE) Checked 2026-10-14 https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/LICENSE Supports: Apache License Version 2.0
- [2026-10-15 C2-W38 source re-review at the existing pin ↗](https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md Supports: upstreamDescription, review.notTested, review.reviewedAt
- [2026-10-15 C2-W38 source re-review at the existing pin ↗](https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md) Checked 2026-10-15 https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md Supports: install.command

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Elasticsearch Cluster Health ↗ Triage unassigned Elasticsearch shards through allocation evidence.](/skills/elastic-elasticsearch-cluster-health/)[### Grafana App Admission Control ↗ Implement validators and mutators for Grafana app resources before persistence.](/skills/grafana-admission-control/)[### Grafana App Reconciler Logic ↗ Implement scoped resource reconciliation and status updates with explicit event and finalizer behavior.](/skills/grafana-reconciler-logic/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
