CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-observability

Review a change for observability. Use as one lens in a code review run.

Quality

82%

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

92%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 content is a model of token-efficient instruction writing: tightly scoped, well-organized, with concrete severity criteria and a clear reporting contract. The only gap is that a sample finding or brief output format would make the reporting guidance fully executable rather than mostly executable.

DimensionReasoningScore

Conciseness

The body is lean and imperative — 'Read the diff and consider the observability of each function that was added or changed' — with zero padding and no explanations of concepts Claude already knows, matching 'Lean and efficient; every token earns its place'. It is not 4 because there is no over-explanation anywhere to trim.

5 / 5

Actionability

Concrete, specific instruction guidance is given — 'Mark a finding as critical when the gap affects a production code path, and minor when it does not' plus an enumerated scope (Logging, Metrics, Tracing) — matching 'Mostly executable guidance... with minor gaps'. Per the rubric's code-vs-instruction note, the absence of code is not penalized; it is not 5 because there are no example findings or an output format that would make the reporting copy-paste ready.

4 / 5

Workflow Clarity

This is a simple, single-task read-only review skill and the single action is unambiguous: a sequenced Method ('Read the diff and consider the observability of each function'), a Threshold defining when to report, and Reporting with explicit critical/minor criteria. The destructive/batch validation cap does not apply since the skill only reads a diff and produces findings.

5 / 5

Progressive Disclosure

The body is under 50 lines, needs no external references, and is organized into clearly labeled Scope, Method, Threshold, and Reporting sections, matching the rubric's simple-skill exception where well-organized sections alone earn a 5. No bundle files exist to reference, and none are needed at this size.

5 / 5

Total

19

/

20

Passed

Description

62%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 cleanly answers what the skill does and when to use it, in third person and without padding. Its main weakness is thin trigger coverage and a single generic action verb — the logging/metrics/tracing scope that the body itself enumerates is absent, limiting both specificity and the natural keywords that would cause it to fire.

Suggestions

Enumerate the concrete actions in the description, e.g. 'Assess the logging, metrics, and tracing coverage of a code change.'

Add natural trigger terms users would say: observability, logging, metrics, tracing, telemetry, production visibility.

Anchor the when-clause to user-visible triggers, e.g. 'Use when reviewing a change for production readiness or when the user mentions observability, logging, or monitoring gaps.'

DimensionReasoningScore

Specificity

'Review a change for observability' names the domain and one concrete action, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not 4 because only one action (review) is listed rather than several specific actions (e.g., assessing logging, metrics, and tracing), and not 2 because the action is a specific, targeted review task rather than minimal or generic.

3 / 5

Completeness

It answers both parts: what ('Review a change for observability') and when ('Use as one lens in a code review run'), an explicit use clause matching 'Has both what and when; when could be more explicit or specific'. It is not 5 because the when lacks concrete trigger phrases a user would naturally say, and not 3 because the when is explicitly stated rather than missing or merely implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ('observability', 'review', 'change', 'code review'), but common natural variations and synonyms users would say — 'logging', 'metrics', 'tracing', 'telemetry' — are missing, matching 'Some relevant keywords but missing common variations or synonyms'. It is not 4 because several natural terms the body's own Scope section lists are absent from the description.

3 / 5

Distinctiveness Conflict Risk

'Observability' carves a mostly distinct niche with minor overlap risk against closely related skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. It is not 5 because the broad 'review a change' phrasing overlaps with general code-review skills, and not 3 because the observability anchor is specific enough to distinguish it from sibling review lenses.

4 / 5

Total

14

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tesslio/product-plugins

Path

code-review/evals/tune-noisy-lens/inputs/review-lenses/review-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.