Skip to content

Commit 7168367

Browse files
committed
✨ feat(handbook-elasticsearch): add Elasticsearch and Kibana REST API skill
New plugin with curl-based skill for Elasticsearch interaction: search (Query DSL), CRUD, aggregations, index management, cluster health, ILM, ES|QL, Kibana dashboards, and OpenTelemetry data patterns. Based on davidgeorgehope/elasticsearch-skill.
1 parent 946ffd6 commit 7168367

File tree

17 files changed

+2891
-0
lines changed

17 files changed

+2891
-0
lines changed

.claude-plugin/marketplace.json

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -288,6 +288,30 @@
288288
],
289289
"homepage": "https://nikiforovall.blog/claude-code-rules/",
290290
"strict": true
291+
},
292+
{
293+
"name": "handbook-elasticsearch",
294+
"version": "1.19.5",
295+
"description": "Elasticsearch and Kibana REST API expertise for querying, indexing, managing indices, cluster health, aggregations, ES|QL, and dashboard deployment",
296+
"author": {
297+
"name": "nikiforovall",
298+
"url": "https://github.com/nikiforovall"
299+
},
300+
"source": "./plugins/handbook-elasticsearch",
301+
"category": "development",
302+
"tags": [
303+
"elasticsearch",
304+
"kibana",
305+
"search",
306+
"aggregations",
307+
"observability",
308+
"otel",
309+
"opentelemetry",
310+
"esql",
311+
"rest-api"
312+
],
313+
"homepage": "https://nikiforovall.blog/claude-code-rules/",
314+
"strict": true
291315
}
292316
]
293317
}
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
{
2+
"name": "handbook-elasticsearch",
3+
"version": "1.19.5",
4+
"description": "Elasticsearch and Kibana REST API expertise for querying, indexing, managing indices, cluster health, aggregations, ES|QL, and dashboard deployment",
5+
"author": {
6+
"name": "nikiforovall",
7+
"url": "https://github.com/nikiforovall"
8+
},
9+
"homepage": "https://nikiforovall.blog/claude-code-rules/",
10+
"repository": "https://github.com/nikiforovall/claude-code-rules",
11+
"license": "MIT",
12+
"keywords": [
13+
"elasticsearch",
14+
"kibana",
15+
"search",
16+
"aggregations",
17+
"observability",
18+
"otel",
19+
"opentelemetry",
20+
"esql",
21+
"rest-api"
22+
],
23+
"skills": [
24+
"./skills/elasticsearch"
25+
]
26+
}
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# handbook-elasticsearch
2+
3+
Elasticsearch and Kibana REST API skill for Claude Code. Teaches Claude how to interact with Elasticsearch clusters via `curl` — no SDK, no MCP server, just markdown.
4+
5+
## What's Included
6+
7+
| File | Coverage |
8+
|------|----------|
9+
| `SKILL.md` | Auth, search, CRUD, bulk ops, index management, cluster health, ILM, ES\|QL, ingest pipelines |
10+
| `references/query-dsl.md` | Full Query DSL — bool, match, term, range, nested, geo, wildcards, runtime fields |
11+
| `references/aggregations.md` | Metric, bucket, and pipeline aggregations — SRE patterns (error rates, top-N) |
12+
| `references/aggregations-api.md` | Aggregation API patterns with composite pagination |
13+
| `references/search-api.md` | Search endpoint, ES\|QL, EQL, pagination (PIT + search_after) |
14+
| `references/document-api.md` | CRUD, bulk API, delete/update by query |
15+
| `references/index-api.md` | Index create/delete, reindex, aliases, ILM, shrink/split, rollover |
16+
| `references/cluster-api.md` | Cluster health, node stats, shard allocation, cat APIs |
17+
| `references/mapping-api.md` | Field types, dynamic mapping/templates, runtime fields |
18+
| `references/kibana-api.md` | Data views, dashboards, saved objects, programmatic Lens panels, alerting |
19+
| `references/otel-data.md` | OpenTelemetry logs/traces/metrics querying, trace-log correlation |
20+
21+
## Configuration
22+
23+
Set cluster credentials as environment variables:
24+
25+
```bash
26+
export ES_URL="https://your-cluster.es.cloud.elastic.co:443"
27+
export ES_API_KEY="your-base64-api-key"
28+
29+
# Optional, for Kibana API access:
30+
export KIBANA_URL="https://your-cluster.kb.cloud.elastic.co:443"
31+
```
32+
33+
## Credits
34+
35+
Based on [davidgeorgehope/elasticsearch-skill](https://github.com/davidgeorgehope/elasticsearch-skill).

0 commit comments

Comments
 (0)