CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

observability

Instrument services with structured logging, Prometheus metrics, and OpenTelemetry tracing. Build Grafana dashboards, write Prometheus alerting rules, run k6 load tests, and plan infrastructure capacity.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/observability/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 highly actionable, well-structured multi-mode skill body with concrete commands, formulas, and complete alert examples, plus real validation steps in the alert and loadtest flows. Its main weaknesses are the missing references/observability.md bundle file that every mode cites, and some inline SLO YAML detail that belongs in that reference.

Suggestions

Ship references/observability.md (or remove the 'Reference:' lines) — all six modes cite a file that is absent from the bundle.

Move the full fast/slow burn alert YAML into the reference file, keeping only the expr pattern and burn-rate thresholds inline.

Add a verification step to instrument mode (e.g. curl /metrics and confirm counters increment) and to dashboard mode, matching the validation present in alert mode.

DimensionReasoningScore

Conciseness

The body is dense and operational — numbered steps, exact metric names, formulas, and copy-paste PromQL/YAML — with almost no explanation of concepts Claude already knows. Not 5 because ~35 lines of full SLO alert YAML and the interactive wizard prompt blocks are inline detail that could be trimmed or moved to the reference file.

4 / 5

Actionability

Guidance is fully executable: exact metric names ('http_requests_total', 'http_request_duration_seconds'), a sizing formula 'replicas = ceil((peak_rps × avg_latency_s) / target_concurrency_per_pod)', a runnable k6 command ('k6 run --out json=results.json load-test.js'), complete burn-rate alert YAML with runbooks, and specific histogram bucket values (0.1, 0.25, 0.3, 0.5, 1.0, 2.5). Matches 'Fully executable; copy-paste ready... specific examples cover the common cases'.

5 / 5

Workflow Clarity

Each mode has a clear numbered sequence, and several include explicit validation — alert mode step 5 ('no alert fires on healthy baseline, alert fires on injected fault') and loadtest result interpretation against thresholds. Fits 'Clear sequence with most checkpoints present; minor validation gaps'. Not 5 because instrument and dashboard modes end with no verification step (e.g. checking /metrics is scraped or the dashboard renders).

4 / 5

Progressive Disclosure

Every mode consistently signals a one-level-deep reference ('Reference: references/observability.md → <section>'), but that file does not exist in the bundle — there is no references/ directory — so the navigation path is broken. Additionally the SLO mode inlines the full alert YAML that the reference pattern suggests belongs elsewhere. Fits 'references present but not clearly signaling usable content / could be better organized'; not 4 because a cited-but-missing file is more than a minor organization gap.

3 / 5

Total

16

/

20

Passed

Description

71%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.

A specific, technology-anchored description that clearly states what the skill does, but it omits any 'use when' trigger guidance, which both caps completeness and leaves natural trigger phrases (monitoring, SLO, error budget) unsaid. Minor overlap risk exists around generic dashboard-creation requests.

Suggestions

Append a trigger clause, e.g. 'Use when setting up monitoring/observability, writing Prometheus alerts, defining SLOs and error budgets, or load-testing a service.'

Add the missing natural synonyms 'monitoring', 'SLOs', and 'error budgets' so the slo mode is discoverable from the description.

Sharpen the dashboard trigger to 'Grafana observability dashboards' to reduce overlap with general chart/visualization skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions across the domain: 'Instrument services with structured logging, Prometheus metrics, and OpenTelemetry tracing. Build Grafana dashboards, write Prometheus alerting rules, run k6 load tests, and plan infrastructure capacity.' This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' — five distinct, named capabilities with specific tooling. Not 4 because coverage spans all six skill modes (only SLO work is implicit in 'alerting rules') with no generic filler.

5 / 5

Completeness

The 'what' is explicit and concrete (instrument, dashboards, alerts, load tests, capacity), but there is no 'Use when...' clause or equivalent explicit trigger guidance — per the judging guidelines this caps completeness at 3. The anchor 'Has a clear what but when is missing or only weakly implied' is the exact fit; not 4 because nothing in the text signals when to invoke it.

3 / 5

Trigger Term Quality

Natural terms users would say are well covered: 'Prometheus metrics', 'Grafana dashboards', 'alerting rules', 'load tests', 'tracing', 'structured logging'. Not 5 because common synonyms and variations are missing — 'monitoring', 'observability', 'SLOs', 'error budgets', 'alert rules' — none appear, and the skill's own slo mode has no trigger term in the description.

4 / 5

Distinctiveness Conflict Risk

Named technologies (Prometheus, Grafana, OpenTelemetry, k6) form a clear observability niche with distinct triggers, fitting 'Mostly distinct; minor overlap risk'. Not 5 because 'Build Grafana dashboards' and general dashboard/chart language overlaps with visualization skills, and capacity planning could brush against generic infra-sizing skills.

4 / 5

Total

16

/

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: 5 missing

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

skills/observability/SKILL.md

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.