OBSERVABILITY / grafana
Grafana App Admission Control
Implement validators and mutators for Grafana app resources before persistence.
“… Provides guidance on implementing validation and mutation admission handlers for grafana-app-sdk apps.”
01 / THE REASONING
Why this made the selection.
- It separates grafana-app-sdk validation, which cannot change the object, from mutation, which can.
- Standalone apps run their own admission webhook server, while grafana/apps registers the same handlers in process.
- The examples use explicit object type checks, update-only old-object comparisons, mutation responses and separate standalone versus in-process registration.
- Reject invalid or immutable-field updates
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/admission-control/SKILL.md
- README.md
- LICENSE
Our findings
- Validation accepts or rejects a request and cannot modify the resource.
- Standalone operators start a webhook server; grafana/apps does not require a separate server.
- The skill says to reject from validators rather than from mutators.
- It does not enable mutation in CUE; it points that at the cue-kind-definition skill.
- The examples use explicit object type checks, update-only old-object comparisons, mutation responses and separate standalone versus in-process registration.
- The definition uses identical admission-handler logic for standalone and grafana/apps deployments while distinguishing a standalone webhook server from an automatically registered in-process Kubernetes plugin.
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/admission-control 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/admission-control - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Generate an operator stub if needed, add typed handlers to ManagedKinds and enable operations in the kind definition.
- Test create/update/delete actions, old-object availability and invalid object types; validate the app manifest.
Before you start
- grafana-app-sdk project and CLI
- Go toolchain and generated kind types
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/admission-control/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/admission-control/SKILL.md
Supports: review.findings, bestFor, upstreamDescription