К основному содержанию
скилл CX Codex

elasticsearch-expert — скилл для Claude Code: обзор и установка

Скилл elasticsearch-expert помогает проектировать маппинги Elasticsearch, настраивать поисковые запросы, агрегации и оптимизировать работу ELK-стека.

Apache-2.0 205 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill elasticsearch-expert -a claude-code
Открыть на GitHub

Что делает elasticsearch-expert

Скилл содержит шаблоны и рекомендации по работе с Elasticsearch через официальный клиент на Python. Внутри собраны готовые структуры для создания индексов с явной типизацией полей, пакетной загрузки документов через bulk и построения поисковых запросов — от нечёткого поиска fuzzy до фильтрации через bool и ранжирования по нескольким полям с весами.

Здесь же описаны правила для аналитических выборок: агрегации по терминам, средним значениям и временным интервалам через date_histogram. Дополнительно зафиксированы антипаттерны вроде глубокой пагинации через from/size, овер-шардинга или шаблонных запросов wildcard без префикса.

Для проверки кода и запуска примеров скиллу требуется доступ к Bash с командами Python, pip и pytest.

Какие задачи решает

  • настроить маппинг индекса с подходящими анализаторами текста
  • составить поисковый запрос bool с фильтрами и мульти-матчем
  • построить аналитические агрегации по датам и числовым метрикам
  • заменить неэффективную пагинацию from/size на search_after

Примеры запросов агенту

  • Помоги составить поисковый запрос bool с фильтром по дате и ранжированием заголовка
  • Напиши скрипт на Python для пакетной загрузки статей через helpers.bulk
  • Спроектируй маппинг индекса Elasticsearch для каталога публикаций

Как установить elasticsearch-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill elasticsearch-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/elasticsearch-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/elasticsearch-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об elasticsearch-expert

Как установить elasticsearch-expert в Claude Code?

Выполните в терминале команду npx skills add personamanagmentlayer/pcl --skill elasticsearch-expert -a claude-code.

Что делает скилл elasticsearch-expert?

Он даёт ассистенту практические шаблоны для создания индексов, написания запросов поиска и агрегаций в Elasticsearch, а также предупреждает о частых ошибках вроде овер-шардинга.

Какие инструменты нужны для работы скилла?

Скилл использует стандартные операции чтения и редактирования файлов, а также Bash-команды для запуска python, python3, pip и pytest.

Исходный текст

SKILL.md · Apache-2.0
---
name: elasticsearch-expert
version: 2.0.0
description: >-
  Expert-level Elasticsearch, search, ELK stack, and full-text search. Use when the user
  mentions search, ELK, Logstash, Kibana, or full text search.
category: data
tags: [elasticsearch, search, elk, logstash, kibana, full-text-search]
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(python:*, python3:*, pip:*, pytest:*)
---

# Elasticsearch Expert

Expert guidance for Elasticsearch, search optimization, ELK stack, and distributed search systems.

## Core Concepts

- Full-text search and inverted indexes
- Document-oriented storage
- RESTful API
- Distributed architecture with sharding
- ELK stack (Elasticsearch, Logstash, Kibana)
- Aggregations and analytics

## Index Management

```python
from elasticsearch import Elasticsearch

es = Elasticsearch(['http://localhost:9200'])

# Create index with mapping
mapping = {
    "mappings": {
        "properties": {
            "title": {"type": "text", "analyzer": "english"},
            "content": {"type": "text"},
            "author": {"type": "keyword"},
            "created_at": {"type": "date"},
            "views": {"type": "integer"}
        }
    }
}

es.indices.create(index='articles', body=mapping)

# Index document
doc = {
    "title": "Elasticsearch Guide",
    "content": "Complete guide to Elasticsearch",
    "author": "John Doe",
    "created_at": "2024-01-01",
    "views": 100
}

es.index(index='articles', id=1, body=doc)

# Bulk indexing
from elasticsearch.helpers import bulk

actions = [
    {"_index": "articles", "_id": i, "_source": doc}
    for i, doc in enumerate(documents)
]

bulk(es, actions)
```

## Search Queries

```python
# Full-text search
query = {
    "query": {
        "match": {
            "content": "elasticsearch guide"
        }
    }
}

results = es.search(index='articles', body=query)

# Boolean query
bool_query = {
    "query": {
        "bool": {
            "must": [
                {"match": {"content": "elasticsearch"}}
            ],
            "filter": [
                {"range": {"views": {"gte": 100}}}
            ],
            "should": [
                {"term": {"author": "john-doe"}}
            ],
            "must_not": [
                {"term": {"status": "draft"}}
            ]
        }
    }
}

# Multi-match query
multi_match = {
    "query": {
        "multi_match": {
            "query": "elasticsearch guide",
            "fields": ["title^2", "content"],  # Boost title
            "type": "best_fields"
        }
    }
}

# Fuzzy search
fuzzy = {
    "query": {
        "fuzzy": {
            "title": {
                "value": "elasticseerch",
                "fuzziness": "AUTO"
            }
        }
    }
}
```

