CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

73

Quality

66%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/20-observability-sre/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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

This description has strong trigger term coverage and completeness with an explicit 'Use when' clause. The main weakness is that it lists topic areas rather than concrete actions - it says what concepts it covers but not what specific tasks it performs (e.g., 'define' is vague compared to 'configure alerting rules' or 'implement distributed tracing').

Suggestions

Replace 'definir' with more specific action verbs describing concrete tasks, e.g., 'configure alerting thresholds', 'implement health check endpoints', 'set up distributed tracing'

Add examples of outputs or deliverables, e.g., 'generate Prometheus metrics configurations' or 'create runbooks for incident response'

DimensionReasoningScore

Specificity

Names the domain (observability and operational reliability) and lists several relevant concepts (logs, metrics, tracing, alerts, health checks, readiness, error budgets, rollback), but these are topic areas rather than concrete actions. Missing action verbs like 'configure', 'implement', 'analyze'.

2 / 3

Completeness

Explicitly answers both what (observability and operational reliability skill covering logs, metrics, tracing, etc.) and when ('Use quando precisar definir...'). Has a clear 'Use when' clause with specific trigger scenarios.

3 / 3

Trigger Term Quality

Good coverage of natural technical terms users would say: 'logs', 'metricas', 'tracing', 'alertas', 'health checks', 'readiness', 'error budgets', 'rollback'. These are terms practitioners naturally use when discussing observability.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused on observability and operational reliability with distinct technical triggers (tracing, error budgets, readiness probes). Unlikely to conflict with general coding or deployment skills due to specific terminology.

3 / 3

Total

11

/

12

Passed

Implementation

42%

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

This skill provides a well-structured organizational framework for observability and SRE practices with good progressive disclosure to external resources. However, it lacks concrete, executable guidance - there are no code examples for implementing logs, metrics, health checks, or alerts. The content describes responsibilities and checklists but doesn't show Claude how to actually implement any of these observability patterns.

Suggestions

Add concrete code examples for structured logging, metrics collection, and health check endpoints in the target stack (e.g., Python/Node.js examples with specific libraries)

Include executable alert rule examples (e.g., Prometheus alerting rules, CloudWatch alarm definitions) rather than just describing 'alertas acionaveis'

Add a numbered workflow with validation steps: e.g., '1. Add structured logging -> 2. Verify logs appear in aggregator -> 3. Add metrics -> 4. Validate in dashboard -> 5. Configure alerts'

Provide a concrete health check implementation example showing the difference between liveness and readiness probes

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some organizational overhead (governance references, multiple policy links) that could be tightened. The checklist items are concise but the overall structure has some redundancy between sections.

2 / 3

Actionability

The skill provides abstract guidance without concrete code examples, commands, or executable snippets. Phrases like 'definir sinais essenciais' and 'garantir health checks' describe what to do but not how to do it specifically.

1 / 3

Workflow Clarity

Responsibilities are listed but lack clear sequencing and validation checkpoints. There's no explicit workflow for how to implement observability, validate configurations, or verify that monitoring is working correctly before proceeding.

2 / 3

Progressive Disclosure

The skill appropriately references external documents (GLOBAL.md, policies, templates, skill-guides) with clear one-level-deep navigation. Content is well-organized into distinct sections with clear signposting to detailed materials.

3 / 3

Total

8

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
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.