Grafana Skills

July 30, 2026 · View on GitHub

Validate Marketplace Lint Skills

Public skills for working with Grafana, Prometheus, Loki, Tempo, Pyroscope, k6, and the broader LGTM observability stack. Compatible with Claude Code, Cursor, Codex, and any tool supporting the Agent Skills open standard.

Installation

Any tool following the Agent Skills standard can install directly:

npx skills add grafana/skills

Claude Code

# Add this marketplace
claude plugin marketplace add grafana/skills

# Install the plugin(s) you want
claude plugin install grafana-plugins@grafana-skills
claude plugin install grafana-core@grafana-skills
claude plugin install grafana-cloud@grafana-skills
claude plugin install grafana-lgtm@grafana-skills
claude plugin install grafana-app-sdk@grafana-skills
claude plugin install grafana-k6@grafana-skills
claude plugin install grafana-datasources@grafana-skills

Cursor

Install via the npx skills command shown above:

npx skills add grafana/skills

This writes skills into .cursor/skills/ in your project so Cursor's agent can load them.

Cursor's built-in Add Rule → Remote Rule (GitHub) flow is not compatible with this repository. That importer only accepts Cursor Project Rules (.mdc files under .cursor/rules/), and the Grafana Skills repo follows the Agent Skills standard instead (SKILL.md files under skills/).

Codex and other Agent Skills tools

Skills are discovered automatically via the .agents-plugin/marketplace.json manifest. No manual setup needed — Codex loads matching skills based on your task context.

To install manually into a repo's .agents/skills/ directory:

npx skills add grafana/skills

Available Skills

Skills are organized into plugin groups. All skill files live under skills/<plugin-name>/.

grafana-core

Core Grafana concepts — dashboards, visualization, PromQL, alerting, and telemetry collection.

SkillDescription
grafana-ossGrafana OSS core — dashboards, data sources, provisioning, RBAC, and server configuration
dashboardingCreate and organise Grafana dashboards — panels, variables, transformations, and thresholds
promqlWrite, validate, and optimise PromQL queries for Prometheus and Grafana Cloud Metrics
alerting-irmGrafana Alerting, Incident Response Management, and SLOs — rules, contact points, and on-call
alloyGrafana Alloy OpenTelemetry collector — config language, components, and telemetry pipelines
beylaGrafana Beyla eBPF auto-instrumentation for zero-code application observability
opentelemetryOpenTelemetry with the Grafana stack — SDK instrumentation, OTLP, and collectors

grafana-cloud

Grafana Cloud — fleet management, cloud integrations, cost optimization, and AI agent connectivity.

SkillDescription
adminGrafana Cloud account management — organizations, stacks, RBAC, SSO, and service accounts
send-dataSend telemetry to Grafana Cloud — metrics, logs, traces, and profiles via Alloy or SDKs
fleet-managementManage Grafana Alloy collector fleets with remote configuration and OpAMP
cloud-integrationsConnect AWS, Azure, and other cloud providers to Grafana Cloud
infrastructureInfrastructure monitoring — Kubernetes, host/container metrics, and cloud integrations
app-observabilityApplication Observability (APM), Frontend Observability (Faro), and AI Observability
database-observabilityQuery-level performance insights for MySQL and PostgreSQL
adaptive-metricsReduce metrics cost with Adaptive Metrics aggregation rules and cardinality management
cost-managementGrafana Cloud cost monitoring, attribution, usage alerts, and optimization
dpm-finderIdentify Prometheus metrics driving high Data Points per Minute (DPM)
loki-label-analyzerEvaluate and improve Loki label strategy using cardinality, query patterns, and label hygiene
prometheus-label-strategyAudit and design Prometheus label schemas — cardinality, histograms, source-side prevention
prometheus-cardinality-troubleshooterDiagnose live Prometheus cardinality issues — slow queries, OOMs, high Active Series bills
oncall-irmGrafana OnCall and IRM — alert routing, escalation chains, and incident lifecycle
ml-aiAI/ML features — Grafana Assistant, Dynamic Alerting, Sift, Knowledge Graph, and LLM Plugin
assistant-mcpConnect AI coding agents (Claude Code, Cursor, Codex) to Grafana Cloud via MCP
private-connectivityPrivate network connectivity — AWS PrivateLink, Azure Private Link, GCP Private Service Connect
testingSynthetic Monitoring, k6 Cloud load testing, and Frontend Observability
synthetic-monitoring-checksAuthor Synthetic Monitoring checks — k6 scripted and browser check deep dive, check-type selection, API/Terraform

