Official agent skill

App SDK Concepts

OfficialApache-2.0Auto-check passedDevOps & Cloud

Install App SDK Concepts

skills CLI

$ npx skills add grafana/skills --skill app-sdk-concepts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install grafana/skills app-sdk-concepts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/grafana/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/grafana-app-sdk/app-sdk-concepts .claude/skills/app-sdk-concepts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "app-sdk-concepts" agent skill from https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts into .claude/skills/app-sdk-concepts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "app-sdk-concepts", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add grafana/skills --skill app-sdk-concepts -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install grafana/skills app-sdk-concepts --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grafana/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/grafana-app-sdk/app-sdk-concepts .agents/skills/app-sdk-concepts && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "app-sdk-concepts" agent skill from https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts into .agents/skills/app-sdk-concepts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "app-sdk-concepts", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add grafana/skills --skill app-sdk-concepts -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install grafana/skills app-sdk-concepts --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grafana/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/grafana-app-sdk/app-sdk-concepts .cursor/skills/app-sdk-concepts && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "app-sdk-concepts" agent skill from https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts into .cursor/skills/app-sdk-concepts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "app-sdk-concepts", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/grafana/skills.git --path skills/grafana-app-sdk/app-sdk-concepts

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add grafana/skills --skill app-sdk-concepts -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install grafana/skills app-sdk-concepts --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grafana/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/grafana-app-sdk/app-sdk-concepts .gemini/skills/app-sdk-concepts && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "app-sdk-concepts" agent skill from https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts into .gemini/skills/app-sdk-concepts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "app-sdk-concepts", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install grafana/skills app-sdk-concepts

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add grafana/skills --skill app-sdk-concepts -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/grafana/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/grafana-app-sdk/app-sdk-concepts .github/skills/app-sdk-concepts && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "app-sdk-concepts" agent skill from https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts into .github/skills/app-sdk-concepts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "app-sdk-concepts", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add grafana/skills --skill app-sdk-concepts -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install grafana/skills app-sdk-concepts --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grafana/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/grafana-app-sdk/app-sdk-concepts .opencode/skills/app-sdk-concepts && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "app-sdk-concepts" agent skill from https://github.com/grafana/skills/tree/main/skills/grafana-app-sdk/app-sdk-concepts into .opencode/skills/app-sdk-concepts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "app-sdk-concepts", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: app-sdk-concepts
GitHub stars: 282
Token cost: ~1.1k tokens
SKILL.md length: 220 words
Files: 7 (incl. references)
Skills in repo: 51
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Starting any grafana-app-sdk work — scaffolding a Grafana app
SKILL.md covers Prerequisites, Common Workflows, Deployment modes (one-line… and References, plus 1 more section
Calls go
Initializing a Grafana App Platform app

What it does

App SDK Concepts is an agent skill from grafana/skills, published by the product's own GitHub organization. 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. Covers grafana-app-sdk CLI install, project init per deployment mode, project layout, the schema-centric workflow (CUE kinds → generated code → reconciler/admission logic), and SpecificConfig for env-driven app configuration. Use even if the user just says "make a new…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/cli-reference.md`, `references/deployment-modes.md` and `references/local-config.md`).

It sits in DevOps & Cloud, covering Monitoring and alerting, Project scaffolding and Deployment. It works with Grafana. The licence is Apache-2.0.

When your agent uses it

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

Example prompts

“make a new app”
“Grafana app platform”
“kinds and watchers”
“/app-sdk-concepts”

What it can do on your machine

Read from SKILL.md and the folder at commit 1ccacf2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- go
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- github.com
- grafana.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

App SDK Concepts loads about 1.1k tokens when it runs, and up to ~8.1k if it reads all its reference files. Until then it costs about 173 tokens; SKILL.md has 220 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~173
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~8.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from grafana/skills at commit 1ccacf2, republished under its Apache-2.0 licence (© grafana). 220 words, ~1,097 tokens.

Download SKILL.mdSave it as .claude/skills/app-sdk-concepts/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.

name: app-sdk-concepts
description: 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. Covers `grafana-app-sdk` CLI install, `project init` per deployment mode, project layout, the schema-centric workflow (CUE kinds → generated code → reconciler/admission logic), and `SpecificConfig` for env-driven app configuration. Use even if the user just says "make a new app", "Grafana app platform", "kinds and watchers", "operator scaffold", or asks about `apps/` inside the Grafana repo, without naming the SDK explicitly.
license: Apache-2.0

Grafana App SDK Concepts

The grafana-app-sdk is a CLI + Go library for building schema-centric apps on the Grafana App Platform. Apps define resources via CUE schemas ("kinds"), generate Go + TypeScript code, and implement business logic via admission control and reconcilers.

Prerequisites

bash

go install github.com/grafana/grafana-app-sdk/cmd/grafana-app-sdk@latest
grafana-app-sdk version   # verify

Common Workflows

Scaffold a standalone operator app

bash

# 1. Init the project (use the Go module path)
grafana-app-sdk project init github.com/example/my-app

# 2. Add operator scaffolding — ASK THE USER FIRST.
#    They may prefer to write app.App by hand.
grafana-app-sdk project component add operator

# 3. Verify scaffolded layout
ls pkg/app pkg/watchers cmd/operator
# Expected: app.go, watchers/<kind>.go, main.go

Common failure: forgetting go install updates the binary — verify with grafana-app-sdk version before init.

Scaffold a grafana/apps-style app (inside `grafana/grafana`)

Only available inside the Grafana repo (or fork) — the init command detects apps/ and pkg/registry/apps/ at the repo root.

bash

mkdir -p apps/my-app && cd apps/my-app
grafana-app-sdk project init github.com/grafana/grafana/apps/my-app

# Keep ONLY: kinds/ pkg/ go.mod go.sum — delete everything else.
cp apps/example/Makefile       apps/my-app/Makefile
cp apps/example/kinds/config.cue apps/my-app/kinds/config.cue   # overwrite
go work use ./apps/my-app

Then register the app inside Grafana (pkg/registry/apps/apps.go + register.go). Full walkthrough in references/deployment-modes.md.

End-to-end development loop

1. project init               → module, Makefile, kinds/
2. project kind add MyKind    → CUE kind scaffold
3. Edit kinds/*.cue           → schemas, validation, versions
4. grafana-app-sdk generate   → Go types, clients, TS types, AppManifest, CRDs
5. Implement logic            → fill in reconciler / admission stubs
6. (optional) project component add frontend

Always rerun generate after every CUE change — generated code is the API your reconciler sees.

Deployment modes (one-line table)

Mode	When to pick	Where it runs
Standalone operator	Outside Grafana repo, want your own binary	Kubernetes operator with its own webhook server
grafana/apps	Inside `github.com/grafana/grafana` (or fork)	In-process inside Grafana's API server
Frontend-only	UI-only app, no Go logic needed	No backend — TS types only

Full per-mode init, runtime, and wiring detail in references/deployment-modes.md.

References

references/deployment-modes.md — per-mode init, runtime semantics, grafana/apps registration walkthrough
references/project-structure.md — standalone project layout, what's hand-edited vs generated
references/cli-reference.md — every grafana-app-sdk subcommand with flags
references/specific-config.md — app.Config.SpecificConfig pattern for feature-flag-driven app config
references/local-development.md — Tilt + k3d local dev loop
references/local-config.md — local/config.yaml reference

Resources

Files

SKILL.md and 6 other files (references) in skills/grafana-app-sdk/app-sdk-concepts of grafana/skills.

SKILL.md
references/cli-reference.md
references/deployment-modes.md
references/local-config.md
references/local-development.md
references/project-structure.md
references/specific-config.md

Open the folder on GitHubat commit 1ccacf2

Compare with similar skills

App SDK Concepts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

App SDK Concepts compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
App SDK Concepts this skillgrafana/skills	282	—	~1.1k	Automated safety check: Pass	Apache-2.0	yesterday
Mz Release SignoffMaterializeInc/materialize	6.4k	—	~7.2k	Automated safety check: Pass	Custom licence	today
Dashboard Previewm4r1k/Eneru	149	—	~1.4k	Automated safety check: Pass	MIT	yesterday
Aqua Metricsoracle/accelerated-data-science	125	—	~1.5k	Automated safety check: Pass	UPL-1.0	1 mo ago
Analyzing Experiment Precompute CanaryPostHog/posthog	40k	—	~3.5k	Automated safety check: Pass	Custom licence	today
Monitoring Agents Mdhardisgroupcom/sfdx-hardis	403	—	~3.7k	Automated safety check: Notes	AGPL-3.0	today

Similar skills

Mz Release Signoff
MaterializeInc/materialize
Verify a release candidate on the Grafana dashboards and sign off in release.
6.4k GitHub stars~7.2k tokensUpdated today
DevOps & CloudAuto-check passed
Dashboard Preview
m4r1k/Eneru
Visually verify Eneru browser-dashboard changes against a live daemon or audit an exact deployment.
149 GitHub stars~1.4k tokensUpdated yesterday
DevOps & CloudAuto-check passed
Aqua Metrics
oracle/accelerated-data-science
Official
Set up Prometheus and Grafana monitoring for AQUA vLLM model deployments on OCI.
125 GitHub stars~1.5k tokensUpdated 1 mo ago
DevOps & CloudAuto-check passed
Analyzing Experiment Precompute Canary
PostHog/posthog
Official
Analyze the experiment precompute result-consistency canary across prod-US and prod-EU, deep-dive any issues, and produce an actionable report.
40k GitHub stars~3.5k tokensUpdated today
DevOps & CloudAuto-check passed
Monitoring Agents Md
hardisgroupcom/sfdx-hardis
The AGENTS.md file that sf hardis:org:monitor:backup writes at the root of every monitoring repository, so a coding agent can answer questions about the org, its CI/CD deployments and its Grafana…
403 GitHub stars~3.7k tokensUpdated today
DevOps & CloudAuto-check: notes
Axiom Dashboard Builder
openclaw/clawhub
Designs and deploys Axiom dashboards through the API, choosing chart types and writing APL or metrics queries, with templates and migration notes for Splunk and Grafana.
9.5k GitHub stars~4.9k tokensUpdated today
DevOps & CloudAuto-check passed

Questions about App SDK Concepts

What does App SDK Concepts do?

A skill your agent uses 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 /…. App SDK Concepts is an agent skill from grafana/skills, published by the product's own GitHub organization. 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.

When should I use App SDK Concepts?

App SDK Concepts fits situations like: 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.

How do I install App SDK Concepts in Claude Code?

Run `npx skills add grafana/skills --skill app-sdk-concepts -a claude-code`. Or copy the skill folder (skills/grafana-app-sdk/app-sdk-concepts in grafana/skills) into .claude/skills/app-sdk-concepts in your project. Claude Code loads it when a task matches its description.

How do I install App SDK Concepts in Codex?

Run `npx skills add grafana/skills --skill app-sdk-concepts -a codex`. Or copy the skill folder (skills/grafana-app-sdk/app-sdk-concepts in grafana/skills) into .agents/skills/app-sdk-concepts in your project. Codex loads it when a task matches its description.

Can I use App SDK Concepts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add grafana/skills --skill app-sdk-concepts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/app-sdk-concepts, .gemini/skills/app-sdk-concepts, .github/skills/app-sdk-concepts and .opencode/skills/app-sdk-concepts in your project.

What does App SDK Concepts need to run?

Going by SKILL.md and its folder, App SDK Concepts needs the command-line tools its instructions call (go).

Does App SDK Concepts access the network?

SKILL.md names 2 domains. As links in the text: github.com and grafana.com. This is read from the text; nothing was executed.

Is App SDK Concepts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does App SDK Concepts use?

App SDK Concepts is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does App SDK Concepts use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7k tokens, read only when the agent opens those files.

What are the alternatives to App SDK Concepts?

Skills that share tags, products or a category with App SDK Concepts: Mz Release Signoff (MaterializeInc/materialize, 6.4k stars), Dashboard Preview (m4r1k/Eneru, 149 stars), Aqua Metrics (oracle/accelerated-data-science, 125 stars) and Analyzing Experiment Precompute Canary (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains App SDK Concepts?

grafana (a GitHub organization, an official publisher) maintains it in grafana/skills, which has 282 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 8, 2026.

Source: grafana/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install App SDK Concepts

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Grafana App SDK Concepts

Prerequisites

Common Workflows

Scaffold a standalone operator app

Scaffold a grafana/apps-style app (inside grafana/grafana)

End-to-end development loop

Deployment modes (one-line table)

References

Resources

Files

Compare with similar skills

Similar skills

More from grafana/skills

Related

Questions about App SDK Concepts

Scaffold a grafana/apps-style app (inside `grafana/grafana`)