К основному содержанию
скилл CX Codex

grafana-expert — скилл для Claude Code: дашборды и алерты Grafana

Скилл grafana-expert превращает агента в инженера по Grafana: дашборды из JSON, переменные, алерты и провижининг в Kubernetes.

Apache-2.0 266 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill grafana-expert -a claude-code
Открыть на GitHub

Что делает 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 и refresh 30s.
  • Почисти этот dashboard JSON: убери хардкод namespace и добавь единицы измерения.
  • Поставь Grafana в кластер через kubectl и провижинь дашборды из ConfigMap.

Как установить grafana-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill grafana-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/grafana-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/grafana-expert/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
grafana-dashboards Seth Hobson Скилл grafana-dashboards для Claude Code помогает создавать Grafana-дашборды для метрик систем и приложений. Дашборды используются для мониторинга, SLO и операционных интерфейсов наблюдаемости. CX Codex +1 13 097установок grafana-dashboard aj-geddes Скилл grafana-dashboard для Claude Code, Cursor и Codex генерирует JSON-конфигурации дашбордов Grafana с панелями, переменными и алертами. Включается, когда нужно собрать мониторинг приложения или визуализировать метрики из Prometheus. CX Codex +1 503установок grafana sanjeed5 Правило задаёт команде единый стиль работы с дашбордами, алертами и источниками данных Grafana в виде кода: структура, визуальные стандарты, оптимизация запросов. CX Codex +1 ★ 3 589звёзд репо grafana-oss grafana Скилл помогает агенту провизионить дашборды и датасорсы Grafana OSS из YAML, писать JSON панелей и проверять каждый шаг через API. CX Codex +1 6 200установок mcp-grafana grafana Подключается к Grafana: ищет дашборды, читает панели, выполняет PromQL и LogQL запросы, разбирает инциденты и редактирует графики прямо из чата. CX Codex +1 ★ 3 693звёзд репо prometheus-grafana devops-skills Добавляет знания о стеке Prometheus + Grafana. Охватывает сбор метрик, написание PromQL-запросов, построение дашбордов и настройку алертов. CX Codex +1 505установок

Из того же набора104

Весь набор →
git-expert Скилл git-expert для Claude Code даёт агенту рецепты для git: отмены коммита, извлечения работы из main и чистки истории. Разбирает проблемы с git, возникшие посреди работы. CX Codex +1 279установок python-expert Скилл python-expert настраивает ИИ-ассистента на разработку на современном Python: строгая типизация, стандарты PEP 8, асинхронный код, работа с uv, poetry и ruff. CX Codex +1 277установок redis-expert Скилл redis-expert для Claude Code помогает проектировать Redis-кэш, pub/sub и работу с потоками данных. Помогает добавлять Redis в приложение и разбирать его архитектуру. CX Codex +1 272установок php-expert Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок research-expert Скилл research-expert для ИИ-агентов: рабочий код для дизайна исследования и статистики плюс разделы про научное письмо. CX Codex +1 256установок helm-expert Скилл helm-expert для Claude Code помогает разрабатывать Helm-чарты и управлять релизами Kubernetes. Подключается к задачам с чартами, шаблонами и развёртыванием. CX Codex +1 251установок cpp-expert Скилл cpp-expert для Claude Code помогает писать и чинить код на современном C++: C++20/23, STL, владение памятью, конкурентность и CMake. CX Codex +1 250установок ai-engineer-expert Скилл ai-engineer-expert для Claude Code помогает проектировать LLM-интеграции, RAG-системы и production AI. Описывает развёртывание моделей и работу с AI API. CX Codex +1 242установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой