← Explore all skills

GRAFANA APP SCAFFOLDING / grafana

Grafana App SDK concepts

Pins Grafana's app-sdk concepts skill, which asks before adding an operator and deletes unkept files in the in-repo scaffold.

“Use when starting any grafana-app-sdk work — scaffolding a Grafana app, initializing a Grafana App Platform app, picking a deployment mode (standalone operator / grafana/apps / frontend-only), wiring app-specific config, or onboarding to the SDK. …”

01 / THE REASONING

Why this made the selection.

  • No selected skills record uses this source path.
  • The file requires a question before the operator component is added, and it tells the in-repo scaffold to delete every file outside a short keep list.

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/app-sdk-concepts/SKILL.md
  • README.md
  • LICENSE

Our findings

  • The operator-add command is preceded by an instruction to ask the user first, because they may write app.App by hand.
  • The in-repo workflow says to keep only kinds/, pkg/, go.mod, and go.sum and to delete everything else from the init output.
  • That same snippet then copies an example Makefile and overwrites kinds/config.cue.
  • The grafana/apps init is described as available only inside the Grafana repository or a fork, where apps/ and pkg/registry/apps/ exist at the root.
  • The file says to rerun generate after every CUE change because generated code is the API the reconciler sees.
  • The development loop puts CUE schemas before generation of types, clients, manifests and CRDs, and explicitly requires rerunning generation after each CUE change before relying on the reconciler API.

Not established by this review

  • The resource was not executed and its tools were not called.
  • grafana-app-sdk project init, component add, and generate were not run.
  • No files were deleted and no Go module was installed.
  • The reference markdown under this skill was not opened.
  • 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

claude plugin install grafana-app-sdk@grafana-skills

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. The README Claude Code section shows claude plugin marketplace add grafana/skills and then claude plugin install grafana-app-sdk@grafana-skills.
  2. That command installs the grafana-app-sdk plugin group. This file is skills/grafana-app-sdk/app-sdk-concepts/SKILL.md.
  3. The same README's npx skills add grafana/skills installs the repository and can install more than this file.
  4. This review did not run either install.

Before you start

  • Claude Code if the plugin command is used
  • A Go toolchain only if the skill's own grafana-app-sdk install line is followed, which this review did not run

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md

    Supports: ask-first operator add, keep-only delete, and in-repo mode limit

  2. Repository README ↗Checked

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

    Supports: grafana-app-sdk plugin install line and Apache License 2.0 statement

  3. Repository LICENSE ↗Checked

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

    Supports: Apache License Version 2.0

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

    Supports: review.findings, bestFor, upstreamDescription

Evidence & Ask