CtrlK
BlogDocsLog inGet started
Tessl Logo

slo-architect

Use when defining, reviewing, or operating SLOs/SLIs/error budgets. Triggers on "define an SLO", "what should our SLO be", "error budget", "burn rate", "SLI", "service level objective", "Google SRE workbook", "multi-window burn-rate alert", or any reliability-target question. Ships SLO designer, error-budget calculator with multi-window burn-rate thresholds, and SLO reviewer that catches the common bugs (target too aggressive, window too short, conflicting SLOs, no SLI definition). 4 references on SLO principles + SLI design + error budget math + composition with feature-flags-architect/chaos-engineering/kubernetes-operator. NOT a generic observability skill — specifically the SLO discipline.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is slo-architect in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, mostly actionable body with executable command examples, calibrated thresholds, and workflows containing explicit validation gates. Two real defects hold it back: the same anti-pattern content is repeated across three sections (cardinal mistakes, review checks, anti-patterns), and every referenced bundle file — all three scripts, four references, and two asset templates — is missing from the bundle, breaking both the progressive-disclosure structure and the executability of the quick-start commands.

Suggestions

Ship the referenced bundle files (scripts/slo_designer.py, scripts/error_budget_calculator.py, scripts/slo_review.py, the four references/ files, and the two assets/ files) or remove the pointers — all nine referenced paths are absent, so the quick-start commands and every 'See references/...' link fail as delivered.

Merge the 'four cardinal mistakes', the slo_review.py checks list, and the Anti-patterns section into a single deduplicated list — the same bugs (target too high, CPU-as-SLI, no budget policy, single-window alerts) are covered three times.

Trim the SLI/SLO/SLA/EB/BR definition block and the 99.9%-over-30-days arithmetic example — Claude knows the SRE Workbook canon; keep only the calibrated thresholds (e.g., 'target ≥ 99.99% is unsustainable', 'window < 7 days is noise-dominated') that it would not derive on its own.

DimensionReasoningScore

Conciseness

The same four bugs are covered three times: the "four cardinal mistakes" ("Target too high", "Wrong SLI", "No error budget policy", "Single-window burn-rate alert") reappear as slo_review.py checks ("target_too_high", "cpu_as_sli", "no_error_budget_policy") and again in the Anti-patterns section ("99.99% on every endpoint", "CPU usage as SLI", "No error budget policy", "Single-window burn-rate alert"). The SLI/SLO/SLA definition block and the 99.9% error-budget arithmetic also re-teach SRE Workbook canon Claude already knows. Mostly efficient, but the duplication and known-concept explanation mean it is more than 'minor instances of over-explanation' (level 4).

3 / 5

Actionability

Concrete, copy-paste-ready commands with real flags ("python scripts/slo_designer.py --service checkout-svc --sli-type request-success-rate --target 99.9 --window-days 30 --owner team-checkout"), enumerated SLI formulas, a deterministic target rule ("target = floor(p50 of last 30 days × 100) / 100"), and named checks with thresholds ("target ≥ 99.99%", "window < 7 days"). Falls short of level 5 because every invoked script (slo_designer.py, error_budget_calculator.py, slo_review.py) is referenced but absent from the bundle, so the commands are not actually executable as shipped.

4 / 5

Workflow Clarity

Workflow 1 is a clear 9-step sequence with an explicit validation gate ("Run slo_review.py — must pass before the SLO is 'live'") and a refusal gate upstream (slo_designer "Refuses to render if any required field is missing (exit 1)"); Workflow 2 includes fix loops ("fix any FAIL findings", "Adjust thresholds"). Not level 5 because the recovery loop when review fails in Workflow 1 is only implied, and Workflow 3 describes a pipeline without any checkpoint.

4 / 5

Progressive Disclosure

The in-document structure is good and the References section clearly signals one-level-deep files ("references/slo_principles.md — SLI vs SLO vs SLA, Google SRE Workbook canon"), but none of the nine referenced bundle files exist: references/ (4 files), scripts/ (3 files), and assets/ (2 files) are all absent from the bundle. Every "See references/sli_design.md for examples and anti-patterns" pointer and every script invocation dangles, so the navigation structure cannot actually be followed. Structure is better than level 2 (references are not buried and content is well sectioned), but the broken bundle is more than the 'minor organization gaps' of level 4.

3 / 5

Total

14

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: third-person voice, explicit 'Use when' triggers with natural synonyms, a concrete inventory of the three shipped tools and the bugs they catch, and an explicit boundary statement separating it from generic observability skills. No fluff despite its length; every sentence adds triggers or capabilities.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities with named tools and outcomes: "Ships SLO designer, error-budget calculator with multi-window burn-rate thresholds, and SLO reviewer that catches the common bugs (target too aggressive, window too short, conflicting SLOs, no SLI definition)". This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage'; it is not level 4 because there are no meaningful coverage gaps in the action inventory.

5 / 5

Completeness

Both what and when are explicit: "Use when defining, reviewing, or operating SLOs/SLIs/error budgets" followed by concrete trigger phrases, and a clear statement of what the skill ships. Matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'; level 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Triggers include natural user phrasings and synonyms: "define an SLO", "what should our SLO be", "error budget", "burn rate", "SLI", "service level objective", "multi-window burn-rate alert", plus a catch-all "any reliability-target question". Comprehensive natural-term coverage including synonyms (SLI / service level objective); nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche and actively disambiguates: "NOT a generic observability skill — specifically the SLO discipline", with triggers anchored to SLO-specific vocabulary (error budget, burn rate, SLI). Minimal conflict risk with general observability or incident-response skills; matches 'clear niche with distinct triggers'.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 11 missing

Warning

Total

14

/

16

Passed

Repository
alirezarezvani/claude-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.