Agent Skills
› grafana/skills
grafana/skills
GitHub指导在grafana-app-sdk中实现资源的准入控制，包括编写验证器和突变处理程序。支持拦截资源创建/更新请求，进行校验或修改，涵盖Webhook配置及代码示例。
Install All Skills
npx skills add grafana/skills --all -g -y
Skills in Collection (50)
指导在grafana-app-sdk中实现资源的准入控制，包括编写验证器和突变处理程序。支持拦截资源创建/更新请求，进行校验或修改，涵盖Webhook配置及代码示例。
write a validator
add validation
implement admission control
write a mutating webhook
validate incoming resources
npx skills add grafana/skills --skill admission-control -g -y
用于评估、审计和优化 Grafana Loki 标签策略的专家技能。通过分析基数、访问模式及静态动态规则，诊断查询性能问题，提供结构化建议，防止因高基数标签导致的索引膨胀和查询缓慢。
评估或审计 Loki 标签策略
询问为什么 Loki 查询速度慢
npx skills add grafana/skills --skill loki-label-analyzer -g -y
提供将遥测数据（指标、日志、链路追踪）发送至 Grafana Cloud 的配置指南，涵盖 Alloy 管道、Prometheus 远程写入、Loki 推送及 OTLP SDK 集成方法。
配置 Grafana Cloud 数据接入
设置 Prometheus 远程写入
配置 Loki 日志推送
集成 OpenTelemetry 发送链路数据
npx skills add grafana/skills --skill send-data -g -y
根据插件名称生成Grafana数据源的基础设施即代码配置（YAML或Terraform），自动解析插件ID、版本及设置Schema，支持从零开始或转换现有数据源。
用户需要为Grafana配置数据源
请求生成数据源的YAML或Terraform代码
提及Grafana插件的数据源 provision
npx skills add grafana/skills --skill datasources-provisioning -g -y
Grafana Loki日志聚合与LogQL查询技能，涵盖语法、架构、 ingestion配置及管道排错，用于编写查询和分析日志。
编写LogQL查询语句
配置Loki或采集器
排查日志管道故障
分析结构化或非结构化日志
npx skills add grafana/skills --skill loki -g -y
提供Prometheus与Grafana指标监控的PromQL查询参考、告警规则配置、Alertmanager路由及录制规则指南，用于解决监控体系搭建与运维问题。
编写PromQL查询语句
配置Prometheus告警规则
设置Alertmanager通知路由
优化监控性能录制规则
npx skills add grafana/skills --skill prometheus -g -y
针对JavaScript项目，使用pnpm审计并精简依赖。通过检查npm配置、移除无用依赖、去重版本及分析传递闭包，提供保留、替换或移除建议，旨在缩小node_modules体积和lockfile大小。
清理pnpm依赖
减小lockfile体积
缩减Grafana插件的node_modules
npx skills add grafana/skills --skill audit-and-reduce-dependencies -g -y
对JS/TS项目的npm/yarn/pnpm配置进行只读供应链安全审计，验证工具版本、禁用生命周期脚本、限制不安全依赖协议及最小发布年龄。
用户请求审计包管理器安全性
检查supply-chain hardening配置
npx skills add grafana/skills --skill check-npm -g -y
提供Grafana监控技能模板，涵盖概述、核心概念（如PromQL示例）、常见模式及最佳实践。用于指导AI掌握Grafana特定知识，避免重复解释通用编程概念，并建议将详细参考材料移至独立文件以保持简洁。
Grafana配置
PromQL查询
监控面板设计
可视化最佳实践
npx skills add grafana/skills --skill your-skill-name -g -y
用于初始化、脚手架生成及配置 Grafana App Platform 应用。涵盖 CLI 安装、多部署模式选择、CUE Schema 驱动的代码生成及业务逻辑实现，支持从新建应用到环境配置的全流程引导。
创建新的 Grafana 应用
初始化 SDK 项目
选择部署模式
代码生成与同步
npx skills add grafana/skills --skill app-sdk-concepts -g -y
用于为grafana-app-sdk应用创建CUE Kind定义，涵盖资源类型脚手架、版本管理、字段约束及代码生成配置。支持添加新Kind、扩展版本及编写Schema，适用于建模资源和定制API结构。
添加新的CUE Kind或资源类型
为现有Kind添加新版本
编写CUE Schema字段约束
定义可复用的Named Type
运行代码生成或修复CUE错误
npx skills add grafana/skills --skill cue-kind-definition -g -y
实现 grafana-app-sdk 的 Reconciler 和 Watcher，处理资源生命周期事件、状态更新及控制器注册。适用于编写异步业务逻辑、事件驱动处理和控制器开发任务。
编写 reconciler 或 controller
实现 reconcile 循环
处理资源创建/更新/删除事件
添加异步业务逻辑
npx skills add grafana/skills --skill reconciler-logic -g -y
通过自适应聚合规则降低Grafana Cloud指标成本，自动推荐高基数标签处理、自定义丢弃规则及未使用指标检测，优化活跃序列数以减少账单。
调查高昂的Grafana Cloud账单
寻找高基数标签（如pod_uid, version）
用户提及减少基数或指标支出
npx skills add grafana/skills --skill adaptive-metrics -g -y
管理Grafana Cloud账号、组织及Stack，涵盖RBAC角色分配、SSO/SAML配置、服务账户创建及团队入职。通过API或Terraform实现自动化资源供应与访问控制，适用于云基础设施管理与运维安全场景。
配置SSO/SAML/OAuth认证
创建或管理Grafana Stack
设置RBAC角色与服务账户
邀请用户并管理团队权限
npx skills add grafana/skills --skill admin -g -y
配置Grafana Cloud应用、前端及AI可观测性，涵盖APM、RUM和LLM监控。用于搭建链路追踪、性能分析及成本监控。
set up APM
show service map
monitor browser perf
session replay
RUM SDK
watch our OpenAI bill
npx skills add grafana/skills --skill app-observability -g -y
指导配置 Grafana MCP Server，使 Claude Code、Cursor 等 AI 编程代理通过 stdio 或 SSE 协议连接 Grafana Cloud，实现指标查询与仪表板管理。
配置 AI 代理访问 Grafana
安装和设置 mcp-grafana 服务
Claude Code 或 Cursor 集成监控工具
npx skills add grafana/skills --skill assistant-mcp -g -y
指导用户在Grafana Cloud中配置和排查AWS、Azure及Confluent等云提供商的集成，包括设置托管导出器、IAM权限及Firehose接收器。
配置AWS CloudWatch集成
设置Azure Monitor
安装Grafana集成
使用AWS Firehose
云监控故障排除
npx skills add grafana/skills --skill cloud-integrations -g -y
用于降低Grafana Cloud账单，通过配置Alloy标签进行成本分摊，利用自适应信号减少指标基数、过滤日志及采样 traces，并设置用量告警。
Grafana Cloud 账单过高
需要按团队或服务分摊可观测性成本
降低活跃指标系列数或日志字节量
设置用量配额告警
npx skills add grafana/skills --skill cost-management -g -y
为MySQL和PostgreSQL配置Grafana Cloud数据库可观测性，包括启用性能监控、创建最小权限用户及配置Alloy组件。用于监控DB性能、诊断慢查询、关联APM追踪及设置告警。
监控数据库性能
诊断慢查询
设置数据库可观测性
关联数据库指标与APM
对查询延迟设置告警
npx skills add grafana/skills --skill database-observability -g -y
Grafana PS CLI工具，按每分钟数据点数(DPM)对Prometheus指标排序，辅助排查高云账单、识别高基数指标及优化成本。
Grafana Cloud账单过高
查找最大消耗指标
识别基数异常指标
优化Prometheus成本
npx skills add grafana/skills --skill dpm-finder -g -y
管理Grafana Alloy采集器集群，支持通过OpAMP远程分发Pipeline配置、属性匹配目标及热更新。涵盖配置创建、语法校验、部署验证及故障排查，适用于大规模Agent集中化管理场景。
配置Alloy远程下发
批量推送Pipeline到采集器
排查REMOTE_CONFIG_STATUS_FAILED
使用OpAMP管理Agent
验证River语法
npx skills add grafana/skills --skill fleet-management -g -y
用于将Kubernetes集群、主机、容器及云提供商遥测数据接入Grafana Cloud。涵盖Helm部署、Alloy配置、多云指标拉取及故障排查，适用于监控基础设施的场景。
onboarding a new cluster or VM fleet to Grafana Cloud
picking the right Helm values for K8s scraping
wiring kube-state-metrics + node-exporter + cAdvisor
alerting on PodCrashLooping / node memory / PVC capacity
pulling AWS / Azure / GCP cloud metrics
monitor my cluster
send K8s metrics to Grafana
scrape EC2 metrics
cluster pod logs
install the monitoring helm chart
npx skills add grafana/skills --skill infrastructure -g -y
提供Grafana Cloud的AI/ML功能，包括自然语言转查询、动态异常检测告警、自动化根因分析及LLM插件集成，支持智能监控与故障排查。
用户希望使用自然语言生成PromQL或LogQL查询
需要配置基于机器学习的动态告警而非静态阈值
请求自动进行事故根因分析(RCA)或Sift调查
需要将LLM（如Claude/OpenAI）集成到Grafana中
npx skills add grafana/skills --skill ml-ai -g -y
管理Grafana OnCall/IRM的告警路由、值班轮换及事件响应。支持集成Alertmanager等源，配置Jinja2路由模板、升级链及日历排班，实现Slack ChatOps交互与P1-P4事件生命周期自动化处理。
配置告警接收器与路由规则
设置值班人员轮换表
定义事件升级策略
接入Slack通知或ChatOps操作
处理告警自动解决逻辑
npx skills add grafana/skills --skill oncall-irm -g -y
配置Grafana Cloud私有网络连接（如AWS PrivateLink），通过VPC端点实现遥测数据内网传输，避免公网暴露和出口费用，满足合规要求。
配置云服务商私有端点以连接Grafana Cloud
减少遥测数据公网出口费用
满足PCI-DSS或HIPAA等数据驻留合规要求
npx skills add grafana/skills --skill private-connectivity -g -y
诊断 Prometheus 高基数问题（如内存溢出、慢查询、账单激增）的指南。提供症状排查步骤，强调禁止错误删除标签，推荐安全修复方案或路由至其他专用技能。
Prometheus OOM 或内存持续增长
PromQL 查询缓慢或失败
Grafana Cloud 活跃系列数或 DPM 账单异常飙升
接收样本报错 'too many samples'
npx skills add grafana/skills --skill prometheus-cardinality-troubleshooter -g -y
评估和优化Prometheus标签策略，通过审计和重构防止高基数问题。强调在应用代码层面避免不良标签，严禁删除唯一标识符以防数据损坏，并指导如何正确设计标签模式以控制存储成本。
用户请求评估或审计Prometheus标签
询问如何从源头防止高基数
需要设计或改进标签Schema
npx skills add grafana/skills --skill prometheus-label-strategy -g -y
用于编写和配置 Grafana Cloud 合成监控检查，涵盖 HTTP、脚本及浏览器检查。指导用户根据单迭代执行模型正确创建可用性检测，区分于负载测试，并提供部署与验证方法。
编写合成监控检查
验证生产环境关键业务流程
将 k6 脚本转换为监控检查
查询多区域站点可用性
npx skills add grafana/skills --skill synthetic-monitoring-checks -g -y
提供Grafana Cloud测试能力，涵盖合成监控、k6分布式负载测试及Faro前端可观测性。支持多区域探针探测、发布门禁负载测试、TLS证书监控及前端性能指标追踪，用于保障API/网站可用性与前端用户体验。
检查网站或API在多个区域的可用性
基于负载测试结果进行发布门禁
监控TLS证书过期时间
为React/Vue应用集成前端监控SDK
追踪Core Web Vitals等性能指标
将前端错误与后端链路追踪关联
npx skills add grafana/skills --skill testing -g -y
用于配置Grafana告警、事件响应管理(IRM)及SLO的全流程技能。涵盖告警规则创建、通知路由、联系人设置、值班轮班及SLO定义，支持通过API或YAML进行基础设施即代码管理。
配置告警规则
调试通知路由
设置值班轮班
管理 incidents
定义 SLO
用户要求报警或页面通知
npx skills add grafana/skills --skill alerting-irm -g -y
用于构建统一遥测管道，收集指标、日志、追踪和性能分析数据并发送至Grafana生态。涵盖配置编写、验证、运行及调试，支持K8s发现、OTLP接入和日志处理等场景。
配置Telemetry采集管道
替换Grafana Agent或OTel Collector
调试遥测数据发送问题
编写Prometheus/Loki/Tempo抓取配置
npx skills add grafana/skills --skill alloy -g -y
通过eBPF技术对HTTP/gRPC/DB流量进行零代码自动插桩，无需修改源码或重启应用。支持Docker及K8s DaemonSet部署，将OTLP追踪和Prometheus指标发送至Grafana Cloud或Tempo/Mimir，适用于遗留系统或闭源二进制文件的可观测性接入。
为无法重新编译的服务添加可观测性
对闭源二进制文件进行追踪
实现零代码APM
在集群范围内部署eBPF可观测性代理
npx skills add grafana/skills --skill beyla -g -y
通过 HTTP API 自动化构建、修改和发布 Grafana 仪表板 JSON。支持面板配置、变量模板、数据转换及部署注解，并提供 API 推送与版本验证工作流。
创建或导出仪表板 JSON
添加服务下拉变量
计算错误率等指标列
覆盖部署作为注解
通过 API 推送仪表板
npx skills add grafana/skills --skill dashboarding -g -y
用于配置Grafana OSS，支持通过YAML自动化配置数据源、仪表盘及插件，管理RBAC角色与服务账户令牌，调整服务器配置，并提供API健康检查以验证配置生效。
配置Prometheus/Loki等数据源
从Git或磁盘自动预置仪表盘
创建服务账户并生成访问令牌
配置SSO/OAuth或SMTP
排查仪表盘未显示问题
npx skills add grafana/skills --skill grafana-oss -g -y
指导为各类应用配置 OpenTelemetry，将指标、日志和链路追踪数据发送至 Grafana Cloud 或自托管后端。涵盖自动注入、认证、Alloy 采集及采样策略。
配置 OpenTelemetry SDK
发送遥测数据到 Grafana
调试 spans 未显示问题
设置 OTLP 环境变量
npx skills add grafana/skills --skill opentelemetry -g -y
提供PromQL查询编写、验证与优化指南，涵盖速率计算、聚合、直方图分位数、SLO燃烧率及性能调优等模式，辅助排查指标异常与慢查询。
编写Prometheus查询
修复错误的p95/p99延迟指标
构建错误预算告警
调试缓慢的监控查询
分析高基数标签问题
npx skills add grafana/skills --skill promql -g -y
指导如何编写、审查和优化Grafana SKILL.md文件，确保符合Anthropic规范和CI门禁标准。涵盖触发描述撰写、渐进式披露结构、四维度评分rubric及验证修复流程，适用于新建技能、PR审查或优化低分技能。
创建新的 skill
审查 skill PR
skill 的 Tessl 评分低于 75
skill 描述未被代理正确触发
重构长 SKILL.md 为 bundle
用户询问如何编写、改进、优化、审计或修复 skill
npx skills add grafana/skills --skill skill-authoring -g -y
用于调查Grafana Cloud k6测试和运行结果的标准化工作流。涵盖脚本分析、运行历史查询、通过/失败状态判定及原始指标日志提取，支持故障诊断与脚本安全编辑。
询问测试是否通过或失败原因
提供k6测试或运行URL
请求查看特定运行的指标或日志
诊断运行异常或检查失败
npx skills add grafana/skills --skill k6-cloud-investigate-test -g -y
用于撰写、审查 k6 相关文档（含用户指南、发布说明及 TypeScript 类型定义）。需遵循风格规范，执行代码示例验证，并覆盖 k6-docs、k6-DefinitelyTyped 等仓库。
编写或编辑 k6 文档
审查 k6 发布说明
生成 TypeScript 类型定义
验证代码示例
npx skills add grafana/skills --skill k6-docs -g -y
管理Grafana Cloud k6负载测试、脚本、项目及运行状态，支持通过gcx CLI或curl获取指标日志。适用于查询测试失败原因、调整项目限制、执行本地或云端脚本等性能测试运维场景。
用户提及k6云测试或运行结果
需要列出、编辑、创建、启动或中止k6负载测试
请求获取特定测试运行的日志或指标数据
需要管理k6项目配额、计划或更新测试脚本
需要在本地或通过k6 cloud run执行测试脚本
npx skills add grafana/skills --skill k6-manage -g -y
针对公开网站使用k6进行端到端性能、负载及压力测试。自动生成混合协议与浏览器测试套件，包含SLO阈值、监控旁路及Grafana排查方案，确保功能测试通过后再执行负载测试。
perf test my site
performance test my site
load test this URL
stress test my web app
I want to load test [URL]
set up k6 against my website
write a k6 suite for [site]
see if my site handles N concurrent users
how does my site perform under traffic
npx skills add grafana/skills --skill k6-perf-test-website -g -y
用于维护和改进现有k6测试脚本，涵盖阈值调整、版本迁移、服务变更适配、代码重构及最佳实践审计。支持修复失败测试并严格区分语法与行为变更以确保安全。
修复失败的k6测试
收紧阈值
迁移到新版k6
服务变更后更新脚本
重构k6测试代码
应用最佳实践
npx skills add grafana/skills --skill k6-test-maintenance -g -y
分析Grafana Cloud k6测试运行趋势，检测P95延迟等指标缓慢劣化，计算阈值余量并推荐调整。适用于询问性能趋势、退化检查或阈值收紧建议的场景。
how is my test trending
is P95 getting worse
check for performance regression
should I tighten thresholds
are my tests degrading
npx skills add grafana/skills --skill k6-trend-analysis -g -y
用于生成、验证和审查k6性能测试脚本的Skill，覆盖HTTP、WebSocket、gRPC及浏览器自动化等场景。支持加载模式配置、阈值设置及自定义指标，通过执行脚本确保代码可用性，适用于负载、压力及功能测试开发。
需要编写或生成k6性能测试脚本
对现有k6脚本进行验证或调试
查询k6特定协议（如gRPC/WebSocket）或扩展库用法
配置负载测试的执行器、阈值或自定义指标
npx skills add grafana/skills --skill k6 -g -y
提供Grafana Mimir的部署、配置与运维指南，支持Prometheus和OTLP指标存储。涵盖本地Docker及K8s Helm安装、多租户配置、远程写入集成及故障排查，适用于扩展Prometheus或替代Cortex的场景。
需要长期Prometheus存储
扩展Prometheus单节点限制
搭建多租户指标后端
替换Cortex
配置remote_write目标
npx skills add grafana/skills --skill mimir -g -y
提供应用持续性能分析能力，支持多语言SDK、Alloy eBPF无侵入采集及ProfileQL查询。用于生成CPU/内存火焰图，定位性能热点，关联Trace与Profile，排查资源瓶颈及回归问题。
添加服务性能剖析
部署集群级eBPF监控
通过火焰图查找CPU或内存热点
对比不同版本Profile以发现性能回归
将慢速Trace与Profile进行关联分析
npx skills add grafana/skills --skill pyroscope -g -y
部署Grafana Tempo分布式追踪后端，配置对象存储与多租户，通过TraceQL查询慢请求或错误，调试链路数据缺失，以及关联日志、指标和性能分析。
部署 Tempo 追踪后端
编写 TraceQL 查询慢请求
调试 Explore 中无追踪数据
配置 S3/GCS/Azure 块存储
设置追踪-日志-指标关联
npx skills add grafana/skills --skill tempo -g -y
提供基于@grafana/scenes框架构建Grafana插件页面的指南，涵盖场景树结构、页面创建、变量配置、面板构建及钻取导航等核心功能。
创建新的Grafana场景页面
添加或配置数据面板和可视化组件
设置钻取导航或标签页逻辑
定义查询运行器和数据转换器
npx skills add grafana/skills --skill grafana-scenes -g -y
指导优化Grafana应用插件的包体积，通过React.lazy和Webpack代码分割减少模块加载时间。提供风险分级策略及CI监控配置方法。
优化插件包体积
module.js过大
插件加载缓慢
代码分割插件
减少初始JS负载
实现Suspense懒加载
npx skills add grafana/skills --skill plugin-bundle-size -g -y
指导将Grafana插件迁移至React 19兼容性，包括检测上下文、扫描兼容性问题、更新脚手架及修复JSX运行时等步骤。
update plugin for React 19
React 19 migration
prepare for React 19
plugin React 19 compat
npx skills add grafana/skills --skill react-19-plugin-migration -g -y
