← Explore all 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.

“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.”

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.

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 ↗

DOCUMENTED COMMAND

npx skills add elastic/agent-skills --skill elasticsearch-esql

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.

  1. The README's per-skill example is the command above.
  2. The same README also shows npx skills add elastic/agent-skills for an interactive selection.
  3. 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

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md

    Supports: CLI boundary, serverless version rule, and feature fallbacks

  2. Repository README ↗Checked

    https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md

    Supports: per-skill install line

  3. Repository LICENSE ↗Checked

    https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/LICENSE

    Supports: Apache License Version 2.0

  4. https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

  5. https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md

    Supports: install.command

Evidence & Ask