perses-variable-manage

Manage Perses variable lifecycle across global, project, and dashboard scopes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Perses variable lifecycle management across global, project, and dashboard scopes to simplify variable creation, chaining, and interpolation.

Core Features & Use Cases

  • Create TextVariable and ListVariable at any scope (global, project, dashboard)
  • Define cascading dependencies so child variables respect parent variables
  • Support multiple interpolation formats (csv, json, regex, lucene, pipe, glob, etc.)
  • Use MCP-first workflow with percli fallback for project/dashboards

Quick Start

Create a global ListVariable named namespace using a PrometheusLabelValuesVariable to demonstrate a simple cascading filter.

Frequently Asked Questions about perses-variable-manage

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

FAQPage Schema
How do I create cascading dashboard variables in Perses?

Create cascading dashboard variables in Perses by defining parent-child dependencies between ListVariables and TextVariables, ensuring child variables respect parent values through deterministic variable ordering and robust interpolation handling.

What is variable interpolation in Perses and when do I need it?

Variable interpolation in Perses formats variable values for queries using formats like csv, json, regex, lucene, pipe, or glob. You need it when cascading filters pass values between parent and child variables across global, project, or dashboard scopes.

Can I use percli to manage Perses variables without an MCP server?

Yes, you can manage Perses variables using percli as a fallback when MCP is unavailable. The workflow is MCP-first, using percli to handle project and dashboard variable creation, chaining, and lifecycle management when the primary connection fails.

What is the best way to prevent misconfiguration when adding Perses filters?

The best way to prevent misconfiguration when adding Perses filters is to enforce governance rules, validations, and anti-patterns during variable creation, ensuring deterministic ordering and correct interpolation formats across all scopes.

Why are my Perses child variables not respecting parent variable values?

Child variables fail to respect parent values when deterministic variable ordering or interpolation formats are misconfigured. Ensure cascading dependencies are correctly defined and governance validations are applied to prevent broken dashboard filters.