5分钟快速上手:4种方式把Elastic agent-skills装进Cursor、Claude Code与GitHub Copilot
5分钟快速上手:4种方式把Elastic agent-skills装进Cursor、Claude Code与GitHub Copilot
agent-skills 是 Elastic 官方出品的 AI 智能体技能库(Official Elastic Skills),把 Elasticsearch、Kibana、可观测性和安全领域的平台专家经验直接注入你的 AI 编程助手。把它装进 Cursor、Claude Code 或 GitHub Copilot 后,你的 AI Agent 就能正确执行 ES|QL 查询、管理 Kibana 仪表盘、处理 Elastic Cloud 项目——不再胡编过时的 API 用法。
下面用最少的步骤,带你 5 分钟内完成安装。🚀
先了解:Skill 是什么?
每个 Skill 都是一个独立文件夹,核心是一个 SKILL.md 文件,里面包含元数据和 Agent 要遵循的指令。例如 elasticsearch-esql/SKILL.md 教会 Agent 如何执行 ES|QL 查询、聚合指标和生成图表。
仓库中目前有 30+ 个技能,按 5 大领域组织:
| 领域 | 典型技能 | 能做什么 |
|---|---|---|
| Cloud | cloud-setup、cloud-create-project | 管理 Elastic Cloud 项目与凭据 |
| Elasticsearch | elasticsearch-esql、elasticsearch-file-ingest | 写查询、导入数据、安全管理 |
| Kibana | kibana-dashboards、kibana-anomaly-detection | 建仪表盘、配置告警与 ML 异常检测 |
| Observability | edot-java-instrument、logs-search | 应用接入 OTel、日志排查、SLO 管理 |
| Security | alert-triage、detection-rule-management | 告警分诊、SOC 案件与检测规则 |
完整清单见 README.md 中的 Available Skills 表格。
安装前准备:环境与选型建议
- 需要已安装目标 AI Agent(如 Cursor、Claude Code、GitHub Copilot CLI)
- 方式三
npx需要 Node.js 环境;方式四只需要 bash 3.2+ - 💡 官方建议:不要一次装全部技能。 每个技能都会占用 Agent 的路由上下文,优先安装
cloud和elasticsearch认证类技能(多数技能依赖它们),再按需补充
方式一:npx 一键安装(最推荐,30 秒完成)
无需 clone 仓库,运行一条命令即可,适合大多数用户:
npx skills add elastic/agent-skills
命令会启动交互式界面,让你勾选想装哪些技能、装给哪些 Agent,然后自动把技能文件夹复制到正确位置。
常用技巧:
# 只安装指定技能
npx skills add elastic/agent-skills --skill elasticsearch-esql
# 同时装给 Cursor 和 Claude Code
npx skills add elastic/agent-skills -a cursor -a claude-code
# 先预览可装哪些技能,不实际安装
npx skills add elastic/agent-skills --list
| 参数 | 作用 |
|---|---|
-a, --agent |
指定目标 Agent |
-s, --skill |
按名称安装指定技能 |
-g, --global |
装到用户主目录而非项目目录 |
--list |
仅列出可用技能 |
方式二:Claude Code 原生插件安装
Claude Code 用户有原生插件系统,是最省心的选择:
# 第一步:把仓库添加为插件市场来源
claude plugin marketplace add https://github.com/elastic/agent-skills
# 第二步:按领域安装插件
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
也可以在会话内输入 /plugins 打开交互式插件浏览器,浏览、安装和管理插件。
⚠️ 已知小坑:安装后执行
/reload-plugins可能不会立即生效,重启一次 Claude Code 会话即可看到新技能。
方式三:GitHub Copilot CLI 插件安装
GitHub Copilot CLI 同样提供原生插件系统,步骤与 Claude Code 类似:
# 添加市场来源
copilot plugin marketplace add elastic/agent-skills
# 按名称安装插件
copilot plugin install elasticsearch@elastic-agent-skills
copilot plugin install kibana@elastic-agent-skills
在 Copilot 会话中输入 /plugin list 可交互式浏览已配置的插件。每个领域插件(如 elasticsearch)的技能定义可参考 plugins/elasticsearch/plugin.json。
方式四:本地克隆 + 安装脚本(无 Node 环境也能装)
如果你的环境没有 Node.js/npx,或者习惯本地管理,仓库自带纯 bash 安装脚本 install-skills.sh:
git clone https://gitcode.com/gh_mirrors/agentskills1/agent-skills
cd agent-skills
./scripts/install-skills.sh add -a cursor -a claude-code
脚本会自动扫描 skills/ 目录下所有技能并复制到对应 Agent 的目录。常用参数:
| 参数 | 作用 |
|---|---|
-a, --agent |
目标 Agent,可重复指定 |
-s, --skill |
按名称或通配符安装,如 -s 'observability-*' |
-f, --force |
覆盖已安装的技能 |
-y, --yes |
跳过确认提示 |
查看仓库内全部技能:
./scripts/install-skills.sh list
支持的 Agent 与安装目录速查
| Agent | 安装目录 |
|---|---|
| claude-code | .claude/skills |
| cursor | .agents/skills |
| github-copilot | .agents/skills |
| codex / opencode / cline | .agents/skills |
| windsurf | .windsurf/skills |
| roo | .roo/skills |
| pi | .pi/agent/skills |
| gemini-cli | .agents/skills |
更新技能:按安装方式对号入座
装完不更新,等于白装。不同方式的更新命令各不相同:
- Claude Code 插件:
claude plugin update(全量)或claude plugin update elastic-elasticsearch(指定),还可开启自动更新 - Copilot CLI:
copilot plugin update - npx 方式:
npx skills check检查上游变化,npx skills update拉取最新版本。npx 默认使用符号链接,更新一次即可同步所有 Agent - 本地克隆:
git pull后重新执行./scripts/install-skills.sh add -a cursor --force覆盖更新
常见问题 FAQ
Q1:装完技能,Agent 没反应?
确认技能已复制到正确目录(见上表),并重启 IDE / Agent 会话。Claude Code 用户请记得重启而非只执行 /reload-plugins。
Q2:技能依赖环境变量吗?
部分技能需要。例如 cloud-setup/SKILL.md 需要 EC_API_KEY,elasticsearch-esql 需要 ELASTICSEARCH_URL 加 API Key。具体以各技能 SKILL.md 中 compatibility 字段说明为准。
Q3:技能会访问我的数据吗?
会。AI Agent 持有真实凭据和 shell 权限,技能查询到的安全数据(告警、事件)会进入模型上下文。官方在 README.md 的安全须知中建议:最小化 API Key 权限、默认只读、先在非生产环境验证、并亲自审查这些开源技能的实现。
写在最后
只需一条 npx skills add elastic/agent-skills,你的 AI 编程助手就能获得 Elastic 官方团队沉淀的平台专家经验——从 ES|QL 查询到 Kibana 告警、从 APM 接入到 SOC 告警分诊。选对安装方式,5 分钟后即可开工。🎯