perses-grafana-migrate

Export Grafana dashboards, convert with percli migrate, validate, and deploy to Perses.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill perses-grafana-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perses-grafana-migrate
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/perses-grafana-migrate
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill perses-grafana-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

Grafana-to-Perses dashboard migration: export Grafana dashboards, convert with percli migrate, validate converted output, fix incompatibilities, deploy to Perses. Handles bulk migration with parallel processing. Use for "migrate grafana", "grafana to perses", "perses migrate", "convert grafana". Do NOT use for creating new dashboards from scratch (use perses-dashboard-create).

What problem does it solve?

Grafana dashboards often live in Grafana but need to live in Perses; this skill automates exporting, converting, validating, and deploying dashboards to Perses, reducing manual rework and ensuring compatibility.

Core Features & Use Cases

  • Export Grafana dashboards to JSON
  • Convert to Perses format with percli migrate
  • Validate migrated dashboards with percli lint
  • Deploy migrated dashboards to Perses
  • Bulk migrate multiple dashboards in parallel

Quick Start

Export Grafana dashboards, convert with percli migrate, validate, and deploy to Perses.

Frequently Asked Questions about perses-grafana-migrate

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

FAQPage Schema
How do I migrate Grafana dashboards to Perses?

Migrating Grafana dashboards to Perses involves exporting dashboards to JSON, converting them with percli migrate, validating the output with percli lint, and deploying to a Perses server.

Can I convert multiple Grafana dashboards to Perses in bulk?

Yes, bulk migration of Grafana dashboards to Perses is supported through parallel processing, automating the conversion, validation, and deployment of large dashboard sets.

What Grafana version is required for Perses migration?

Grafana 9.0.0 or higher is required for source dashboards when migrating to Perses. A reachable Perses server is also necessary for online migrations using percli.

Does the Grafana to Perses migration validate the converted dashboards?

Yes, the Grafana to Perses migration validates converted dashboards using percli lint to identify incompatibilities, ensuring you can fix issues before deploying to Perses.

When should I not use a Grafana to Perses migration tool?

You should not use this Grafana to Perses migration approach to create new dashboards from scratch. It is specifically designed for converting, validating, and deploying existing Grafana dashboards.