create-dashboard

Creates and iterates on Grafana dashboards using gcx with snapshot-based visual feedback.

1|Updated May 25, 2020
One-click install
npx skills add https://github.com/titaneric/dotfiles --skill create-dashboard-titaneric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-dashboard
Source: https://github.com/titaneric/dotfiles/tree/main/dot_agents/skills/create-dashboard
Command: npx skills add https://github.com/titaneric/dotfiles --skill create-dashboard-titaneric

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building Grafana dashboards by hand often produces broken queries, wrong datasource UIDs, and unreadable layouts that are only discovered after deployment. This Skill turns dashboard creation into an iterative workflow that verifies datasources, validates manifests, and visually inspects rendered snapshots before declaring the work done. ## Core Features & Use Cases - Iterative dashboard authoring: Follows a loop of discover data, author, validate, push, snapshot, and revise using gcx commands. - Datasource discovery: Verifies Prometheus, Loki, Tempo, and Pyroscope labels, metrics, and UIDs before writing any PromQL or LogQL queries. - Visual feedback loop: Renders full-dashboard or per-panel PNG snapshots and inspects them for empty panels, truncation, and layout problems. - Use Case: An SRE asks for a new service health dashboard. The Skill finds similar existing dashboards, discovers the correct metrics and labels, authors a manifest, pushes it to the right folder, snapshots it, and fixes visual issues before reporting completion. ## Quick Start Ask the assistant to create a Grafana dashboard for your service with panels for traffic, errors, and latency, and have it verify the result with a rendered snapshot.

Frequently Asked Questions about create-dashboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Grafana dashboard with gcx?

Verify the active gcx context, discover datasources and labels, author a dashboard manifest or follow the repo's builder pattern, then run gcx resources validate and push. Finish by rendering a snapshot with gcx dashboards snapshot and inspecting the PNG for visual issues.

How do I verify PromQL queries before adding Grafana panels?

Use gcx datasources prometheus labels and metadata commands to list available metrics, label values, and units for a datasource UID. Never invent PromQL, label names, or datasource UIDs; confirm them against the live datasource first.

Can I snapshot a single Grafana panel instead of the whole dashboard?

Yes, gcx dashboards snapshot accepts a --panel flag with the panel ID to render an individual panel. This is useful when one panel shows empty data, unreadable legends, or high-cardinality series.

Why does my Grafana dashboard snapshot show a login page?

A login or error page in the snapshot usually indicates an authentication or RBAC problem with the gcx context or token. Run gcx config current-context and gcx config check to classify the failure before retrying the render.

When should I use manage-dashboards instead of create-dashboard?

Use manage-dashboards for pure operations on existing dashboards such as list, search, pull, push, promote, restore, delete, or a one-off snapshot. The create-dashboard workflow is for authoring new dashboards or materially redesigning existing ones.