Skip to content

Add elastic4s AI Agent skill#3950

Open
maurin-at-homiwoo wants to merge 1 commit into
Philippus:series/9.xfrom
maurin-at-homiwoo:series/9.x
Open

Add elastic4s AI Agent skill#3950
maurin-at-homiwoo wants to merge 1 commit into
Philippus:series/9.xfrom
maurin-at-homiwoo:series/9.x

Conversation

@maurin-at-homiwoo

Copy link
Copy Markdown

Hello,

First, thanks a lot for your work on this library, we use it a lot at homiwoo, and we are quite happy to see that someone has been able to continue the work of sksamuel ! :)

I start using Claude Code recently and it struggle a lot with elastic4s as it cannot access easily the source code (it needs to unzip the jar on every request related to elastic4s and it is quite long to understand how things are working). So I cloned the repo and I asked it to create a skill folder for elastic4s.

I will complete it over time if I see that some part are missing, but I have the feeling that it's a good start (at least it should help a lot with query writing).

It could gain a lot from being used with the MCP/skill for elasticsearch (to allow index discovery as knowing the mapping of indices helps a lot to know what query to write), but we haven't experimented with that at homiwoo yet (we actually don't want our agents to query directly our elastic instances).

I also added a zip file to make it easy for users to simply download the skill without cloning the repo.

The content of the skill has been written by Claude Code (Sonnet 4.6), I've proofread it but I'm not an expert user of elastic4s :P

Add elastic4s Claude Code skill

Complete DSL reference for elastic4s in agent-skill/elastic4s/:

  • SKILL.md: entry point with query, SearchRequest and result cheat sheets
  • client.md: client backends (JavaClient, Pekko, Sttp, http4s, ZIO), auth, effects, handlers
  • queries.md: full query DSL (full-text, term-level, compound, geo, joining, specialised, span)
  • search-request.md: all SearchRequest options incl. sorts, highlights, KNN, collapse, rescore
  • aggregations.md: metric, bucket and pipeline aggregations with result extraction
  • results.md: SearchResponse, SearchHit, HitReader (Jackson/Circe/manual), all agg result types
  • pagination.md: from/size, scroll, SearchIterator, search-after, PIT lifecycle
  • examples.md: 18 complete compilable examples
  • index-management.md: createIndex, field types, putMapping, indexInto, updateById, deleteById, deleteByQuery
  • debugging.md: explain, validate, analyze, profile, CAT APIs, query JSON dump
  • COMMIT: baseline commit hash reference
  • UPDATING.md: guide for updating the skill via git diff

  Complete DSL reference for elastic4s in agent-skill/elastic4s/:
  - SKILL.md: entry point with query, SearchRequest and result cheat sheets
  - client.md: client backends (JavaClient, Pekko, Sttp, http4s, ZIO), auth, effects, handlers
  - queries.md: full query DSL (full-text, term-level, compound, geo, joining, specialised, span)
  - search-request.md: all SearchRequest options incl. sorts, highlights, KNN, collapse, rescore
  - aggregations.md: metric, bucket and pipeline aggregations with result extraction
  - results.md: SearchResponse, SearchHit, HitReader (Jackson/Circe/manual), all agg result types
  - pagination.md: from/size, scroll, SearchIterator, search-after, PIT lifecycle
  - examples.md: 18 complete compilable examples
  - index-management.md: createIndex, field types, putMapping, indexInto, updateById, deleteById, deleteByQuery
  - debugging.md: explain, validate, analyze, profile, CAT APIs, query JSON dump
  - COMMIT: baseline commit hash reference
  - UPDATING.md: guide for updating the skill via git diff

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant