CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

observability-sre

Skill de observabilidade e confiabilidade operacional. Use quando precisar definir logs, metricas, tracing, alertas, health checks, readiness, error budgets, rollback e operacao segura de servicos. Trigger em: "observabilidade", "observability", "SRE", "logs estruturados", "metricas", "tracing distribuido", "health check", "readiness probe", "error budget", "SLO", "alertas", "rollback seguro", "runbook operacional".

64

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The core SRE sections (Quando Usar, Checklist Base, checkpoint, handoff) are tight and actionable, and the SLO workflow includes genuine validation loops. The body is dragged down by an inlined versioned addendum full of roadmap and history meta-content, tool-integration steps that stop at naming APIs, and references to bundle files that do not exist.

Suggestions

Delete or relocate the meta-content: the inspiration blockquote, the 'O gap fechado' history narrative, and the 'Roadmap derivado' section add tokens without guiding execution; move the runtime-feedback deep-dive into a references/ file and keep a one-line pointer in the body.

Make the tool-integration steps executable: replace 'Datadog: via API com DD_API_KEY + DD_APP_KEY' style hints with a concrete curl/API call per provider (as the CloudWatch line already does), or consolidate them into a single reference file with full request examples.

Ship or prune the referenced bundle files: every referenced path (policies/*.md, docs/skill-guides/observability-sre.md, templates/observability-check.md) is missing from the bundle, so either include them or remove the pointers so navigation works.

DimensionReasoningScore

Conciseness

Roughly a third of the body is meta-content that does not guide execution: the inspiration blockquote ("Birgitta Böckeler... What runtime feedback could agents be monitoring?"), the kit-history narrative ("Antes do v2.7.0, o kit tinha apenas sensores estaticos"), the "Roadmap derivado" items (v2.7.1–v2.8.0), and version-numbered headers — the rubric explicitly penalizes version/date-sensitive padding outside a deprecated section. Not 2 because the majority of sections (checklists, workflows, responsibilities) are lean and directive; not 4 because the roadmap, inspiration, and history blocks are clearly trimmable.

3 / 5

Actionability

Concrete specifics exist ("aws cloudwatch get-metric-statistics", sampling percentages "100% de errors / 1% de info", baseline example "P95: 320ms, error rate: 0.4%"), but most tool integrations are hints rather than executable steps — "Datadog: via API com DD_API_KEY + DD_APP_KEY", "Grafana: via Grafana HTTP API", "New Relic: via NerdGraph API" name the mechanism without a callable command or request. Not 4 because several workflow steps cannot be executed as written; not 2 because the anti-patterns, thresholds, and CloudWatch command are genuinely actionable.

3 / 5

Workflow Clarity

The SLO-driven workflow is a clear 5-step sequence with baseline capture and post-deploy validation ("re-puxar SLO em 5min/30min/2h", "VIOLATED budget, rollback considerado"), and the Checklist Base checkpoint is a real feedback loop (fire each alert, verify arrival, "corrigir o payload/threshold e disparar de novo"). Not 5 because the log-anomaly and response-sampling workflows lack error-recovery loops (what to do when the pull fails or the judge misfires is unspecified).

4 / 5

Progressive Disclosure

Sections are well-organized and external material is signaled ("consultar `docs/skill-guides/observability-sre.md` apenas quando necessario"), but the ~100-line runtime-feedback addendum is inlined content that belongs in a reference file, and every referenced path (`policies/harness-categories.md`, `docs/inspiration/harness-engineering.md`, `templates/observability-check.md`, etc.) is absent from the bundle — there are no references/, scripts/, or assets/ directories, so navigation targets cannot be reached. Not 4 because dangling references and the inlined deep-dive go beyond minor organization gaps.

3 / 5

Total

13

/

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.

The description is a model example: it names a concrete capability list, provides an explicit use-when clause, and includes bilingual trigger keywords covering the domain comprehensively. No changes needed.

DimensionReasoningScore

Specificity

"definir logs, metricas, tracing, alertas, health checks, readiness, error budgets, rollback e operacao segura de servicos" enumerates eight-plus concrete capabilities, matching the comprehensive-coverage anchor. Not 4 because coverage has no noticeable gaps for the observability/SRE domain.

5 / 5

Completeness

"Skill de observabilidade e confiabilidade operacional" states the what, and both "Use quando precisar definir logs..." and the explicit "Trigger em:" list answer when with concrete trigger phrases. Not 4 because the when-clause is already fully explicit, not merely present.

5 / 5

Trigger Term Quality

"Trigger em: 'observabilidade', 'observability', 'SRE', 'logs estruturados', 'metricas', 'tracing distribuido', 'health check', 'readiness probe', 'error budget', 'SLO', 'alertas', 'rollback seguro', 'runbook operacional'" gives comprehensive natural terms with synonyms in both Portuguese and English (e.g., observabilidade/observability, SLO/error budget). Not 4 because no common user phrasing for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Terms like "error budget", "SLO", "readiness probe", "rollback seguro" carve out a clear SRE/observability niche that adjacent deploy/backend/security skills would not claim. Not 4 because no closely related skill's triggers meaningfully overlap with this set.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

skills/20-observability-sre/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.