← Explore all skills

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.

Upstream setup instructions ↗

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
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Generate an operator stub if needed, add typed handlers to ManagedKinds and enable operations in the kind definition.
  3. 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.

  1. 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

  2. https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md

    Supports: install

  3. Apache-2.0 licence ↗Checked

    https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE

    Supports: license

  4. https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/admission-control/SKILL.md

    Supports: review.findings, bestFor, upstreamDescription

Evidence & Ask