observability-designer · borghei — Claude Code skill for SLOs
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.
LicenseRef-MIT-Commons-Clause 129 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill observability-designer -a claude-codeWhat observability-designer 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.
What it helps with
- 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 for the agent
- Design SLI and SLO targets for my API, then outline its alerts.
- Review
alerts.jsonand identify noisy or duplicated rules. - Create a Grafana dashboard for
Payment Service.
How to install observability-designer
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill observability-designer -a claude-code2Manually: put the files in place
~/.claude/skills/observability-designer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/observability-designer/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill observability-designer -a codex2Manually: put the files in place
.agents/skills/observability-designer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill observability-designer -a cursor2Manually: put the files in place
.cursor/skills/observability-designer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/observability-designer/SKILL.md2Manually: put the files in place
.github/skills/observability-designer/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill observability-designer -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/observability-designerManually: put the files in place
.devin/skills/observability-designer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill observability-designer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about observability-designer
How do I install observability-designer in Claude Code?
Run npx skills add borghei/Claude-Skills --skill observability-designer -a claude-code. The skill file is installed at ~/.claude/skills/observability-designer/SKILL.md.
What does observability-designer do?
It helps plan service indicators and objectives, error budgets, alert rules, and Grafana dashboards. It can also review alert configurations and guide logging and tracing choices.
Which scripts come with observability-designer?
It includes slo_designer.py, alert_optimizer.py, and dashboard_generator.py for SLI/SLO planning, alert review, and Grafana JSON output.
Similar skills
All skills for DevOps and infrastructure →observability-designer by other authors comes first.