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 的模式

可用技能

安全注意事项

AI 编码代理使用真实凭据、真实 shell 访问权限，并且通常拥有运行它们的用户的全部权限。当这些代理被指向安全工作流时，风险更高。这值得在开始之前就风险进行坦诚的讨论。

• 自行进行威胁建模。 评估代理可以访问哪些数据、可以执行哪些操作，以及如果其行为异常会发生什么。CISA 关于安全部署 AI 系统的联合指南 是一个很好的起点。
• 注意流经代理的数据。 安全数据可能包含 PII、嵌入在命令行中的凭据以及其他受监管的数据。当代理查询告警或进程事件时，这些内容会进入模型的上下文，并可能被发送到第三方 API。尽早让你的信息安全与合规团队参与进来。
• 这些代理处理攻击者控制的输入。 告警、事件字段和文件内容经常包含由攻击者构造的字符串。提示注入在这里并非理论上的问题；它是操作环境的固有属性。像 Brainworm 这样的研究表明，仅代理上下文文件就可以作为提示软件的持久化机制。
• 严格限定权限范围。 为 API 密钥授予所需的最低权限。广泛的响应权限尤其危险。只读访问是一个很好的默认选择，直到你验证了行为。
• 限制代理工具访问和网络可达性。 大多数 AI 编码代理默认具有广泛的权限：shell 执行、文件系统写入、互联网访问。减少可用的工具面可以限制受损或被误导的代理可以执行的操作。
• 从非生产环境开始。 使用 Serverless 试用项目、开发集群或隔离的 Kibana 空间来评估技能，然后再将其连接到任何承载实时安全数据的内容。

这些技能是开源的，正是为了让你能够审计它们的功能。我们鼓励你在运行之前阅读它们。

入门

你可以使用 Claude Code 原生插件系统、通过 npx 使用 skills CLI，或克隆此仓库并运行捆绑的安装脚本来安装 Elastic 技能。npx 方法要求你的环境中具有包含 npx 的 Node.js。

[!TIP] 不要安装每个技能。 每个已安装的技能都会添加路由上下文，你的代理会在每个请求时进行评估。安装 cloud 和 elasticsearch 认证技能 — 大多数其他技能都依赖它们 — 然后只添加与你工作流相关的技能。保持已安装集合的聚焦可以避免上下文膨胀，并帮助代理可靠地路由到正确的技能。

Claude Code 插件（推荐给 Claude Code 用户）

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

npx（推荐）

安装技能最快的方式是使用 skills CLI。无需克隆此仓库——只需运行：```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

本地克隆

如果您更倾向于使用本地检出，或者您的环境没有 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 插件

将所有已安装的插件更新到最新版本：```sh claude plugin update

更新特定插件：```sh
claude plugin update elastic-elasticsearch

为了让插件自动保持最新状态，可在 Claude Code 中使用 /plugins 启用自动更新。

启用自动更新后，Claude Code 会在启动时检查插件的新版本，并在后台进行更新。

GitHub Copilot CLI

将所有已安装的插件更新到最新版本：```sh copilot plugin update

更新特定插件：```sh
copilot plugin update elasticsearch

npx

检查是否有任何已安装的技能在上游发生了更改：```sh npx skills check

拉取所有已安装技能的最新版本：```sh
npx skills update

CLI 会在锁文件中记录每个技能的源仓库和内容哈希。check 会将本地哈希与 GitHub 上的进行比对；update 会重新下载任何已发生漂移的内容。

提示： 默认的 npx 安装使用符号链接，因此每个 agent 都指向同一份规范副本。更新一次即可同时刷新所有 agent。

本地克隆

使用 --force 重新运行安装程序以覆盖现有技能：```sh git pull ./scripts/install-skills.sh add -a --force

不添加 `--force` 时，脚本会跳过已安装的技能。

## 技能格式

每个技能文件夹都包含一个带有 YAML frontmatter 和 Markdown 指令的 `SKILL.md`：```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，我们会进行审查。

免责声明

这些技能按“原样”提供。在依赖它们处理关键任务之前，请务必在自己的环境中彻底测试这些技能。