agent-skills v0.4.0
Официальные навыки Elastic
Elastic Agent Skills
Elastic Agent Skills — созданные людьми, которые создали Elastic — предоставляют экспертизу нативной платформы непосредственно вашему агенту для программирования с ИИ. Это официальная библиотека Agent Skills, совместимая с агентными IDE, такими как Cursor, GitHub Copilot, Windsurf, Gemini CLI и другими. Навыки следуют открытому стандарту Agent Skills.
[!NOTE] Technical Preview
Эти навыки находятся на ранней стадии выпуска и активно развиваются. Ожидайте изменений по мере того, как навыки будут формализованы с помощью надёжных оценок и по мере развития ландшафта моделей. Заходите почаще за обновлениями.
О репозитории
Этот репозиторий содержит кураторскую подборку навыков — пакетов инструкций, контекста и инструментов, которые учат любого ИИ-агента правильно работать с Elasticsearch, Kibana, Elastic Observability и Elastic Security. Добавьте их в среду выполнения агента, которую вы уже используете, и ваш ассистент перестанет использовать устаревшие шаблоны и начнёт делать всё правильно.
Что такое навыки?
Навыки — это самодостаточные пакеты, которые дают ИИ-агентам знания и инструменты для выполнения конкретных задач воспроизводимым образом. Каждый навык находится в собственной папке с файлом SKILL.md, содержащим метаданные и инструкции, которым следует агент.
Для получения дополнительной информации о стандарте Agent Skills см. agentskills.io.
Область применения
Навыки в этом репозитории сосредоточены на:
- Взаимодействии с API Elasticsearch (поиск, индексирование, управление кластером)
- Создании и управлении контентом Kibana, таким как алерты, коннекторы и другое
- Шаблонах для Elastic Observability, Elastic Security и Agent Builder
Доступные навыки
Cloud (2)
| Skill | Description | Version | Author |
|---|---|---|---|
| cloud-onboarding | Onboard an Elastic Cloud organization: configure the elastic CLI's Cloud context and API key, establish a default region, then invite users, assign predefined or custom Serverless project roles, and create or revoke Cloud API keys. Use when setting up Cloud authentication or when granting, modifying, or auditing user access to an organization and its projects. | 0.3.0 | elastic |
| cloud-provisioning | Provision and operate Elastic Cloud infrastructure: create, connect to, update, and delete Serverless projects (Elasticsearch, Observability, Security); manage traffic filters (IP and AWS PrivateLink network security); and manage the lifecycle of Elastic Cloud Hosted deployments. Use when creating or performing day-2 operations on serverless projects or hosted deployments, or restricting their network access. | 0.3.0 | elastic |
Elasticsearch (10)
| Skill | Description | Version | Author |
|---|---|---|---|
| elasticsearch-anomaly-detection | Create and manage Elastic ML anomaly detection jobs via the API. Use when setting up jobs on an index or data stream, configuring jobs and datafeeds, or opening, starting, or stopping them. | 1.1.0 | elastic |
| elasticsearch-anomaly-detection-explainer | Explain Elasticsearch ML anomaly detection scores, model behavior, and result interpretation. Use when the user asks why a score is high or low, how the model learns, what the numbers mean, or how to troubleshoot unexpected anomaly scores. | 0.3.0 | elastic |
| elasticsearch-cluster-health | Diagnose a non-green Elasticsearch cluster and surface the single most likely cause with remediation. Use when an operator reports yellow or red status, unassigned shards, allocation failures, or wants read-only triage before deeper investigation. Teaches replica-vs-primary impact, allocation decider classification, and data-loss awareness. | 0.1.0 | elastic |
| elasticsearch-esql | 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. | 0.7.0 | elastic |
| elasticsearch-index-design | Design and review Elasticsearch index mappings for stated access patterns: correct field types, text+keyword multi-fields, doc_values tuning, mapping-explosion avoidance, and explicit shard settings. Use when creating a new index, reviewing a mapping for storage or query performance, fixing wrong field types, or when the user asks which type to use for search, filter, sort, or aggregation on a field. | 0.1.0 | elastic |
| elasticsearch-ingest | Load CSV and JSON files into Elasticsearch indices using the bulk API and explicit mappings when field types matter. Use when batch-importing local files, converting CSV rows or JSON arrays to NDJSON bulk format, or verifying document counts and mappings after ingest — not for Logstash pipelines, Beats, custom scripts, or index-to-index reindex. | 0.1.0 | elastic |
| elasticsearch-onboarding | Help developers new to Elasticsearch get from zero to a working search experience. Guide them through understanding their intent, mapping their data, and building a search experience with best practices baked in. Use this when the user shows intent to build search-related functionality, asks about Elasticsearch-related concepts for their use case, or expresses the need for help getting started with Elasticsearch. | 0.1.0 | elastic |
| elasticsearch-query-optimization | Diagnose slow Elasticsearch Query DSL searches and propose measured fixes. Use when a search is slow, profile output shows an expensive clause, exact-match filters sit in scoring context, or leading wildcards dominate latency. Ground every recommendation in search profiling — move non-scoring clauses to filter context, eliminate leading wildcards, and re-profile to confirm improvement. | 0.1.0 | elastic |
| elasticsearch-reindex | Guide Elasticsearch reindex for performance: local and remote, slicing, throttling, task API. Use when copying or migrating indices, changing mappings, or transforming during reindex. | 0.2.0 | elastic |
| elasticsearch-search-relevance | Improve Elasticsearch search relevance for content and catalog indices: pin or promote results with query rules (correct rule type, criteria, and rule-query wiring) and tune organic ranking with multi_match, field boosts, and analysis grounded in the index mapping. Use when search results rank poorly, a specific document must appear first for a query, or the user asks to tune full-text matching — not for ES|QL analytics, index ingest, or cluster health. | 0.1.0 | elastic |
Kibana (5)
| Skill | Description | Version | Author |
|---|---|---|---|
| kibana-agent-builder | Create and manage Kibana Agent Builder agents and custom tools. Use when asked to create, update, delete, test, or inspect agents or tools in Agent Builder, or when the user wants to understand what agents or tools already exist. | 0.3.0 | elastic |
| kibana-alerting-rules | Create and manage Kibana alerting rules. Use when creating, updating, or managing rule lifecycle (enable, disable, mute, snooze), choosing metric threshold rule types and params, or read-only find/list with tag filters. | 0.3.0 | elastic |
| kibana-anomaly-detection | Elastic ML anomaly detection — investigation/RCA, score explanation, job lifecycle troubleshooting, and job operations. Use when answering "what broke?"/"which entity?"/RCA, "why is score high/low?"/renormalization, "datafeed stopped"/"memory limit"/hard_limit, or configuring ML anomaly detection jobs. Reads results from .ml-anomalies-* and job state from ML REST APIs. | 0.3.0 | elastic |
| kibana-dashboards | Create and manage Kibana Dashboards and Lens visualizations. Use when you need to define dashboards and visualizations declaratively, version control them, or automate their deployment. | 0.3.0 | elastic |
| kibana-workflows | Author, validate, test, run, and inspect Elastic Workflow YAML definitions. Use when the user wants to turn natural language into a Kibana workflow, fix workflow YAML, understand triggers or steps, or run a quick test loop against a real Kibana. | 0.5.0 | elastic |
Observability (5)
| Skill | Description | Version | Author |
|---|---|---|---|
| observability-k8s-investigation | Investigate Kubernetes workload, node, and control-plane issues using OTel telemetry (EDOT). Use when diagnosing pod failures (CrashLoopBackOff, OOMKilled, Error), node pressure, resource exhaustion, image pull failures, admission rejections, autoscaling anomalies, or correlating K8s state with application signals. OTel ingest path only — the legacy ECS Kubernetes integration shape is out of scope. | 0.5.1 | elastic |
| observability-llm-obs | Answer questions about LLM and agentic-application behavior from data already ingested into Elastic: latency and error rate, token and cost utilization, response quality and guardrail events, and agentic call-chain orchestration. Use when the user asks about LLM monitoring, GenAI observability, token spend or AI cost, model latency, prompt or guardrail failures, or how an agent's tool-call chain executed. | 0.3.1 | elastic |
| observability-onboarding | Onboard an application into Elastic Observability with the Elastic Distribution of OpenTelemetry (EDOT): route on language and runtime, detect and replace a classic Elastic APM agent, apply the required OTLP configuration, and then verify with ES|QL that traces, metrics, and logs actually arrive under the expected service name. Use when adding observability to a service, migrating off the classic Elastic APM agent, or debugging why an instrumented service is not showing up in Elastic. | 0.3.0 | elastic |
| observability-service-reliability | Design and operate service reliability targets in Elastic Observability: choose an SLI type and a defensible target, pick a time window and budgeting method, create and maintain SLOs through the Kibana API, attach burn-rate alert rules, and decide when an SLO is the wrong instrument and a threshold rule, anomaly job, or synthetics monitor is right. Use when defining or reviewing SLOs and error budgets, tuning burn-rate alerting, reducing alert noise, or setting up availability monitoring for a user-facing endpoint. | 0.4.1 | elastic |
| observability-sre-triage | Triage a degraded or suspect service end to end: read SLO status and burn rate, check active alerting rules and ML anomalies, measure throughput, latency, and error rate, assess dependency health and infrastructure saturation, and funnel logs down to the failures that explain it. Use when someone asks whether a service is healthy, why it is slow or erroring, what is in its logs, or which attribute distinguishes the requests that are failing. Also use when someone asks for the query behind any of those signals — throughput, latency percentiles, error rate, dependency health, or log volume — over APM/OTel traces, metrics, or logs. | 0.5.1 | elastic |
Security (4)
| Skill | Description | Version | Author |
|---|---|---|---|
| security-alert-triage | Triage Elastic Security alerts — gather context, classify threats, create cases, and acknowledge. Use when triaging alerts, performing SOC analysis, or investigating detections. | 0.1.0 | elastic |
| security-case-management | Create, search, update, and manage SOC cases via the Kibana Cases API. Use when tracking incidents, linking alerts to cases, adding investigation notes, or managing triage output. | 0.1.0 | elastic |
| security-detection-rule-management | Create, tune, and manage Elastic Security detection rules (SIEM and Endpoint). Use for false positives, exceptions, new coverage, noisy rules, or rule management via Kibana API. | 0.1.0 | elastic |
| security-generate-security-sample-data | Generate sample security events, attack scenarios, and synthetic alerts for Elastic Security. Use when demoing, populating dashboards, testing detection rules, or setting up a POC. | 0.1.0 | elastic |
Вопросы безопасности
Агенты для программирования с ИИ работают с реальными учётными данными, реальным доступом к оболочке и зачастую с полными правами пользователя, запускающего их. Когда такие агенты направлены на рабочие процессы безопасности, ставки выше. Это заслуживает откровенного разговора о рисках, прежде чем вы начнёте.
- Проведите собственное моделирование угроз. Оцените, к каким данным агент имеет доступ, какие действия он может выполнять и что произойдёт, если он поведёт себя неожиданно. Совместное руководство CISA по безопасному развёртыванию ИИ-систем — хорошая отправная точка.
- Осознавайте, какие данные проходят через агента. Данные безопасности могут содержать PII, учётные данные, встроенные в командные строки, и другие регулируемые данные. Когда агент запрашивает алерты или события процессов, это содержимое попадает в контекст модели и может быть отправлено в сторонний API. Привлекайте свои команды по информационной безопасности и комплаенсу на раннем этапе.
- Эти агенты обрабатывают ввод, контролируемый злоумышленником. Алерты, поля событий и содержимое файлов регулярно содержат строки, созданные злоумышленниками. Prompt injection здесь не теоретический — это неотъемлемое свойство операционной среды. Исследования, подобные Brainworm, демонстрируют, что одни только файлы контекста агента могут служить механизмом персистентности для promptware.
- Строго ограничивайте привилегии. Давайте API-ключам минимально необходимые привилегии. Широкие привилегии на реагирование особенно опасны. Доступ только для чтения — хорошее значение по умолчанию, пока вы не проверите поведение.
- Ограничьте доступ агента к инструментам и сети. Большинство агентов для программирования с ИИ поставляются с широкими настройками по умолчанию: выполнение команд оболочки, запись в файловую систему, доступ в интернет. Сокращение доступной поверхности инструментов ограничивает то, что может сделать скомпрометированный или сбитый с толку агент.
- Начинайте в нерабочих средах. Используйте пробный Serverless-проект, dev-кластер или изолированное пространство Kibana, чтобы оценить навыки, прежде чем подключать их к чему-либо с реальными данными безопасности.
Эти навыки имеют открытый исходный код именно для того, чтобы вы могли проверить, что они делают. Мы рекомендуем прочитать их перед запуском.
Начало работы
Вы можете установить навыки Elastic с помощью нативной системы плагинов Claude Code, CLI skills через npx или клонировав этот репозиторий и запустив входящий в комплект установочный скрипт. Метод npx требует наличия Node.js с доступным npx в вашей среде.
[!TIP] Не устанавливайте все навыки. Каждый установленный навык добавляет контекст маршрутизации, который ваш агент оценивает при каждом запросе. Установите навыки аутентификации cloud и elasticsearch — большинство других навыков зависят от них — затем добавьте только навыки, относящиеся к вашему рабочему процессу. Поддержание сфокусированного набора установленных навыков позволяет избежать раздувания контекста и помогает агенту надёжно направлять запросы к нужному навыку.
Плагин Claude Code (рекомендуется для пользователей Claude Code)
Claude Code имеет нативную систему плагинов, которая управляет навыками напрямую. Начните с добавления этого репозитория в качестве источника маркетплейса:```sh claude plugin marketplace add https://github.com/elastic/agent-skills
После добавления устанавливайте отдельные плагины по имени:```sh
claude plugin install elastic-elasticsearch@elastic-agent-skills
claude plugin install elastic-kibana@elastic-agent-skills
claude plugin install elastic-observability@elastic-agent-skills
claude plugin install elastic-security@elastic-agent-skills
claude plugin install elastic-cloud@elastic-agent-skills
[!NOTE] После установки навыки могут не отображаться сразу при выполнении
/reload-plugins. Это известная проблема Claude Code — перезапустите сессию Claude Code, чтобы подхватить недавно установленные плагины.
Или воспользуйтесь интерактивным браузером плагинов внутри любой сессии Claude Code:``` /plugins
Открывается меню для просмотра доступных плагинов из всех настроенных маркетплейсов, выбора того, что нужно установить, и управления уже установленными плагинами.
### GitHub Copilot CLI
GitHub Copilot CLI имеет встроенную систему плагинов. Добавьте этот репозиторий как источник маркетплейса:```sh
copilot plugin marketplace add elastic/agent-skills
После добавления устанавливайте отдельные плагины по имени:```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills
Или просмотрите доступные плагины в интерактивном режиме внутри сессии Copilot:```
/plugin list
npx (рекомендуется)
Самый быстрый способ установить навыки — использовать CLI skills. Не нужно клонировать этот репозиторий — просто выполните:```sh
npx skills add elastic/agent-skills
Запускается интерактивная подсказка для выбора навыков и [целевых агентов](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). CLI копирует папку каждого навыка в нужное место, чтобы агент мог его обнаружить.
Установка конкретного навыка по имени:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql
Или используйте сокращение @, чтобы указать навык напрямую как repo@skill (эквивалентно --skill):```sh
npx skills add elastic/agent-skills@elasticsearch-esql
Установка для конкретных агентов (см. [поддерживаемые агенты](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code
Список доступных навыков без установки:```sh npx skills add elastic/agent-skills --list
Установить все навыки для всех агентов (неинтерактивно):```sh
npx skills add elastic/agent-skills --all
| Флаг | Описание |
|---|---|
-a, --agent | Целевые конкретные агенты (см. Поддерживаемые агенты) |
-s, --skill | Установить конкретные навыки по имени |
-g, --global | Установить в домашний каталог пользователя вместо каталога проекта |
-y, --yes | Пропустить запросы подтверждения |
--all | Установить все навыки для всех агентов без запросов |
--list | Показать список доступных навыков без установки |
Локальное клонирование
Если вы предпочитаете работать из локальной копии репозитория или в вашей среде нет Node.js / npx, клонируйте репозиторий и используйте встроенный установщик bash:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a
Скрипт требует bash 3.2+ и стандартные утилиты Unix (`awk`, `find`, `cp`, `rm`, `mkdir`).
| Флаг | Описание |
| ----------------- | ------------------------------------- |
| `-a, --agent` | Целевой агент (можно повторять) |
| `-s, --skill` | Установить конкретные навыки по имени |
| `-f, --force` | Перезаписать уже установленные навыки |
| `-y, --yes` | Пропустить запросы подтверждения |
Показать все доступные навыки:```sh
./scripts/install-skills.sh list
Поддерживаемые агенты
| Агент | Каталог установки |
|---|---|
| claude-code | .claude/skills |
| cursor | .agents/skills |
| codex | .agents/skills |
| opencode | .agents/skills |
| pi | .pi/agent/skills |
| windsurf | .windsurf/skills |
| roo | .roo/skills |
| cline | .agents/skills |
| github-copilot | .agents/skills |
| gemini-cli | .agents/skills |
Обновление навыков
Процесс обновления зависит от того, как были установлены навыки.
Плагин Claude Code
Обновите все установленные плагины до последних версий:```sh claude plugin update
Обновить конкретный плагин:```sh
claude plugin update elastic-elasticsearch
Чтобы автоматически поддерживать плагины в актуальном состоянии, включите автообновление с помощью /plugins в Claude Code.
Когда автообновление включено, Claude Code проверяет наличие новых версий плагинов при запуске и обновляет их в фоновом режиме.
GitHub Copilot CLI
Обновить все установленные плагины до последних версий:```sh copilot plugin update
Обновить конкретный плагин:```sh
copilot plugin update elasticsearch
npx
Проверьте, изменились ли какие-либо установленные навыки в upstream:```sh npx skills check
Загрузите последние версии всех установленных навыков:```sh
npx skills update
CLI отслеживает исходный репозиторий каждого навыка и хеш содержимого в lock-файле. check сравнивает ваши локальные хеши с GitHub; update повторно загружает всё, что изменилось.
Совет: Установка npx по умолчанию использует символические ссылки, поэтому каждый агент указывает на одну каноническую копию. Обновление один раз обновляет всех агентов одновременно.
Локальный клон
Повторно запустите установщик с --force, чтобы перезаписать существующие навыки:```sh
git pull
./scripts/install-skills.sh add -a --force
Без `--force` скрипт пропускает уже установленные навыки.
## Формат навыка
Каждая папка навыка содержит `SKILL.md` с YAML-фронтматтером и инструкциями в формате markdown:```yaml
---
name: elasticsearch-my-skill
description: >
What the skill does AND when an agent should activate it.
metadata:
version: 0.1.0
visibility: public
---
# My Skill
[Instructions that the agent follows when this skill is active]
Поле description — единственный механизм запуска: среды выполнения агентов читают его, чтобы решить, когда загружать навык. Полную спецификацию формата см. в agentskills.io/specification.
Проблемы
Нашли проблему или есть предложение? Откройте issue, и мы его рассмотрим.
Отказ от ответственности
Эти навыки предоставляются как есть. Всегда тщательно тестируйте навыки в своей среде, прежде чем полагаться на них при выполнении критически важных задач.