elastic avatar

Elasticsearch Esql

This connects Claude to Elasticsearch's ES|QL query language, the piped syntax that replaced the old JSON DSL. It auto-detects whether you're on Serverless or a versioned cluster, pulls index schemas so you never guess field names, and handles the quirks like time series indices requiring TS syntax instead of FROM. Useful for log analysis, metrics aggregation, and exploratory queries when you want natural language over manual query construction. The skill knows about version-specific features like MATCH for full-text search and LOOKUP JOIN for enrichment, falling back gracefully on older clusters. Ships with detailed references on time series queries and search strategies if you need to understand what it's generating.

skills.sh installs
5.2K
GitHub stars
604
last updated
Aug 21, 2026

Install

$ npx -y skills add elastic/agent-skills --skill elasticsearch-esql --agent claude-code

Installs into .claude/skills of the current project.

Files

Elasticsearch ES|QL

Execute ES|QL queries against Elasticsearch: discover the schema, choose the right ES|QL feature for the task, generate the simplest correct query, and run it.

Environment Configuration

This skill executes Elasticsearch operations through the elastic CLI. If the elastic CLI is not installed, tell the user what it is needed for. Do not guess credentials, call the HTTP API directly, or attempt other workarounds.

This skill references operations in HTTP-shorthand form (e.g., GET /, GET /_cat/indices, GET /{index}/_mapping, GET /{index}/_settings/index.mode, POST /_query). The Operations table at the end of this document maps each shorthand to the equivalent elastic CLI command — always use the CLI rather than calling the HTTP API directly.

What is ES|QL?

ES|QL (Elasticsearch Query Language) is a piped query language for Elasticsearch. It is NOT the same as:

  • Elasticsearch Query DSL (JSON-based)
  • SQL
  • EQL (Event Query Language)

Sponsors

Details

Repository
github.com/elastic/agent-skills
Categories
AI & Agent Building, Databases
First seen
Apr 16, 2026

More from elastic/agent-skills

All 57
1openai avatarskill-creatoropenai/skillsGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabili5.1Kskills.sh installs
2gokapso avatarintegrate-whatsappgokapso/agent-skillsConnect WhatsApp to your product with Kapso: onboard customers with setup links, detect connections, receive events via webhooks, and send messages/templates/me5.1Kskills.sh installs
3hashicorp avatarterraform-search-importhashicorp/agent-skillsDiscover existing cloud resources using Terraform Search queries and bulk import them into Terraform management. Use when bringing unmanaged infrastructure unde5.1Kskills.sh installs
4wordpress avatarwp-playgroundwordpress/agent-skillsUse as the WordPress Playground routing wrapper for ambiguous Playground work, local CLI runs with @wp-playground/cli, playground.wordpress.net share links, bro5.1Kskills.sh installs
5sanity-io avatarcontent-modeling-best-practicessanity-io/agent-toolkitStructured content modeling guidance for schema design, content architecture, content reuse, references versus embedded objects, separation of concerns, and tax5Kskills.sh installs
6medusajs avatarstorefront-best-practicesmedusajs/medusa-agent-skillsALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, pay5Kskills.sh installs