1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | kibana-dashboards | 仓库文件 |
| 作者/维护者 | Elastic（elastic/agent-skills 官方仓库） |
GitHub API |
| 来源链接 | https://github.com/elastic/agent-skills/tree/main/skills/kibana/kibana-dashboards | — |
| 许可证 | Apache License 2.0（仓库整体） | GitHub API |
| GitHub Stars / Forks | 所属仓库 545★ / 44 forks（注：该数字属整个技能合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 标注 v0.1.2 | 仓库文件 |
| 安装方式 | npx skills add elastic/agent-skills --skill kibana-dashboards，或 Claude Code / GitHub Copilot 插件市场安装 kibana 技能组 |
仓库文档 |
2. 功能介绍与亮点
kibana-dashboards 把 Kibana 的 Dashboards / Visualizations API 封装成 agent 可直接照做的声明式规范：
- 精简可 diff 的 JSON 定义：仪表盘与可视化面板只需写必要属性，省略内部实现细节与可推导属性，适合纳入 Git 版本控制与 code review 流程
- 两套数据源模式：Data View 模式由 Kibana 自动完成聚合，ES|QL 模式则由查询本身完成聚合、结果列通过
{ column: "..." }引用——文档逐条列出两者在 metric/xy 图表等场景下的写法差异 - 8 类图表覆盖：metric、xy（线/面/柱）、gauge、heatmap、tag_cloud、data_table、region_map，以及 pie/treemap/mosaic/waffle 等分区图
- 48 列网格与“首屏优先”布局准则：给出不同分辨率下的可视高度预算、面板堆叠对齐规则，避免 agent 生成的仪表盘留下大片死角空间
- 前置连接测试 + 错误速查表：要求 agent 先执行
node scripts/kibana-dashboards.js test校验连接，失败则停止而非继续猜测；文档内置 401/404/409/Schema 校验失败等常见错误的对照解法
亮点：配套脚本 package.json 中 dependencies 为空，纯 Node.js 内置模块实现，无第三方依赖引入的供应链风险；2026-05-25 Elastic Search Labs 官方博客介绍了同期发布的 Dashboards API 在 AI 仪表盘生成场景下的设计动机——该 API 正是本技能封装的对象（注：博客聚焦 API 本身，未点名本技能包）。
3. 适用场景
固定分类：数据分析与可视化
- 已部署 Elastic Stack / Kibana，希望用 agent 以自然语言描述快速生成运营仪表盘的工程师与数据分析师
- 需要把仪表盘定义纳入 Git 版本管理、走 GitOps 流程审核发布的团队
- 需要程序化、批量生成大量结构相似仪表盘（如按服务或团队复制模板）的场景
- 已经用 ES|QL 做数据探索、希望 agent 直接把查询结果渲染成图表面板、不想手工点选 Kibana UI 的用户
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方插件市场
claude plugin install kibana@elastic-agent-skills，也可用npx skills安装到.claude/skills - Codex：支持——仓库
npx skills安装工具的“受支持 agent”列表明确列出 codex，对应安装目录.agents/skills - OpenClaw：未验证——官方材料与安装工具支持列表均未提及
- Hermes Agent：未验证——同上，官方材料未提及
5. 推荐理由
Kibana 仪表盘目前主要靠鼠标点选拼装，改一个面板往往要在 UI 里翻好几层。这个技能把“仪表盘 = JSON 定义”标准化：图表类型、两套数据源写法、网格布局规则全部写成了 agent 可直接照做的规范，还配了前置连接测试和错误速查表，降低“agent 生成了语法正确但渲染失败的定义”的概率。对已经用 Elastic Stack 监控业务、又想把仪表盘变更纳入代码评审流程的团队，这是比手工点选更快、更可复现的路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Elastic 为搜索与可观测性领域一线上市公司（NYSE: ESTC）官方出品；技能封装的 Dashboards/Visualizations API 是 2026 年新发布的技术预览能力，Elastic Search Labs 官方博客（2026-05-25，作者 Teresa Alvarez Soler、Robert Jaszczurek）专文介绍了该 API 在 AI 仪表盘生成场景下的设计动机 |
| 可用性 | 8 | 文档详尽（图表类型表、网格布局准则、错误速查表齐全），零第三方依赖，提供前置连接测试降低试错成本；但要求 Kibana 9.4+ 技术预览（SNAPSHOT）版本或 Serverless 环境，无法用于当前稳定版部署，且需配置 KIBANA_URL/API Key 等凭据 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 有——运行配套 Node 脚本执行仪表盘/可视化的 CRUD 操作，范围限定在调用用户自己配置的 Kibana REST API；脚本零第三方依赖，逻辑简单直接，未见 eval/动态代码执行 |
| ② 运行时联网外发 | 仅向环境变量指定的 KIBANA_URL/Cloud 端点发起请求，未见向未声明第三方外发数据 |
| ③ API key/凭据 | 通过环境变量（KIBANA_API_KEY/KIBANA_CLOUD_ID/用户名密码）读取，脚本内不落盘存储凭据 |
| ④ 可疑指令 | 通读 SKILL.md 与配套脚本源码，未见 prompt injection 或越权指令 |
| ⑤ 作者/组织信誉 | Elastic 官方（elastic.co，纽交所上市公司 ESTC） |
| ⑥ License | 仓库整体 Apache License 2.0，GitHub API 确认，口径清晰（该子技能自身 package.json 的 license 字段写占位符“tbd”，以仓库根 LICENSE 为准） |
| ⑦ 维护时间 | 该子技能自身最近一次提交 2026-05-28（约 2 个月前），所属仓库整体最近一次提交 2026-07-22，持续维护中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异点 |
|---|---|---|
| kibana-dashboards（本推荐） | Elastic 官方：专精 Kibana Dashboards/Visualizations API 的声明式封装 | 唯一同时给出网格布局设计准则与两套数据源（Data View / ES|QL）写法对照的仪表盘生成技能 |
| kibana-vega（elastic/agent-skills 同仓库） | 用 Vega/Vega-Lite 语法在 Kibana 中构建超出标准图表能力的自定义可视化 | 面向需要突破 Lens 标准图表限制的高级场景，但要求掌握 Vega 语法、仅支持 ES|QL 数据源，学习门槛更高 |
| grafana-oss（grafana/skills） | 覆盖 Grafana OSS 全套运维面：仪表盘 provisioning、数据源接入、用户角色、grafana.ini 服务端配置、插件安装 |
仪表盘只是其覆盖范围之一，胜在运维广度；在图表类型对照、网格布局规则等仪表盘制作细节上不如本推荐专精 |
| antv-g2-chart（antvis/chart-visualization-skills） | 通用 Web 图表库（G2 v5），产出可嵌入任意前端应用的独立图表组件 | 不依赖、不对接任何运维数据平台，胜在通用性；但不具备仪表盘发布、版本控制部署等操作型工作流能力 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
elastic/agent-skills 合集还包含 Cloud、Elasticsearch、Kibana 其余 7 项、Observability、Security 共 30 余个技能，官方 README 建议按需安装、避免一次装太多技能增加路由上下文负担。仓库整体最近一次提交为 2026-07-22，处于持续迭代中。
10. 安装使用方式
- 方式一（推荐，精确安装单个技能）：
npx skills add elastic/agent-skills --skill kibana-dashboards - 方式二（Claude Code 插件市场，安装整组 Kibana 技能）：先执行
claude plugin marketplace add https://github.com/elastic/agent-skills，再执行claude plugin install kibana@elastic-agent-skills - 方式三（GitHub Copilot CLI）：
copilot plugin marketplace add elastic/agent-skills，再copilot plugin install kibana@elastic-agent-skills - 方式四（手动）：clone 仓库后把
skills/kibana/kibana-dashboards子目录复制到自己项目的技能目录 - 安装后需配置 Kibana 连接信息（
KIBANA_CLOUD_ID+KIBANA_API_KEY，或KIBANA_URL+API Key/用户名密码），先运行node scripts/kibana-dashboards.js test验证连接再开始使用 - 安装后建议重启 Claude Code 会话（官方 README 提示
/reload-plugins可能不会立即生效）
11. 注意事项
- 要求 Kibana 9.4+（技术预览/SNAPSHOT 版本）或 Elastic Serverless，无法在当前稳定版 Kibana 上使用
- ES|QL 可视化不能通过独立的
/api/visualizations端点创建，必须作为 dashboard 内嵌面板创建——文档已将其列为已知限制而非缺陷 - 技能标注为 Technical Preview，Elastic 官方声明后续可能随评估结果调整
- 与 OpenClaw、Hermes Agent 的兼容性未经官方验证，建议自行测试
- 技能本身不提供 Kibana 环境搭建指引，需要用户已具备可访问的部署及相应凭据