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.
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.
- 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
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
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 ↗Checked
https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md
Supports: per-skill install line
- Repository LICENSE ↗Checked
https://github.com/elastic/agent-skills/blob/baa511126ba2dc37b52e273b52734f8e4e0d323c/LICENSE
Supports: Apache License Version 2.0
https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/skills/elasticsearch/elasticsearch-esql/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt
https://raw.githubusercontent.com/elastic/agent-skills/baa511126ba2dc37b52e273b52734f8e4e0d323c/README.md
Supports: install.command