grafana-lgtm

Open-source LGTM observability stack — Loki, Tempo, Prometheus/Mimir, and Pyroscope.

SkillDescription
lokiLog aggregation with Grafana Loki — LogQL queries, pipelines, and architecture
tempoDistributed tracing with Grafana Tempo — TraceQL, service graphs, and correlations
prometheusMetrics with Prometheus — PromQL, alerting, recording rules, and Mimir
mimirScalable long-term metrics storage with Grafana Mimir — architecture and operations
pyroscopeContinuous profiling with Grafana Pyroscope — flame graphs, diff views, and language support

grafana-plugins

Skills for building Grafana plugins — bundle optimisation, code splitting, React 19 migration, dependency audits, and the @grafana/scenes framework.

SkillDescription
plugin-bundle-sizeOptimise Grafana app plugin bundle size using React.lazy, Suspense, and webpack code splitting
react-19-plugin-migrationMigrate a Grafana plugin to React 19 compatibility ahead of Grafana 13
grafana-scenesBuild Grafana plugin pages using the @grafana/scenes framework
check-npmAudit npm, yarn, or pnpm package manager configuration for supply-chain hardening
audit-and-reduce-dependenciesReduce pnpm dependency footprint — unused deps, deduplication, transitive closure triage

grafana-app-sdk

Skills for building apps on the Grafana App Platform using grafana-app-sdk.

SkillDescription
app-sdk-conceptsProject init, deployment modes (standalone operator, grafana/apps, frontend-only), and workflow
cue-kind-definitionAuthor CUE kind definitions — schemas, versioning, spec vs status, codegen config
reconciler-logicImplement async reconciler and watcher business logic
admission-controlWrite validation and mutation admission handlers

grafana-k6

Skills for working with k6 open-source load testing.

SkillDescription
k6Generate, validate, and review k6 test scripts — load/stress/spike/soak/breakpoint, functional, protocol, and browser — using runnable examples and a generate → validate → review workflow
k6-docsWrite or review k6 documentation across TypeScript types, user docs, and release notes
k6-perf-test-websitePerformance-test a public website end-to-end with k6. Produces a hybrid protocol+browser test suite, SLO-backed thresholds, a load-generator monitor sidecar, and a Grafana-side investigation playbook
k6-manageOperate Grafana Cloud k6 (GCk6) via the gcx CLI or direct curl — manage tests, runs, scripts, schedules, and env vars; fetch logs, metrics, traces, screenshots, and Cloud Insights
k6-cloud-investigate-testInvestigate a specific Grafana Cloud k6 test or run — describe the script, list run history, pull metrics and logs, and identify pass/fail root cause
k6-trend-analysisAnalyze Grafana Cloud k6 test-run trends over time — detect metric drift, compute threshold headroom, and recommend when to tighten thresholds
k6-test-maintenanceMaintain and improve existing k6 scripts — threshold tightening, version migration, service-change fixes, refactoring, and best-practice audits

grafana-datasources

Skills for working with Grafana data source plugins.

SkillDescription
datasources-provisioningAuthoring and schema discovery of Grafana data source plugin's configuration

Contributing

We welcome contributions! See CONTRIBUTING.md for how to add a new skill.

Quick start:

  1. Copy template/SKILL.md to skills/<plugin-name>/<skill-name>/SKILL.md
  2. Fill in the frontmatter and content
  3. Run ./scripts/lint-skills.sh skills to validate
  4. Open a PR

Repository Structure

grafana-skills/
├── .claude-plugin/marketplace.json   # Claude Code marketplace manifest
├── .cursor-plugin/marketplace.json   # Cursor marketplace manifest (identical)
├── .agents-plugin/marketplace.json   # Codex marketplace manifest (identical)
├── skill-registry.json               # Machine-readable skill manifest
├── skills/                           # All skills, grouped by plugin
│   ├── grafana-core/
│   ├── grafana-cloud/
│   ├── grafana-lgtm/
│   ├── grafana-plugins/
│   ├── grafana-app-sdk/
│   ├── grafana-k6/
│   └── grafana-datasources/
├── template/SKILL.md                 # Starter template for new skills
├── scripts/lint-skills.sh            # Local skill validation
└── .github/workflows/                # CI validation

License

Apache License 2.0 - see LICENSE.