grafana-expert — скилл для Claude Code: дашборды и алерты Grafana
Скилл grafana-expert превращает агента в инженера по Grafana: дашборды из JSON, переменные, алерты и провижининг в Kubernetes.
Apache-2.0 266 установок ★ 45 обновлён 2026-10-12
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a claude-codeЧто делает grafana-expert
Скилл даёт агенту роль инженера по Grafana. Он собирает дашборды из JSON, подбирает типы панелей, настраивает источники данных, шаблонные переменные и алерты. Внутри SKILL.md с правилами и справочник references/CORE_CONCEPTS.md, который агент читает по необходимости: архитектура Grafana, установка в Kubernetes, Dashboard JSON, провижининг.
Отдельный блок — антипаттерны. Агент предложит разбить дашборд, где панелей больше 10–15, вынесет namespace в переменную $namespace, заменит фиксированное окно на $__rate_interval и поставит refresh 30s вместо 5s. Заодно напомнит про единицы измерения и цветовые пороги.
Нужны Grafana 10.0 и выше и Kubernetes 1.28 и выше. Через Bash разрешены kubectl и grafana-cli, так что агент может и поставить Grafana, и провижинить дашборды через ConfigMap. На кластере старее 1.28 манифесты из примеров придётся править.
Какие задачи решает
- собрать дашборд из JSON с переменными и порогами
- привязать аннотации к сработавшим алертам
- провижинить дашборды через ConfigMap в Kubernetes
- разложить перегруженный дашборд на 10–15 панелей
- убрать хардкод namespace и заменить его переменной
Примеры запросов агенту
- Собери дашборд для пода с переменными
$namespaceи$podи refresh30s. - Почисти этот dashboard JSON: убери хардкод namespace и добавь единицы измерения.
- Поставь Grafana в кластер через
kubectlи провижинь дашборды из ConfigMap.
Как установить grafana-expert
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a claude-code2Вручную: положить файлы
~/.claude/skills/grafana-expert/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/grafana-expert/
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a codex2Вручную: положить файлы
.agents/skills/grafana-expert/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a cursor2Вручную: положить файлы
.cursor/skills/grafana-expert/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install personamanagmentlayer/pcl stdlib/devops/grafana-expert2Вручную: положить файлы
.github/skills/grafana-expert/SKILL.md1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a gemini-cli2Командой платформы
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/devops/grafana-expertВручную: положить файлы
.devin/skills/grafana-expert/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о grafana-expert
Как установить grafana-expert в Claude Code?
Выполните npx skills add personamanagmentlayer/pcl --skill grafana-expert -a claude-code. Скилл окажется в ~/.claude/skills/grafana-expert/SKILL.md.
Что делает grafana-expert?
Учит агента собирать дашборды Grafana из JSON: панели, источники данных, шаблонные переменные, алерты и провижининг. Отдельно разбирает типичные ошибки вроде лишних панелей и слишком частого refresh.
Какие версии Grafana и Kubernetes нужны?
Grafana 10.0 и выше, Kubernetes 1.28 и выше. Команды kubectl и grafana-cli скилл запускает через Bash.
Исходный текст
SKILL.md · Apache-2.0
---
name: grafana-expert
version: 1.1.0
description: >-
Expert-level Grafana dashboards, visualization, data sources, alerting, and production
operations. Use when the user mentions dashboards, visualization, monitoring,
observability, or alerting, or when the task involves Grafana Architecture, Installation
on Kubernetes, Data Sources, or Dashboard JSON.
category: devops
author: PCL Team
license: Apache-2.0
tags:
- grafana
- dashboards
- visualization
- monitoring
- observability
- alerting
allowed-tools:
- Read
- Write
- Edit
- Bash(kubectl:*, grafana-cli:*)
- Glob
- Grep
requirements:
grafana: '>=10.0'
kubernetes: '>=1.28'
---
# Grafana Expert
You are an expert in Grafana with deep knowledge of dashboard creation, panel types, data sources, templating, alerting, and production operations. You design and manage comprehensive visualization and observability systems following Grafana best practices.
## Best Practices
### 1. Use Template Variables
```json
// Query with variables
{
"expr": "sum(rate(http_requests_total{namespace=\"$namespace\", pod=~\"$pod\"}[$__rate_interval])) by (pod)"
}
```
### 2. Set Appropriate Refresh Rates
```json
// Dashboard refresh
{
"refresh": "30s" // Production
// "refresh": "1m" // Development
}
```
### 3. Use $\_\_rate_interval
```promql
# Better than fixed interval
rate(http_requests_total[$__rate_interval])
```
### 4. Organize with Folders
```
Dashboards/
├── Kubernetes/
│ ├── Cluster Overview
│ └── Pod Monitoring
├── Applications/
│ ├── API Performance
│ └── Database Metrics
└── Infrastructure/
├── Node Metrics
└── Network Traffic
```
### 5. Use Annotations
```json
{
"annotations": {
"list": [
{
"datasource": "Prometheus",
"enable": true,
"expr": "ALERTS{alertstate=\"firing\"}",
"iconColor": "red",
"name": "Alerts",
"tagKeys": "alertname,severity"
}
]
}
}
```
### 6. Color Thresholds
```json
{
"thresholds": {
"mode": "absolute",
"steps": [
{ "value": null, "color": "green" },
{ "value": 70, "color": "yellow" },
{ "value": 90, "color": "red" }
]
}
}
```
### 7. Dashboard Links
```json
{
"links": [
{
"title": "Related Dashboard",
"url": "/d/xyz/other-dashboard?var-namespace=$namespace",
"type": "link",
"icon": "dashboard"
}
]
}
```
## Anti-Patterns
**1. Too Many Panels:**
```
# BAD: 50+ panels
# GOOD: 10-15 focused panels per dashboard
```
**2. No Variables:**
```json
// BAD: Hardcoded namespace
{
"expr": "sum(rate(http_requests_total{namespace=\"production\"}[5m]))"
}
// GOOD: Use variables
{
"expr": "sum(rate(http_requests_total{namespace=\"$namespace\"}[5m]))"
}
```
**3. Short Refresh Intervals:**
```json
// BAD: Too frequent
"refresh": "5s"
// GOOD: Reasonable rate
"refresh": "30s"
```
**4. No Units:**
```json
// GOOD: Always specify units
{
"unit": "bytes",
"decimals": 2
}
```
## Approach
When creating Grafana dashboards:
1. **Start with Goals**: Define what you want to monitor
2. **Use Variables**: Make dashboards reusable
3. **Golden Signals**: Latency, Traffic, Errors, Saturation
4. **Organize**: Use folders and consistent naming
5. **Test**: Verify queries and thresholds
6. **Document**: Add descriptions and links
7. **Version Control**: Store JSON in Git
8. **Provision**: Use ConfigMaps for automation
Always design dashboards that are clear, actionable, and maintainable.
## Reference Documentation
Detailed material lives alongside this skill and is read on demand:
- [Core Expertise](references/CORE_CONCEPTS.md) — Grafana Architecture, Installation on Kubernetes, Data Sources, Dashboard JSON, Panel Types, Variables (Templating), Alerting, Dashboard Provisioning
## Resources
- Grafana Documentation: https://grafana.com/docs/
- Dashboard Best Practices: https://grafana.com/docs/grafana/latest/best-practices/
- Community Dashboards: https://grafana.com/grafana/dashboards/
- Grafana Plugins: https://grafana.com/grafana/plugins/
© PCL Team · Apache-2.0 · personamanagmentlayer/pcl