elastic/agent-skillsОфициальные навыки Elastic
Elastic Agent Skills — созданные командой, которая разработала Elastic — предоставляют нативную экспертизу платформы непосредственно вашему ИИ-агенту для написания кода. Это официальная библиотека Agent Skills, совместимая с агентными IDE, такими как Cursor, GitHub Copilot, Windsurf, Gemini CLI и другими. Навыки соответствуют открытому стандарту Agent Skills.
[!NOTE] Техническое предварительное издание
Эти навыки находятся на ранней стадии выпуска и активно разрабатываются. Ожидайте изменений по мере того, как навыки будут кодифицированы с помощью надежных оценок и по мере развития ландшафта моделей. Заглядывайте сюда почаще за обновлениями.
Этот репозиторий содержит курируемые навыки — пакеты инструкций, контекста и инструментов, которые обучают любого ИИ-агента правильно работать с Elasticsearch, Kibana, Elastic Observability и Elastic Security. Добавьте их в среду выполнения агента, которую вы уже используете, и ваш ассистент перестанет применять устаревшие шаблоны и начнет делать всё правильно.
Навыки — это автономные пакеты, которые дают ИИ-агентам знания и инструменты для выполнения конкретных задач воспроизводимым образом. Каждый навык находится в собственной папке с файлом , содержащим метаданные и инструкции, которым следует агент.
SKILL.mdДополнительную информацию о стандарте Agent Skills см. на agentskills.io.
Навыки в этом репозитории сосредоточены на:
| Навык | Описание | Версия | Автор |
|---|---|---|---|
| cloud-access-management | Управление доступом к организации Elastic Cloud: приглашение пользователей, назначение ролей проектам Serverless, создание и отзыв Cloud API-ключей. Используйте при предоставлении, изменении или аудите доступа пользователей. | 0.1.0 | elastic |
| cloud-create-project | Создает проекты Elastic Cloud Serverless (Elasticsearch, Observability или Security) через REST API, сохраняет учетные данные в файл и создает ограниченный по области действия Elasticsearch API-ключ. Используйте при создании нового проекта serverless, подготовке среды поиска или observability или запуске нового проекта Elastic Cloud. | 0.1.0 | elastic |
| cloud-manage-project | Управляет существующими проектами Elastic Cloud Serverless: список, получение, обновление, удаление, сброс учетных данных, возобновление и загрузка сохраненных учетных данных. Подключается к существующим проектам, разрешая конечные точки и получая ограниченные по области действия Elasticsearch API-ключи. Используйте при выполнении операций второго дня на проектах serverless, подключении к существующему проекту, загрузке или сбросе учетных данных проекта или поиске сведений о проекте. | 0.1.0 | elastic |
| cloud-network-security | Управление сетевой безопасностью Serverless (фильтры трафика): создание, обновление и удаление IP-фильтров и AWS PrivateLink VPC-фильтров. Используйте при ограничении сетевого доступа или настройке приватного подключения. | 0.1.0 | elastic |
| cloud-setup | Настраивает аутентификацию Elastic Cloud и значения по умолчанию для окружения. Используйте при настройке EC_API_KEY, настройке доступа к Cloud API или когда другому облачному навыку требуются учетные данные. | 0.1.0 | elastic |
| Навык | Описание | Версия | Автор |
|---|---|---|---|
| elasticsearch-audit | Включение, настройка и запрос журналов аудита безопасности Elasticsearch. Используйте, когда задача связана с настройкой аудита, фильтрацией событий или расследованием инцидентов безопасности, таких как неудачные входы в систему. | 0.1.0 | elastic |
| elasticsearch-authn | Аутентификация в Elasticsearch с использованием нативных, файловых, LDAP/AD, SAML, OIDC, Kerberos, JWT или сертификатных областей. Используйте при подключении с учетными данными, выборе области или управлении API-ключами. Предполагается, что целевые области уже настроены. | 0.1.0 | elastic |
| elasticsearch-authz | Управление RBAC в Elasticsearch: нативные пользователи, роли, сопоставления ролей, безопасность на уровне документов и полей. Используйте при создании пользователей или ролей, назначении привилегий или сопоставлении внешних областей, таких как LDAP/SAML. | 0.1.1 | elastic |
| elasticsearch-esql | Выполнение запросов ES|QL (язык запросов Elasticsearch). Используйте, когда пользователь хочет запросить данные Elasticsearch, проанализировать логи, агрегировать метрики, исследовать данные или создать диаграммы и дашборды на основе результатов ES|QL. | 0.5.0 | elastic |
| elasticsearch-file-ingest | Загрузка и преобразование файлов данных (CSV/JSON/Parquet/Arrow IPC) в Elasticsearch с потоковой обработкой и пользовательскими преобразованиями. Используйте при загрузке файлов или пакетном импорте данных — не для переиндексации, общего проектирования конвейеров приема или шаблонов bulk API. | 0.2.0 | elastic |
| elasticsearch-onboarding | Помощь разработчикам, новым в Elasticsearch, в переходе от нуля к работающему поисковому опыту. Проведите их через понимание их намерений, сопоставление данных и создание поискового опыта с встроенными лучшими практиками. Используйте, когда пользователь проявляет намерение создать функциональность, связанную с поиском, задает вопросы о концепциях Elasticsearch для своего варианта использования или выражает потребность в помощи с началом работы с Elasticsearch. |
| Навык | Описание | Версия | Автор |
|---|---|---|---|
| kibana-agent-builder | Создание и управление агентами Agent Builder и пользовательскими инструментами в Kibana. Используйте, когда вас просят создать, обновить, удалить, протестировать или проверить агентов или инструменты в Agent Builder. | 0.2.0 | elastic |
| kibana-alerting-rules | Создание и управление правилами оповещения Kibana через REST API или Terraform. Используйте при создании, обновлении или управлении жизненным циклом правил (включение, отключение, отключение звука, откладывание) или рабочих процессах rules-as-code. | 0.1.0 | elastic |
| kibana-anomaly-detection | Навык обнаружения аномалий Elastic ML — расследование/RCA, объяснение оценок, операции с заданиями (создание, datafeed, запуск/остановка, результаты) и устранение неполадок (отсутствующие документы, ограничения памяти, работоспособность datafeed, жизненный цикл). Работает с инструментами MCP Agent Builder Kibana (ad_*) на .ml-anomalies-*, .ml-config, .ml-notifications-*, .ml-annotations-*. Используйте при ответе на вопросы «что сломалось?»/«какая сущность?»/RCA, «почему оценка высокая/низкая?»/ренормализация, «datafeed остановлен»/«ограничение памяти» или любом запросе на настройку или конфигурацию задания обнаружения аномалий ML. | 0.2.0 | elastic |
| kibana-audit | Включение и настройка журналирования аудита Kibana для доступа к сохраненным объектам, входов в систему и операций с пространствами. Используйте при настройке аудита Kibana, фильтрации событий или корреляции журналов аудита Kibana и ES. | 0.1.0 | elastic |
| kibana-connectors | Создание и управление коннекторами Kibana для Slack, PagerDuty, Jira, вебхуков и других через REST API или Terraform. Используйте при настройке сторонних интеграций или управлении коннекторами как кодом. | 0.1.1 | elastic |
| kibana-dashboards |
| Навык | Описание | Версия | Автор |
|---|---|---|---|
| observability-edot-dotnet-instrument | Инструментирование .NET-приложения с помощью .NET SDK Elastic Distribution of OpenTelemetry (EDOT) для автоматического трассирования, метрик и логов. Используйте при добавлении observability в .NET-сервис, у которого нет существующего APM-агента. | 0.1.0 | elastic |
| observability-edot-dotnet-migrate | Миграция .NET-приложения с классического Elastic APM .NET-агента на EDOT .NET SDK. Используйте при переходе с пакетов Elastic.Apm.* на Elastic.OpenTelemetry. | 0.1.0 | elastic |
| observability-edot-java-instrument | Инструментирование Java-приложения с помощью Java-агента Elastic Distribution of OpenTelemetry (EDOT) для автоматического трассирования, метрик и логов. Используйте при добавлении observability в Java-сервис, у которого нет существующего APM-агента. | 0.1.1 | elastic |
| observability-edot-java-migrate | Миграция Java-приложения с классического Elastic APM Java-агента на EDOT Java-агент. Используйте при переходе с elastic-apm-agent.jar на elastic-otel-javaagent.jar. | 0.1.1 | elastic |
| observability-edot-python-instrument | Инструментирование Python-приложения с помощью Python-агента Elastic Distribution of OpenTelemetry (EDOT) для автоматического трассирования, метрик и логов. Используйте при добавлении observability в Python-сервис, у которого нет существующего APM-агента. | 0.1.0 | elastic |
| observability-edot-python-migrate | Миграция Python-приложения с классического Elastic APM Python-агента на EDOT Python-агент. Используйте при переходе с elastic-apm на elastic-opentelemetry. | 0.1.0 | elastic |
| observability-k8s-investigation |
| Навык | Описание | Версия | Автор |
|---|---|---|---|
| security-alert-triage | Триаж оповещений Elastic Security — сбор контекста, классификация угроз, создание кейсов и подтверждение. Используйте при триаже оповещений, выполнении анализа SOC или расследовании обнаружений. | 0.1.0 | elastic |
| security-case-management | Создание, поиск, обновление и управление кейсами SOC через Kibana Cases API. Используйте при отслеживании инцидентов, привязке оповещений к кейсам, добавлении заметок расследования или управлении результатами триажа. | 0.1.0 | elastic |
| security-detection-rule-management | Создание, настройка и управление правилами обнаружения Elastic Security (SIEM и Endpoint). Используйте для ложных срабатываний, исключений, нового покрытия, шумных правил или управления правилами через Kibana API. | 0.1.0 | elastic |
| security-generate-security-sample-data | Генерация примеров событий безопасности, сценариев атак и синтетических оповещений для Elastic Security. Используйте при демонстрации, заполнении дашбордов, тестировании правил обнаружения или настройке POC. | 0.1.0 | elastic |
ИИ-агенты для написания кода работают с реальными учетными данными, реальным доступом к оболочке и часто со всеми разрешениями пользователя, который их запускает. Когда такие агенты направляются на рабочие процессы безопасности, ставки выше. Это требует откровенного разговора о рисках, прежде чем вы начнете.
Эти навыки являются открытым исходным кодом именно для того, чтобы вы могли проверить, что они делают. Мы рекомендуем вам прочитать их перед запуском.
Вы можете установить навыки Elastic с помощью нативной системы плагинов Claude Code, CLI skills с npx или клонировав этот репозиторий и запустив встроенный скрипт установки. Метод npx требует Node.js с доступным npx в вашем окружении.
[!TIP] Не устанавливайте каждый навык. Каждый установленный навык добавляет контекст маршрутизации, который ваш агент оценивает при каждом запросе. Установите навыки аутентификации cloud и elasticsearch — большинство других навыков зависят от них — затем добавьте только навыки, релевантные вашему рабочему процессу. Поддержание установленного набора сфокусированным позволяет избежать раздувания контекста и помогает агенту надежно маршрутизировать к правильному навыку.
Claude Code имеет нативную систему плагинов, которая управляет навыками напрямую. Начните с добавления этого репозитория как источника маркетплейса:```sh claude plugin marketplace add https://github.com/elastic/agent-skills
После добавления установите отдельные плагины по имени:```sh
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install 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
Самый быстрый способ установить навыки — с помощью 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 |
Процесс обновления зависит от того, как были установлены навыки.
Обновите все установленные плагины до последних версий:```sh claude plugin update
Обновить конкретный плагин:```sh
claude plugin update elastic-elasticsearch
Чтобы автоматически поддерживать плагины в актуальном состоянии, включите автообновление с помощью /plugins в Claude Code.
Когда автообновление включено, Claude Code проверяет наличие новых версий плагинов при запуске и обновляет их в фоновом режиме.
Обновите все установленные плагины до последних версий:```sh copilot plugin update
Обновить конкретный плагин:```sh
copilot plugin update elasticsearch
Проверьте, изменились ли какие-либо установленные навыки в вышестоящем репозитории:```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, и мы его рассмотрим.
Эти навыки предоставляются как есть. Всегда тщательно тестируйте навыки в своём окружении, прежде чем полагаться на них при выполнении критически важных задач.
| 0.1.0 |
| elastic |
| elasticsearch-security-troubleshooting | Диагностика и устранение ошибок безопасности Elasticsearch: сбои 401/403, проблемы TLS, истекшие API-ключи, несоответствия сопоставления ролей и проблемы со входом в Kibana. Используйте, когда пользователь сообщает об ошибке безопасности. | 0.1.0 | elastic |
| Создание и управление дашбордами и визуализациями Kibana. Используйте, когда вам нужно декларативно определять дашборды и визуализации, управлять их версиями или автоматизировать их развертывание. |
| 0.1.2 |
| elastic |
| kibana-vega | Создание визуализаций Vega и Vega-Lite с источниками данных ES|QL в Kibana. Используйте при создании пользовательских диаграмм, дашбордов или программных макетов панелей, выходящих за рамки стандартных диаграмм Lens. | 0.1.0 | elastic |
| kibana-workflows | Создание, проверка, тестирование, запуск и проверка определений YAML Elastic Workflow. Используйте, когда пользователь хочет превратить естественный язык в рабочий процесс Kibana, исправить YAML рабочего процесса, понять триггеры или шаги или запустить быстрый цикл тестирования против реальной Kibana. | 0.5.0 | elastic |
| kibana-streams | Список, проверка, включение, отключение и повторная синхронизация потоков Kibana через REST API. Используйте, когда пользователю нужны сведения о потоках, настройки приема, настройки потоков запросов или связанные вложения (дашборды, правила, SLO). | 0.2.0 | elastic |
| Расследование проблем рабочих нагрузок, узлов и плоскости управления Kubernetes с использованием телеметрии OTel (EDOT). Используйте при диагностике сбоев подов (CrashLoopBackOff, OOMKilled, Error), давления на узлы, истощения ресурсов, сбоев извлечения образов, отклонений при допуске, аномалий автоскалирования или корреляции состояния K8s с сигналами приложений. Только путь приема OTel — устаревшая форма интеграции ECS Kubernetes выходит за рамки. |
| 0.2.0 |
| elastic |
| observability-llm-obs | Мониторинг LLM и агентных приложений: производительность, токены/стоимость, качество ответов и оркестрация рабочих процессов. Используйте, когда пользователь спрашивает о мониторинге LLM, observability GenAI или стоимости/качестве ИИ. | 0.1.0 | elastic |
| observability-logs-search | Поиск и фильтрация логов Observability с использованием ES|QL. Используйте при расследовании всплесков логов, ошибок или аномалий; получении объемов и тенденций; или углублении в сервисы или контейнеры во время инцидентов. | 0.2.0 | elastic |
| observability-manage-slos | Создание и управление SLO в Elastic Observability с использованием Kibana API. Используйте при определении SLI, настройке бюджетов ошибок или управлении жизненным циклом SLO. | 0.2.0 | elastic |
| observability-service-health | Оценка работоспособности APM-сервисов с использованием SLO, оповещений, ML, пропускной способности, задержки, частоты ошибок и зависимостей. Используйте при проверке статуса сервиса, производительности или когда пользователь спрашивает о работоспособности сервиса. | 0.1.0 | elastic |