app-sdk-concepts

Guide users through grafana-app-sdk concepts for schema-centric Grafana App Platform apps.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill app-sdk-concepts-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-sdk-concepts
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/app-sdk-concepts
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill app-sdk-concepts-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

grafana-app-sdk concepts often feel fragmented when you are trying to understand how schema-based CUE kinds turn into a working Grafana App Platform application with the right deployment mode and development workflow.

Core Features & Use Cases

  • Deployment-mode clarity: explains when to use standalone operator, grafana/apps, or frontend-only based on repository context.
  • End-to-end workflow: covers the full loop from project init and kind scaffolding through code generation to implementing reconciler and admission logic.
  • Scaffolding & structure guidance: provides concrete project structure expectations (kinds/, pkg/, local/, definitions/) and what to edit versus what to treat as generated output.
  • Configuration best practice: shows how to use app.Config.SpecificConfig to pass feature flags or environment-specific settings into app.New.

Quick Start

Tell the assistant: initialize a new standalone operator app with grafana-app-sdk for module path github.com/example/my-app and explain what files you should change after init.

Frequently Asked Questions about app-sdk-concepts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right deployment mode for a grafana-app-sdk application?

Grafana-app-sdk deployment mode depends on repository context: choose standalone operator for external management, grafana/apps for integrated backend, or frontend-only without backend logic.

What is the development workflow for scaffolding CUE kinds in grafana-app-sdk?

Scaffolding CUE kinds in grafana-app-sdk requires defining schemas in the kinds/ directory, then running the generate pipeline to output Go and TypeScript artifacts for your application.

How do I implement reconciler and admission control logic with grafana-app-sdk?

Implement reconciler and admission control logic in grafana-app-sdk by editing generated pkg/ files to validate incoming resource changes and reconcile desired states.

Can I pass environment-specific configuration into a grafana-app-sdk app?

Pass environment-specific settings into a grafana-app-sdk app by populating app.Config.SpecificConfig with feature flags before calling app.New.

Which files should I edit versus leave as generated output in a grafana-app-sdk project?

In a grafana-app-sdk project, edit files in kinds/ for schemas and pkg/ for logic, but treat generated artifacts in local/ and definitions/ as output.