perses-plugin-test

Installation
SKILL.md

Perses Plugin Testing

Test Perses plugins across four layers: CUE schema validation, React component unit tests, integration testing against a live Perses server, and Grafana migration compatibility.

Overview

This skill validates Perses plugin correctness from schemas through rendered components. Testing follows a strict four-phase order because each layer depends on the previous one passing — schema tests must succeed before component tests, which must succeed before integration tests, which must succeed before migration tests.

STOP before proceeding if:

  • percli is not installed or not on PATH
  • No CUE schemas exist in the plugin (nothing to test with test-schemas)
  • The plugin has no JSON examples and you'd need to create them from scratch
  • Integration testing is requested but no local Perses server is available and Docker is not installed
  • Migration testing is requested but no migrate/migrate.cue file exists in the plugin
  • Schema tests produce errors you cannot diagnose from the CUE output alone

Instructions

Related skills
Installs
5
GitHub Stars
366
First Seen
Mar 23, 2026