---
title: "Grafana App SDK concepts: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/grafana-app-sdk-concepts/
description: "Pins Grafana's app-sdk concepts skill, which asks before adding an operator and deletes unkept files in the in-repo scaffold."
---

# Grafana App SDK concepts: review, setup & limitations · Undominated.ai

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

[← Explore all skills](/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.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/app-sdk-concepts)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 4 linked sources
 Publisher grafana
 Licence [Apache-2.0 ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE)
 Revision 1ccacf29049f
 [Read what was—and wasn’t—checked ↓](#review)

“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. …”

 [grafana · upstream description ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md) Our analysis follows below.

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.

### A good fit for

 - Starting a grafana-app-sdk app when the operator scaffold must wait for a yes and the in-repo mode must not keep the extra init files
- Regenerate the SDK types and manifest after changing a CUE resource schema.

### Weigh up before choosing

 - This review did not execute the resource.
- claude plugin install grafana-app-sdk@grafana-skills installs the grafana-app-sdk plugin group, not this file alone. npx skills add grafana/skills, also in the README, installs the whole repository.
- The keep-only comment is followed by copying a Makefile and overwriting kinds/config.cue, so the directory does not end as only the four kept paths.
- The grafana/apps init is stated to work only inside the Grafana repo or a fork. This review did not test that detection.
- go install of grafana-app-sdk@latest is a prerequisite line in the skill, not the skill install, and was not run.
- The deployment, CLI, config, and local-development references were not opened.

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 ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md)

DOCUMENTED COMMAND

 claude plugin install grafana-app-sdk@grafana-skills Copy command ↗

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

 - The README Claude Code section shows claude plugin marketplace add grafana/skills and then claude plugin install grafana-app-sdk@grafana-skills.
- That command installs the grafana-app-sdk plugin group. This file is skills/grafana-app-sdk/app-sdk-concepts/SKILL.md.
- The same README's npx skills add grafana/skills installs the repository and can install more than this file.
- 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

### Compatibility

Claude Code · Cursor · Codex

### Implementation

shell · Go

### Local skill text plus optional Go and filesystem writes

 - Read the skill
- Install the grafana-app-sdk CLI or scaffold a project only if the operator runs those commands
- Delete init files in the in-repo layout only if the operator follows that step

### Cost model

Apache-2.0; no install, scaffold, or delete command was run

04 / FOLLOW THE EVIDENCE

## The source trail.

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

 - [app-sdk-concepts SKILL.md ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md) Checked 2026-10-14 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
- [Repository README ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md Supports: grafana-app-sdk plugin install line and Apache License 2.0 statement
- [Repository LICENSE ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE Supports: Apache License Version 2.0
- [Pinned continuation review W49 ↗](https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md Supports: review.findings, bestFor, upstreamDescription

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### k6 website performance test ↗ Pins Grafana's website k6 skill, which stops without a named workflow and will not design thresholds until functional tests exit cleanly.](/skills/grafana-k6-perf-test-website/)[### AI Runway AKS setup ↗ Pins Microsoft's AI Runway AKS setup skill, which requires confirmation before install, deployment, or GPU provisioning.](/skills/microsoft-airunway-aks-setup/)[### Azure upgrade ↗ Pins Microsoft's in-Azure upgrade skill, which requires an assessment and an explicit confirmation before the original app is deleted or stopped.](/skills/microsoft-azure-upgrade/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
