# observability-designer

The observability-designer Claude Code skill plans service observability through SLI/SLOs, alerts, and Grafana dashboards. Use it to shape monitoring for a service or investigate noisy alerts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 129 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/observability-designer/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-observability-designer

## What it does

Available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode, the skill helps define service indicators and objectives, set error budgets, and plan burn-rate alerts. It also covers Grafana dashboards, structured logs, tracing, and retention tiers.

Three Python scripts accompany it. `slo_designer.py` builds SLI/SLO and alert plans, `alert_optimizer.py` reviews alert configurations, and `dashboard_generator.py` outputs Grafana JSON. The skill first asks about service type and criticality, dashboard audience, and the main monitoring pain point when those answers would change the design.

The dashboard output uses `schemaVersion` 30. Current Grafana releases migrate older schemas during import, but the generated result still needs a check in Grafana before it is committed.

## Requirements
- Works with: Grafana

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill observability-designer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/observability-designer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/observability-designer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill observability-designer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/observability-designer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill observability-designer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/observability-designer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/observability-designer/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/observability-designer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill observability-designer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/observability-designer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/observability-designer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill observability-designer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/observability-designer/SKILL.md

## When to use it
- define service SLIs and SLOs
- work out error budgets by service criticality
- spot duplicate or noisy alert rules
- generate Grafana dashboards for different roles
- choose a log structure and trace-sampling approach

## Example prompts
- Design SLI and SLO targets for my API, then outline its alerts.
- Review `alerts.json` and identify noisy or duplicated rules.
- Create a Grafana dashboard for `Payment Service`.

## Similar
- [golang-observability](https://affpapa.org/en/nevibecode/skills/golang-observability.md) — skill · 42300 installs
- [app-observability](https://affpapa.org/en/nevibecode/skills/app-observability.md) — skill · 4800 installs
- [database-observability](https://affpapa.org/en/nevibecode/skills/database-observability.md) — skill · 4700 installs
- [monitoring-observability](https://affpapa.org/en/nevibecode/skills/monitoring-observability.md) — skill · 504 installs
- [observability-monitoring](https://affpapa.org/en/nevibecode/skills/observability-monitoring.md) — skill · 458 installs
- [observability-sre](https://affpapa.org/en/nevibecode/skills/observability-sre.md) — skill · 165 installs

## Other versions with the same name
- [observability-designer · alirezarezvani](https://affpapa.org/en/nevibecode/skills/observability-designer.md) — 671 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
