1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | grafana-oss-grafana-skills（所属仓库自述名称为 “Grafana Skills”，本子技能自身标题为 “Grafana OSS”，故单列记录） | GitHub API / 仓库 README |
| 作者/维护者 | Grafana Labs（官方组织 grafana） |
GitHub API |
| 来源链接 | https://github.com/grafana/skills/tree/main/skills/grafana-core/grafana-oss | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars / Forks | 所属仓库 195★ / 17 forks（注：该数字属整个技能合集，不代表本技能个体热度） | GitHub API |
| 最新版本 | 仓库尚无正式 Release，以 main 分支持续更新为准（最近一次提交为 2026-07-17） | GitHub API |
| 安装方式 | npx skills add grafana/skills，或 Claude Code 专用插件市场安装 |
仓库文档 |
2. 功能介绍与亮点
grafana-oss 是 Grafana 官方 grafana/skills 仓库中，负责 Grafana OSS 核心配置的技能，覆盖从零搭建可观测性看板的整条链路：
- 仪表盘与数据源的声明式配置：教 agent 用 YAML 从磁盘 provision 仪表盘、配置 Prometheus/Loki/Tempo/Pyroscope 等数据源，而非手动点界面
- 权限与账号管理：内置角色分配（Viewer/Editor/Admin/GrafanaAdmin）、服务账号与 Token 创建流程
- 每一步都自带验证：每个操作后附带具体的 curl 校验命令（如查健康检查接口、拉取仪表盘 UID），返回值含义写得很直白，出错时能直接定位是配置没生效还是权限不对
- 覆盖 server 层配置：grafana.ini 里的 SMTP/OAuth 等常见运维配置也有对应指引
亮点：官方出品、SKILL.md 内容来自 Grafana 官方文档整理（非 AI 臆造）、配套 references/ 目录做深入查阅、仓库整体遵循开放的 Agent Skills 标准而非私有格式。
3. 适用场景
固定分类：DevOps 与基础设施
- 需要给项目接入 Grafana 监控、但不熟悉 provisioning YAML 语法的团队
- 已有 Grafana 但缺少标准化配置流程（例如权限混乱、服务账号手工创建易出错）的运维人员
- 想用 agent 自动化仪表盘/数据源部署，纳入 GitOps 流程的 SRE
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库提供
claude plugin marketplace add官方安装路径 - Codex：原生支持——README 明确说明通过
.agents-plugin/marketplace.json自动发现，无需手动配置 - OpenClaw：未验证——官方文档未提及
- Hermes Agent：未验证——官方文档未提及
5. 推荐理由
Grafana 是可观测性领域最广泛部署的开源工具之一，但 provisioning YAML、RBAC、服务账号这类配置极易写错却又缺乏即时反馈。这份技能把 Grafana 官方文档拆解成可执行步骤，且每步都自带 curl 验证命令，能让 agent 在配置出错时精确定位原因，而不是让用户对着空白仪表盘排查半天。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Grafana Labs 官方出品，已被 mcpmarket.com、claudepluginhub.com 等多个第三方 Agent Skill 目录收录；但技能仓库本身 2026 年 3 月才创建，绝对 star 数（195）和子目录自身独立提交记录（3 次）都还年轻，未达一线爆款量级 |
| 可用性 | 8 | npx skills add 一条命令即可安装，多 agent 安装路径齐全；SKILL.md 文档详尽且每步带校验命令；近一周内仍有提交，维护活跃；无需付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单： ① Shell 命令执行——仅限 curl 校验用户自己 Grafana 实例的接口，范围明确 ② 联网外发——仅连接用户指定的 Grafana 实例地址，无未声明的第三方外联 ③ API Key/凭据——需要用户自备 Grafana service account token，仅在本地会话中使用，存储方式由用户自行决定 ④ SKILL.md 与脚本内容检查——未发现可疑指令或 prompt injection 迹象 ⑤ 作者信誉——Grafana Labs，知名开源可观测性公司 ⑥ License——Apache-2.0，清晰 ⑦ 维护时间——近一周内有提交，非弃置项目
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 grafana-oss 的差异 |
|---|---|---|
| grafana-oss（本技能） | Grafana OSS 核心配置：仪表盘、数据源、RBAC、服务账号 | 开源自托管/Cloud 均可，配置模型是声明式 YAML + API |
| dd-apm（Datadog 官方） | Datadog APM 分布式追踪与自动埋点，按 K8s/Linux 环境分流 | 商业 SaaS，强调自动埋点、开箱即用，但不支持自托管 |
| elasticsearch-esql（Elastic 官方） | 教 agent 生成 ES|QL 查询语言，服务已有 Elasticsearch/Kibana 部署的日志与指标分析 | 聚焦查询语言生成而非可视化层配置；技能本身甚至内置 PromQL 兼容命令，方便从 Grafana/Prometheus 迁移过来的团队查询 ES 数据 |
grafana-oss 更适合“从零配置可观测性看板”这一环节，dd-apm 和 elasticsearch-esql 则分别解决“自动埋点”和“查询语言”这两个下游环节的问题，三者组合可覆盖可观测性全链路而非互相替代。
8. 用户评价
grafana/skills 已被 mcpmarket.com、claudepluginhub.com、openagentskill.com、mcp.directory 等第三方 Agent Skill 目录收录，但目前尚未见到具名用户在社区平台发表的使用点评。
9. 其他补充
grafana-oss 隶属于仓库的 grafana-core 插件组，通过 Claude Code 安装该插件组时会连带装入 dashboarding（仪表盘编排）、promql（查询语法）、alerting-irm（告警与值班）、alloy、beyla、opentelemetry 共 6 个相邻技能，并非单独安装。仓库整体覆盖 7 大插件组、40 余个细分技能，grafana-oss 只是其中面向核心配置场景的一个。
10. 安装使用方式
- 通用（推荐多数工具）：
npx skills add grafana/skills - Claude Code：先
claude plugin marketplace add grafana/skills，再claude plugin install grafana-core@grafana-skills - Cursor：同样执行
npx skills add grafana/skills，会写入项目内的.cursor/skills/ - Codex 及其他遵循 Agent Skills 标准的工具：通过仓库自带的
.agents-plugin/marketplace.json自动发现，无需手动配置
安装后无需重启，agent 会在检测到用户在做 Grafana 相关任务（如“配置 Prometheus 数据源”）时自动加载对应 SKILL.md。实际执行验证步骤前，需要用户自备一个可访问的 Grafana 实例（自托管或 Grafana Cloud）及具备相应权限的 API token。
11. 注意事项
- 该技能所在仓库创建于 2026 年 3 月，相对年轻，尚未形成成熟的第三方评价生态
- Claude Code 安装粒度是整个
grafana-core插件组而非单个技能，会连带装入 6 个相邻技能 - OpenClaw、Hermes Agent 的兼容性未在官方文档中提及，使用前建议自行验证
- 本技能只覆盖 Grafana OSS 核心配置，若需要 PromQL 查询编写、告警规则设计等进阶能力，需额外安装同仓库的 promql、alerting-irm 等技能
- 仓库尚无正式 Release 版本号，长期跟踪建议关注 commit 而非 tag