← Explore all skills

OBSERVABILITY / grafana

Grafana App Reconciler Logic

Implement scoped resource reconciliation and status updates with explicit event and finalizer behavior.

“Implement reconcilers and watchers for grafana-app-sdk apps …”

01 / THE REASONING

Why this made the selection.

  • It implements a grafana-app-sdk TypedReconciler that skips an unchanged generation and writes status with UpdateObject.
  • Label filters limit which objects are reconciled, and client.Update is rejected for status because it races with spec changes.
  • The definition demonstrates typed reconcile callbacks, requeue scheduling, status-subresource updates and namespace/label filters, with an explicit generation guard.
  • Choose reconciliation versus event-style watchers

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/reconciler-logic/SKILL.md
  • README.md
  • LICENSE

Our findings

  • The reconciler observes current state and returns early when the generation was already observed.
  • Status writes go through resource.UpdateObject, and the skill says not to use client.Update.
  • LabelFilters such as env=prod mean only matching resources are reconciled.
  • The skill does not own resources it does not declare; unmanaged kinds are deferred to a reference.
  • The definition demonstrates typed reconcile callbacks, requeue scheduling, status-subresource updates and namespace/label filters, with an explicit generation guard.
  • The BasicReconcileOptions example states that leaving Namespace unset watches all namespaces, while a value restricts the watch to one namespace.

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/reconciler-logic

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/reconciler-logic
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Register the reconciler on the intended kind version and configure scope filters.
  3. Use the status subresource, handle deleted/resynced actions deliberately and verify repeated reconciliation is safe.

Before you start

  • Grafana app SDK project
  • Go toolchain, resource client and target kind

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/reconciler-logic/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/reconciler-logic/SKILL.md

    Supports: review.findings, bestFor, upstreamDescription

Evidence & Ask