Back to Skills

grafana-dashboard-optimize

verified

Optimizes Grafana Jsonnet dashboard content for observability and SRE best practices (RED/USE/Golden Signals). Use when auditing dashboard quality, improving monitoring effectiveness, enhancing diagnostic capabilities, or reviewing observability coverage. Focuses on content-level improvements without code structure refactoring.

View on GitHub

Marketplace

haoming-skills

haomingz/skills

Plugin

grafana-skills

Repository

haomingz/skills

skills/grafana-dashboard-optimize/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/haomingz/skills/blob/main/skills/grafana-dashboard-optimize/SKILL.md -a claude-code --skill grafana-dashboard-optimize

Installation paths:

Claude
.claude/skills/grafana-dashboard-optimize/
Powered by add-skill CLI

Instructions

# Grafana Dashboard Content Optimization (Observability / SRE)

Audit and optimize dashboard content for observability best practices. Apply RED/USE/Golden Signals methodology, improve diagnostic value, and reduce cognitive load for on-call teams.

**Not suitable for**: Code structure refactoring (use `grafana-jsonnet-refactor`), initial JSON conversion (use `grafana-json-to-jsonnet`), or code style formatting.

## Workflow with progress tracking

Copy this checklist and track your progress:

```
Optimization Progress:
- [ ] Step 1: Understand context (purpose, audience, strategy)
- [ ] Step 2: Run seven-dimensional content audit
- [ ] Step 3: Produce prioritized recommendations report
- [ ] Step 4: Apply changes (if requested)
- [ ] Step 5: Validate improvements
```

**Step 1: Understand context**

Before any edits, document:
- Dashboard purpose and target audience (SRE/on-call/management)
- Current monitoring strategy and key questions it should answer
- Datasources, variables, time range settings
- Row structure and panel organization
- Annotations, dashboard metadata (`__inputs`, `__requires`, `schemaVersion`, `graphTooltip`, `version`), and pluginVersion

See `references/full-optimization-playbook.md` for detailed context gathering.
If optimizing dashboards in a specific repo or stack, review local Jsonnet defaults and docs in the working directory for current conventions.

**Step 2: Run seven-dimensional content audit**

Audit across these dimensions:
1. **Panel semantics**: Missing/duplicated views, diagnostic coverage
2. **Query optimization**: rate/increase usage, aggregation, cardinality
3. **Variable design**: Names, defaults, cascading relationships
4. **Visualization**: Panel types, units, thresholds, legends, table field pruning
5. **Layout**: Overview → symptoms → root cause flow
6. **Titles/descriptions**: Unified title style, clarity, context, troubleshooting hints, every panel has a description
7. **Proactive additions**: SLO/SLI, annotations, comp

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
6355 chars