# Grafana Dashboard Authoring

> Author and safely revise Grafana dashboards and panels, including datasource resolution and panel query verification

- Skill: `datus-ai/grafana-dashboard-authoring` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datus-ai/grafana-dashboard-authoring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datus-ai/grafana-dashboard-authoring/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: datus-ai (https://skillmd.com/u/datus-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/datus-ai/grafana-dashboard-authoring

---


# Grafana Dashboard Authoring

1. Inspect dashboard JSON, folder, datasource UIDs, and panel IDs first.
2. Keep dashboard and panel request bodies in project-local JSON files. Use `dashboards create/update` for whole documents and `panels create/update/delete/copy/move` for focused changes.
3. Preserve variables, datasource references, transformations, field configuration, links, and version/resource metadata unless the user explicitly changes them.
4. Use `panels query <dashboard-uid> <panel-id>` with a bounded time range to validate targets after edits.
5. Read the dashboard back and verify panel placement and IDs.

Grafana 12+ `/apis/dashboard.grafana.app/v1beta1` documents use `metadata` and `spec`; legacy documents use `dashboard` and `meta`. The CLI preserves the detected representation. Never fall back from `/apis` after 401/403. All authoring and live query operations require confirmation.