perses-cue-schema

Author and validate Perses plugin CUE schemas with percli test-schemas.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writes and validates Perses plugin CUE schemas, including conventional patterns, imports, and testing workflows.

Core Features & Use Cases

  • Define CUE schemas for Perses plugin types (panel, variable, datasource) with proposals to import common types, enforce package model, and create strict close blocks.
  • Provide JSON examples that validate against the schemas and optionally generate Grafana migration files.
  • Explain CUE syntax and debugging steps, and facilitate incremental validation with percli plugin test-schemas.

Quick Start

Define a new schema following the Phase 1-4 workflow and validate it with percli plugin test-schemas.

Frequently Asked Questions about perses-cue-schema

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

FAQPage Schema
How do I write and validate CUE schemas for Perses plugins?

Author Perses CUE schemas by defining panel, variable, or datasource types with package model and close({...}) constraints, then validate incrementally using percli plugin test-schemas. Import common types from github.com/perses/shared/cue/common.

What CUE version is required for Perses plugin schema validation?

Perses plugin schema validation requires CUE v0.12.0 or higher. You need this version to use the package model, close({...}) constraint patterns, and run percli plugin test-schemas successfully.

Can I migrate Grafana plugin schemas to Perses using CUE?

Yes, you can optionally generate Grafana migration files when providing JSON examples that validate against your Perses CUE schemas. The workflow supports creating panel, variable, or datasource schemas with migration compatibility.

Why does my Perses CUE schema fail percli plugin test-schemas validation?

Perses schema validation fails when you omit the package model declaration, skip close({...}) strict blocks, or miss required common type imports from github.com/perses/shared/cue/common. Follow the Phase 1-4 workflow and validate incrementally.

What is the best way to structure CUE schemas for Perses datasource plugins?

Structure Perses datasource CUE schemas by enforcing package model, importing shared common types, wrapping fields in close({...}) constraints, and providing validating JSON examples. Use percli plugin test-schemas for incremental validation checks.

How do I debug CUE syntax errors when authoring Perses plugin schemas?

Debug Perses CUE schema syntax by following the incremental validation workflow with percli plugin test-schemas, reviewing educational explanations for close({...}) patterns, and checking common type imports from the perses shared cue repository.