skills.rest
notque
notqueCOMMUNITY
Explore all skills by this author →
GitHub

perses-plugin-create

Scaffold a new Perses plugin directory with schema validation and build automation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Perses plugin creation is a heavy-lift in setting up a new plugin: scaffolding, schema validation, and build boilerplate are typically manual and error-prone. This skill automates that lifecycle, letting developers focus on implementing their plugin.

Core Features & Use Cases

  • Scaffold a new Perses plugin directory with percli plugin generate
  • Create CUE schema definitions and corresponding JSON examples
  • Generate Grafana migration scaffolds when applicable
  • Implement React components and validate schemas before building

Quick Start

Run percli plugin generate with your module/org, module/name, plugin.type, and plugin.name to scaffold a new Perses plugin.

Frequently Asked Questions about perses-plugin-create

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

FAQPage Schema
How do I scaffold a new Perses plugin from scratch?▼

To scaffold a Perses plugin, run percli plugin generate with your module/org, module/name, plugin.type, and plugin.name. This orchestrates the entire directory creation from schema generation to a distributable build.

What types of Perses plugins can I generate with this scaffolding process?▼

Perses plugin scaffolding supports generating Panel, Datasource, TimeSeriesQuery, TraceQuery, ProfileQuery, LogQuery, Variable, and Explore plugin types, including optional Grafana migration scaffolds when applicable.

Why does my Perses plugin build fail during schema validation?▼

Perses plugin builds enforce hard steps like ensuring your JSON example matches the CUE schema, wrapping specs with close({...}), and running schema tests. Failing these specific validation checks will halt the build process.

Do I need to manually validate the CUE schema and JSON examples for my Perses plugin?▼

No, you do not need to manually validate CUE schemas and JSON examples. The scaffolding process automatically enforces matching the JSON example to the CUE schema and runs schema tests before completing the build.

Can I generate Grafana migration scaffolds when creating a Perses plugin?▼

Yes, you can generate Grafana migration scaffolds when creating a Perses plugin. The scaffolding process supports generating these migration structures alongside your React component and CUE schema definitions.

What is the best way to automate Perses plugin boilerplate creation?▼

The best way to automate Perses plugin boilerplate is using percli plugin generate. It orchestrates schema, example, React component, and archive creation automatically, eliminating manual and error-prone setup.

Related Skills

Explore More Software Engineering Skills→
Montte-erpMontte-erp
6

nx-plugins

Discover and install Nx plugins to extend an Nx workspace.

Official
Basic
notquenotque
415

perses-plugin-pipeline

Orchestrate Perses plugin development from scaffold to deploy with percli.

Community
Advanced
notquenotque
415

perses-plugin-test

Validate Perses plugins end-to-end with percli schema tests, React component tests, and local server integration tests.

Community
Advanced
stephanjstephanj
9

plugin-forge

Scaffold Claude Code plugins with manifests and semantic versioning.

Community
Intermediate