Elastic Agent Skills

Elastic Agent Skills — 由构建 Elastic 的团队打造 — 将原生平台专业知识直接交付给你的 AI 编码代理。这是官方的 Agent Skills 库，兼容 Cursor、GitHub Copilot、Windsurf、Gemini CLI 等代理式 IDE。技能遵循 Agent Skills 开放标准。

[!NOTE] 技术预览

这些技能处于早期发布阶段，正在积极开发中。随着技能通过稳健的评估被规范化，以及模型格局的演变，预计会有变化。请经常回来查看更新。

关于

本仓库包含精选技能，这些技能是指令、上下文和工具包的集合，用于教会任何 AI 代理如何正确地使用 Elasticsearch、Kibana、Elastic Observability 和 Elastic Security。将它们放入你已在使用的代理运行时中，你的助手就会停止使用过时的模式，并开始正确地工作。

什么是技能？

技能是自包含的包，为 AI 代理提供以可重复方式完成特定任务所需的知识和工具。每个技能都位于自己的文件夹中，包含一个 SKILL.md 文件，其中含有代理遵循的元数据和指令。

有关 Agent Skills 标准的更多背景信息，请参阅 agentskills.io。

范围

本仓库中的技能专注于：

• 与 Elasticsearch API 交互（搜索、索引、集群管理）
• 构建和管理 Kibana 内容，例如告警、连接器等
• Elastic Observability、Elastic Security 和 Agent Builder 的模式

可用技能

Cloud (2)

技能	描述	版本	作者
cloud-onboarding	引导 Elastic Cloud 组织入门：配置 elastic CLI 的 Cloud 上下文和 API 密钥，建立默认区域，然后邀请用户，分配预定义或自定义的 Serverless 项目角色，并创建或撤销 Cloud API 密钥。适用于设置 Cloud 身份验证，或授予、修改、审计用户对组织及其项目的访问权限时。	0.3.0	elastic
cloud-provisioning	预配和运维 Elastic Cloud 基础设施：创建、连接、更新和删除 Serverless 项目（Elasticsearch、Observability、Security）；管理流量过滤器（IP 和 AWS PrivateLink 网络安全）；以及管理 Elastic Cloud Hosted 部署的生命周期。适用于创建 Serverless 项目或托管部署、对其执行日常运维操作，或限制其网络访问时。	0.3.0	elastic

Elasticsearch (10)

