# app-sdk-concepts

Скилл помогает начинать разработку приложений для Grafana App Platform: выбрать режим, создать каркас и связать CUE-схемы с Go-логикой.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4200 установок · ★ 291
- Автор: grafana
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/grafana/skills/tree/HEAD/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/app-sdk-concepts

## Что делает

\`app-sdk-concepts` объясняет работу с `grafana-app-sdk` — CLI и Go-библиотекой для приложений на Grafana App Platform. Скилл подсказывает, как создать standalone operator, приложение в `grafana/apps` или frontend-only проект, а также как устроены каталоги и регистрация приложения.

Рабочий цикл строится вокруг CUE-схем: `project kind add MyKind` создаёт каркас kind, `generate` выпускает Go-типы, клиентов, TypeScript-типы, `AppManifest` и CRD. Затем в проект добавляют логику reconciler или admission. После каждого изменения в `kinds/*.cue` нужно снова запускать `grafana-app-sdk generate`.

Для работы с SDK сначала установите CLI через `go install`, затем проверьте `grafana-app-sdk version`. Если пропустить обновление бинарника, `project init` может использовать старую версию. Режим `grafana/apps` требует репозиторий Grafana или его fork, а frontend-only рассчитан на приложение без Go-логики.

## Требования
- Работает с: Grafana

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill app-sdk-concepts -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/app-sdk-concepts/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/app-sdk-concepts/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill app-sdk-concepts -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/app-sdk-concepts/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill app-sdk-concepts -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/app-sdk-concepts/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install grafana/skills app-sdk-concepts
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/app-sdk-concepts/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill app-sdk-concepts -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/grafana/skills --path skills/grafana-app-sdk/app-sdk-concepts
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/app-sdk-concepts/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill app-sdk-concepts -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/grafana/skills/tree/HEAD/skills/grafana-app-sdk/app-sdk-concepts/SKILL.md

## Когда брать
- выбрать режим развёртывания приложения Grafana
- создать каркас проекта через `project init`
- описать ресурс в CUE и сгенерировать код
- подключить reconciler или admission-логику

## Примеры запросов агенту
- Создай новое приложение Grafana App Platform и помоги выбрать между standalone operator, `grafana/apps` и frontend-only.
- Инициализируй проект с `grafana-app-sdk`, добавь `MyKind`, объясни изменения в `kinds/*.cue` и запусти генерацию.
- Покажи структуру приложения в `grafana/apps` и шаги его регистрации внутри Grafana.

## Похожие
- [build-zoom-video-sdk-app](https://affpapa.org/nevibecode/skills/anthropics-build-zoom-video-sdk-app.md) — скилл · 2100 установок
- [build-zoom-meeting-sdk-app](https://affpapa.org/nevibecode/skills/anthropics-build-zoom-meeting-sdk-app.md) — скилл · 2100 установок
- [golang-observability](https://affpapa.org/nevibecode/skills/golang-observability.md) — скилл · 39800 установок
- [grafana-dashboards](https://affpapa.org/nevibecode/skills/grafana-dashboards.md) — скилл · 13097 установок
- [slo-implementation](https://affpapa.org/nevibecode/skills/slo-implementation.md) — скилл · 10400 установок
- [monitoring-expert](https://affpapa.org/nevibecode/skills/monitoring-expert.md) — скилл · 5600 установок

Из того же набора: [grafana/skills](https://affpapa.org/nevibecode/by/grafana/skills.md) — 51 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md