OBSERVABILITY / grafana
Grafana CUE Kind Definitions
Define versioned resource schemas and generate matching app types from CUE.
“Author CUE kind definitions for grafana-app-sdk apps - schemas, versioning, field constraints, named type definitions, custom routes, and codegen configuration. …”
01 / THE REASONING
Why this made the selection.
- It scaffolds a grafana-app-sdk kind in CUE and regenerates clients instead of editing pkg/generated.
- Breaking schema changes go in a new version, not into a stable v1 or v2 file.
- The definition separates common metadata, version schema and manifest registration, with explicit error recovery and stable-version compatibility boundaries.
- Add a resource kind with reusable named types and field constraints
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/grafana-app-sdk/cue-kind-definition/SKILL.md
- README.md
- LICENSE
Our findings
- The workflow scaffolds kinds/*.cue, edits the schema, and runs grafana-app-sdk generate.
- The skill says never to edit files under pkg/generated, because generate overwrites them.
- A breaking change must be a new version and must not modify a stable v1 or v2 in place.
- The skill does not deploy the generated manifest; it only says the definitions/ CRD can be inspected.
- The definition separates common metadata, version schema and manifest registration, with explicit error recovery and stable-version compatibility boundaries.
- The versioning example checks generated per-version Go directories and the CRD spec.versions entries after regeneration.
Not established by this review
- The resource was not executed and its tools were not called.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add grafana/skills/skills/grafana-app-sdk/cue-kind-definition Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/cue-kind-definition - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Scaffold the kind, define common metadata and per-version spec/status, then register versions in the manifest.
- Run the SDK generator, repair reported CUE constraints in source and select only the required Go/TypeScript outputs.
Before you start
- grafana-app-sdk CLI and project
- CUE schemas and app manifest
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Pinned skill definition ↗Checked
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/cue-kind-definition/SKILL.md
Supports: summary, whySelected, bestFor, limitations, install, access, review
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md
Supports: install
- Apache-2.0 licence ↗Checked
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE
Supports: license
https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/cue-kind-definition/SKILL.md
Supports: review.findings, bestFor, upstreamDescription