cue-kind-definition

Define and version CUE kinds for Grafana App SDK projects.

213|18|Updated Mar 17, 2026

Search Tags:#versioning #guidance #scaffolding #schemas #cue #kinds #grafana-app-sdk

Ready to run

npx skills add https://github.com/grafana/skills --skill cue-kind-definition

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cue-kind-definition
Source: https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/cue-kind-definition
Command: npx skills add https://github.com/grafana/skills --skill cue-kind-definition

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Define and version CUE kinds for Grafana App SDK projects, providing a clear, repeatable pattern for cross-version schemas and codegen configuration.

Core Features & Use Cases

Scaffold new kinds with a consistent layout (common metadata plus per-version schemas) and generate associated code.
Document schema structure, versioning rules, and codegen configuration to ensure alignment across teams.
Validate and guide edits to kinds and versions, ensuring compatibility with grafana-app-sdk tooling and app manifests.

Quick Start

Run the Grafana App SDK CLI to scaffold a new kind and begin editing its common and versioned schemas.

Frequently Asked Questions about cue-kind-definition

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

FAQPage Schema

How do I define and version CUE kinds for a Grafana App SDK project?▼

To define and version CUE kinds for Grafana App SDK, scaffold new kinds using the CLI to generate a consistent layout with common metadata and per-version schemas. This enforces correct CUE structure and configures code generation for app manifests.

What is the correct CUE structure for managing cross-version schemas in Grafana App SDK?▼

The correct CUE structure for cross-version schemas separates common metadata from per-version schemas. This pattern ensures compatibility with Grafana App SDK tooling and maintains schema alignment across different versions during code generation.

How do I scaffold a new kind and generate code with the Grafana App SDK?▼

Scaffold a new kind by running the Grafana App SDK CLI, which creates the baseline CUE files for common and versioned schemas. You then edit these schemas to configure code generation and align with project scaffolding commands.

Does the Grafana App SDK require frontmatter guidance for CUE kinds?▼

Yes, the Grafana App SDK enforces frontmatter guidance for CUE kinds to validate edits and ensure compatibility. This guidance aligns schema structure and versioning rules with app manifests and codegen configuration.

Why does my CUE kind schema fail validation during Grafana App SDK code generation?▼

CUE kind schema validation fails during code generation when the structure lacks required common metadata or per-version schemas. The skill enforces correct CUE structure and frontmatter guidance to ensure compatibility with grafana-app-sdk tooling.

Can I use cue-kind-definition to manage schemas for multiple Grafana app versions?▼

Yes, you can manage schemas for multiple Grafana app versions by applying the cross-version schema pattern. The skill guides edits to per-version schemas, ensuring compatibility across versions and configuring code generation with the Grafana App SDK.