技能	描述	版本	作者
elasticsearch-anomaly-detection	通过 API 创建和管理 Elastic ML 异常检测作业。适用于在索引或数据流上设置作业、配置作业和数据源，或打开、启动、停止作业的场景。	1.1.0	elastic
elasticsearch-anomaly-detection-explainer	解释 Elasticsearch ML 异常检测分数、模型行为和结果解读。适用于用户询问分数为何偏高或偏低、模型如何学习、这些数字代表什么，或如何排查意外的异常分数。	0.3.0	elastic
elasticsearch-cluster-health	诊断非绿色状态的 Elasticsearch 集群，并给出最可能的单一原因及修复建议。适用于运维人员报告黄色或红色状态、未分配分片、分配失败，或希望在深入调查前进行只读分诊的场景。讲解副本与主分片的影响、分配决策器分类以及数据丢失意识。	0.1.0	elastic
elasticsearch-esql	执行 ES|QL（Elasticsearch 查询语言）查询，适用于用户想要查询 Elasticsearch 数据、分析日志、聚合指标、探索数据，或基于 ES|QL 结果创建图表和仪表盘的场景。	0.10.0	elastic
elasticsearch-index-design	针对既定的访问模式设计和审查 Elasticsearch 索引映射：正确的字段类型、text+keyword 多字段、doc_values 调优、避免映射爆炸，以及显式的分片设置。适用于创建新索引、审查映射以优化存储或查询性能、修复错误的字段类型，或用户询问某字段在搜索、过滤、排序或聚合时应使用哪种类型的场景。	0.1.0	elastic
elasticsearch-ingest	使用 bulk API 和显式映射（当字段类型很重要时）将 CSV、JSON 和 NDJSON 文件加载到 Elasticsearch 索引中。适用于批量导入本地文件、将 CSV 行或 JSON 数组转换为 NDJSON bulk 格式、在摄取前用 elastic es info 确认集群连通性，或在摄取后验证文档数量和映射——不适用于 Logstash 管道、Beats、自定义脚本或索引到索引的 reindex。	0.1.3	elastic
elasticsearch-onboarding	帮助刚接触 Elasticsearch 的开发者从零开始获得可用的搜索体验。引导他们理解自身意图、映射数据，并构建融入最佳实践的搜索体验。适用于用户表现出构建搜索相关功能的意图、询问与其用例相关的 Elasticsearch 概念，或表示需要帮助入门 Elasticsearch 的场景。	0.3.0	elastic
elasticsearch-query-optimization	诊断缓慢的 Elasticsearch Query DSL 搜索并提出经过实测的修复方案。适用于搜索缓慢、性能分析输出显示存在高开销子句、精确匹配过滤器处于评分上下文，或前导通配符主导延迟的场景。每条建议都以搜索性能分析为依据——将非评分子句移至过滤上下文、消除前导通配符，并重新分析以确认改进效果。	0.1.0	elastic
elasticsearch-reindex	指导 Elasticsearch reindex 的性能优化：本地和远程、切片、限流、任务 API。适用于复制或迁移索引、更改映射，或在 reindex 过程中进行数据转换的场景。	0.2.0	elastic
elasticsearch-search-relevance	提升内容和目录索引的 Elasticsearch 搜索相关性：使用查询规则（正确的规则类型、条件和规则-查询关联）固定或提升结果，并通过 multi_match、字段加权和基于索引映射的分析来调优自然排序。适用于搜索结果排序不佳、特定文档必须在某个查询中排在首位，或用户要求调优全文匹配的场景——不适用于 ES|QL 分析、索引摄取或集群健康。	0.1.0	elastic

Kibana (7)

技能	描述	版本	作者
kibana-agent-builder	创建和管理 Kibana Agent Builder 代理及自定义工具。当被要求创建、更新、删除、测试或检查 Agent Builder 中的代理或工具时使用，或当用户想了解已存在哪些代理或工具时使用。	0.3.0	elastic
kibana-alerting-rules	创建和管理 Kibana 告警规则。当创建、更新或管理规则生命周期（启用、禁用、静音、暂停），选择指标阈值规则类型和参数，或使用标签过滤器进行只读查找/列出时使用。	0.3.0	elastic
kibana-anomaly-detection	Elastic ML 异常检测——调查/根因分析、分数解释、作业生命周期故障排查以及作业操作。当回答“什么坏了？”/“哪个实体？”/RCA、“为什么分数高/低？”/重新归一化、“datafeed 停止”/“内存限制”/hard_limit，或配置 ML 异常检测作业时使用。从 .ml-anomalies-* 读取结果，从 ML REST API 读取作业状态。	0.3.0	elastic
kibana-cases	跨 Elastic Security、Observability 和 Stack Management 管理调查和事件案例——创建、搜索、更新案例，并用评论、告警、事件和可观测对象（IOC）丰富案例。当跟踪事件、将告警关联到案例、添加调查笔记、更新状态或严重性，或管理分诊输出时使用。	0.2.0	elastic
kibana-context-engine	查询 Elastic Context Engine AI 索引及其存储的知识指标（KI）。当被要求从 AI 索引 / KI / Context Engine 知识索引中搜索、探索、计数或回答问题，以及编写查询该索引的 ES|QL 时使用。	0.2.1	elastic
kibana-dashboards	创建和管理 Kibana 仪表板及 Lens 可视化。当你需要以声明式方式定义仪表板和可视化、对其进行版本控制、自动化部署，或改进布局、分区、控件或图表设计时使用。	0.4.0	elastic
kibana-workflows	编写、验证、测试、运行和检查 Elastic Workflow YAML 定义。当用户想将自然语言转换为 Kibana 工作流、修复工作流 YAML、理解触发器或步骤，或针对真实 Kibana 运行快速测试循环时使用。	0.5.0	elastic

Observability (6)