## Aggregations

```python
# Aggregation query
agg_query = {
    "aggs": {
        "authors": {
            "terms": {
                "field": "author",
                "size": 10
            }
        },
        "avg_views": {
            "avg": {
                "field": "views"
            }
        },
        "views_histogram": {
            "histogram": {
                "field": "views",
                "interval": 100
            }
        },
        "date_histogram": {
            "date_histogram": {
                "field": "created_at",
                "calendar_interval": "month"
            }
        }
    }
}

result = es.search(index='articles', body=agg_query)
```

## Best Practices

- Design mappings carefully
- Use appropriate analyzers
- Implement proper sharding strategy
- Monitor cluster health
- Use bulk operations
- Implement pagination with search_after
- Cache frequently used queries

## Anti-Patterns

❌ Deep pagination with from/size
❌ Wildcard queries without prefix
❌ No replica shards
❌ Over-sharding
❌ Not using filters for exact matches
❌ Ignoring cluster yellow/red status

## Resources

- Elasticsearch Guide: https://www.elastic.co/guide/
- ELK Stack: https://www.elastic.co/elk-stack

© personamanagmentlayer · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Данные и базы» →
elk-expert 0xfurai Субагент elk-expert помогает настраивать Elasticsearch, Logstash и Kibana: от обработки логов до мониторинга кластера. Подключайте его к задачам по ELK в Claude Code. CX Codex ★ 1 029звёзд репо elk-stack sanjeed5 Правило elk-stack задаёт формат логов для ELK: структурированный JSON, общую схему полей и корреляционные ID. Помогает настроить логирование для поиска событий в Elasticsearch и Kibana. CX Codex +1 ★ 3 589звёзд репо elasticsearch-query-optimization elastic Скилл elasticsearch-query-optimization диагностирует медленные запросы Query DSL через Search Profiling API и оптимизирует их. Помогает убрать ведущие wildcard и вынести фильтры из scoring-контекста. CX Codex +1 1 600установок elasticsearch-index-design elastic Скилл elasticsearch-index-design помогает агенту проектировать и проверять маппинги индексов Elasticsearch: типы полей, мультиполя, шарды. Пригодится при создании индекса или разборе чужого маппинга. CX Codex +1 1 600установок elasticsearch-best-practices Mindrally Скилл elasticsearch-best-practices снабжает ИИ-агента правилами проектирования индексов, настройки маппингов и ускорения поисковых запросов в Elasticsearch. CX Codex +1 1 000установок elasticsearch-mcp-server cr7258 Даёт агенту инструменты для работы с Elasticsearch и OpenSearch: поиск документов, просмотр индексов и управление кластером. Подходит для задач с данными из поискового хранилища. CX Codex +1 ★ 320звёзд репо

Из того же набора104

Весь набор →
spring-boot-expert Скилл spring-boot-expert помогает проектировать микросервисы, писать REST API на Spring Boot и настраивать работу с базами через Spring Data JPA. CX Codex +1 212установок devops-expert Скилл devops-expert даёт агенту готовые схемы CI/CD, инфраструктуры как кода и стратегий выкладки, когда в задаче всплывают пайплайны, автоматизация или культура DevOps. CX Codex +1 210установок testing-expert Скилл testing-expert задаёт агенту правила написания тестов: структура AAA, независимые кейсы, моки и граничные случаи. Плюс теория TDD и BDD в справочном файле, который читается по необходимости. CX Codex +1 206установок sre-expert Скилл sre-expert для настройки практик SRE, расчёта SLO и организации процессов инцидент-менеджмента в проекте. CX Codex +1 205установок prometheus-expert Скилл prometheus-expert для Claude Code учит агента мониторингу Prometheus: сбору метрик, запросам PromQL, recording и alerting rules. Помогает поднимать экспортёры в Kubernetes и разбирать чужие дашборды. CX Codex +1 204установок kotlin-expert Скилл kotlin-expert помогает писать и разбирать Kotlin-код для Android, корутин, JVM и Kotlin Multiplatform. Подключайте его к задачам, где важны идиоматичный синтаксис и архитектура. CX Codex +1 203установок react-expert Скилл react-expert настраивает ИИ-агента на разработку на React 18+ и Next.js: правила типизации в TypeScript, хуки, мемоизацию и тесты на React Testing Library. CX Codex +1 200установок performance-expert Скилл performance-expert помогает профилировать код, искать узкие места в базах данных и настраивать кэширование под высокие нагрузки. CX Codex +1 198установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой