Perses Dashboard Review

Analyze and improve existing Perses dashboards through structured review of layout, queries, variables, and datasource configuration.

Overview

This is a non-destructive review skill that audits dashboard quality without modification unless explicitly requested. The skill runs a 4-phase pipeline (FETCH, ANALYZE, REPORT, FIX) to identify layout issues, query inefficiencies, variable chain problems, and datasource scoping mismatches. Use this skill to review existing dashboards for quality improvements. Do NOT use this skill to create new dashboards—use perses-dashboard-create instead.

Instructions

Phase 1: FETCH

Goal: Retrieve the current dashboard definition from the live server.

1. Always fetch the live definition via MCP or API first, because a dashboard that "looks fine" locally may differ from what is deployed.
   • Attempt MCP retrieval first (ensures freshest server-side state):

     perses_get_dashboard_by_name(project=<project>, dashboard=<name>)