Perses Operations

Umbrella skill for all Perses platform operations.

How to Use (MANDATORY)

You MUST load the matching reference file before starting any Perses work. The table below routes tasks to domain-specific references containing the actual methodology, commands, and patterns.

Match the user's task to a sub-domain in the table below
Load the reference file using Read tool on ${CLAUDE_SKILL_DIR}/references/<name>.md
Follow the instructions in the loaded reference exactly
If the task spans multiple sub-domains, load each relevant reference

Anti-pattern: Do NOT attempt Perses operations from general knowledge alone. The reference files contain percli commands, CUE schema patterns, and deployment procedures specific to this toolkit's Perses setup.

Sub-domains

Perses Operations

Umbrella skill for all Perses platform operations.

How to Use (MANDATORY)

You MUST load the matching reference file before starting any Perses work. The table below routes tasks to domain-specific references containing the actual methodology, commands, and patterns.

Match the user's task to a sub-domain in the table below
Load the reference file using Read tool on ${CLAUDE_SKILL_DIR}/references/<name>.md
Follow the instructions in the loaded reference exactly
If the task spans multiple sub-domains, load each relevant reference

Sub-domains

First-time setup, server deployment	`references/onboard-deploy.md`	New Perses installation or server configuration
Create or review dashboards	`references/dashboard.md`	Any dashboard CRUD operation
Manage datasources or variables	`references/datasource-variable.md`	Connecting data sources or template variables
Plugin development and testing	`references/plugin.md`	Building or testing Perses plugins
Grafana migration	`references/migration.md`	Converting Grafana dashboards to Perses
PromQL/LogQL/TraceQL queries	`references/query.md`	Writing or debugging queries
Project and RBAC management	`references/project.md`	Multi-tenant setup or permissions
Linting, code review, CUE schemas	`references/quality.md`	Code quality or CUE schema work
Dashboard-as-Code pipeline	`references/dac.md`	GitOps or CI/CD for dashboards

Signal	Load These Files	Why
First-time setup, server deployment	`onboard-deploy.md`	New Perses installation or server configuration
Create or review dashboards	`dashboard.md`	Any dashboard CRUD operation
Manage datasources or variables	`datasource-variable.md`	Connecting data sources or template variables
Plugin development and testing	`plugin.md`	Building or testing Perses plugins
Grafana migration	`migration.md`	Converting Grafana dashboards to Perses
PromQL/LogQL/TraceQL queries	`query.md`	Writing or debugging queries
Project and RBAC management	`project.md`	Multi-tenant setup or permissions
Linting, code review, CUE schemas	`quality.md`	Code quality or CUE schema work
Dashboard-as-Code pipeline	`dac.md`	GitOps or CI/CD for dashboards

Perses

Perses Operations

How to Use (MANDATORY)

Sub-domains

Perses

Perses Operations

How to Use (MANDATORY)

Sub-domains

Reference Loading Table

Database Migrations

Database Migrations

Postgres Patterns

Frontend Query & Mutation

Db Migrations

Drizzle