observability-designer

Generates SLO frameworks, optimized alert configurations, and Grafana dashboard specifications for services.

2|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/BryanPinheiro77/FinanceBot-BackEnd --skill observability-designer-bryanpinheiro77
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: observability-designer
Source: https://github.com/BryanPinheiro77/FinanceBot-BackEnd/tree/main/.agents/skills/observability-designer
Command: npx skills add https://github.com/BryanPinheiro77/FinanceBot-BackEnd --skill observability-designer-bryanpinheiro77

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Designing observability for a service from scratch is slow and error-prone: teams struggle to pick the right SLIs, set realistic SLO targets, tame noisy alerts, and build dashboards that actually help during incidents. This Skill automates that design work with three Python scripts. ## Core Features & Use Cases - SLO Designer: Generates SLI definitions, SLO targets, error budgets, and multi-window burn rate alerts from a service definition (type, criticality, user-facing status). - Alert Optimizer: Analyzes existing alert configurations to detect noisy alerts, duplicate rules, coverage gaps against the golden signals, and alert fatigue risk, then emits an optimized configuration. - Dashboard Generator: Produces Grafana-compatible dashboard JSON with role-based layouts (SRE, developer, executive, ops), golden signals panels, and drill-down paths. - Use Case: When onboarding a new payment API, generate its SLO scaffold, import a ready-made Grafana dashboard, and run your existing Prometheus alert rules through the optimizer to cut false positives before the next on-call rotation. ## Quick Start Ask the AI to generate an SRE dashboard and optimized alert configuration for your service by running the dashboard_generator.py and alert_optimizer.py scripts with your service definition JSON.

Frequently Asked Questions about observability-designer

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

FAQPage Schema
How do I generate an SLO framework for a new service?▼

Run slo_designer.py with a service definition JSON containing name, type, and criticality, or pass those as CLI flags. It outputs SLI definitions, SLO targets, error budgets, and multi-window burn rate alert rules.

How can I reduce noisy alerts in Prometheus?▼

Run alert_optimizer.py with your alert configuration JSON using --analyze-only to get a report on noisy alerts, duplicates, and coverage gaps. Then rerun with --output to emit an optimized configuration with adjusted thresholds and for-clauses.

Does the dashboard generator support Grafana?▼

Yes, dashboard_generator.py produces Grafana-compatible JSON when run with --format grafana. It includes golden signals panels, template variables, and role-based layouts for SRE, developer, executive, and ops personas.

What service types and criticality levels are supported?▼

Supported service types are api, web, database, queue, batch, and ml. Criticality levels are critical, high, medium, and low, each mapping to default availability, latency, and error rate targets.

When should I not use this skill for SLO design?▼

The SKILL.md notes that slo_designer.py produces only a quick scaffold. For rigorous error-budget math, multi-window burn-rate thresholds, and SLO review gates, it directs you to the dedicated slo-architect skill instead.

What Python dependencies does the observability designer require?▼

None beyond the Python 3.7+ standard library. All three scripts use only built-in modules like json, argparse, re, and datetime, so no pip installation is needed.