CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hypothesis-validation

Given a hypothesis, take the necessary investigation steps to validate, invalidate, or reach an inconclusive result for the hypothesis.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./agent/skills/hypothesis-validation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 body presents a clear, well-sequenced three-step procedure with concrete tool names and a tidy boundary against the deep investigation skill. Its main weakness is the vague middle step — 'dig deep' never specifies how evidence should actually be gathered or what a recorded finding looks like — plus minor redundant phrasing.

Suggestions

Concretize step 2 by naming the evidence-gathering sources or actions (e.g. query logs, check dashboards, read linked runbooks) instead of the generic 'dig deep into the most relevant pieces of context'.

Add a brief example of a recorded evidence finding or the expected conclusion format so the output shape is unambiguous.

Trim the redundant sentences, e.g. the 'The goal here is getting a quick hydration...' line that restates the section heading.

DimensionReasoningScore

Conciseness

The body is lean at ~35 lines with a concrete scan list and named tools, but contains minor trimmable redundancy: "The goal here is getting a quick hydration of possibly relevant context... before doing a deeper dive" restates the section heading, and step 2's opening sentence largely repeats step 1's output. This matches 'efficient with minor instances of over-explanation' rather than 'every token earns its place'.

4 / 5

Actionability

Concrete guidance is present (a specific context scan list and the named tools `evidence_record`, `evidence_remove`, `evidence_list`), but the core step 2 — "dig deep into the most relevant pieces of context to gather enough evidence" — gives no concrete method, sources, or example of a recorded finding, leaving key details missing. This matches the 'some concrete guidance but incomplete' anchor rather than 'mostly executable with minor gaps'.

3 / 5

Workflow Clarity

A clear numbered three-step sequence (context hydration → dig deep → draw conclusions) with implicit checkpoints ("Record findings as you dig", "After gathering enough evidence") and a required evidence citation in the conclusion. Not destructive or batch, so no cap applies; it falls short of a 5 because there are no explicit validation or feedback-loop steps.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external bundle files (none exist), and is well organized into Procedure, Result, and Boundaries sections with numbered steps. Per the simple-skill guideline, this earns full credit with just well-organized sections.

5 / 5

Total

16

/

20

Passed

Description

50%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 clearly communicates the skill's purpose (validating, invalidating, or finding a hypothesis inconclusive) but reads as a 'what' statement only. It lacks any 'when to use' trigger guidance and natural trigger synonyms, and its actions remain at the outcome level rather than concrete investigation activities.

Suggestions

Add an explicit 'Use when...' clause, e.g. "Use when the user asks to validate, confirm, or rule out a hypothesis during an incident or investigation."

Include natural trigger terms and synonyms users would actually say, such as "test a theory", "verify an assumption", or "root cause hypothesis".

Name one or two concrete actions beyond outcomes, e.g. "records evidence and cites the key evidence in a final conclusion", to sharpen specificity and distinctiveness against general investigation skills.

DimensionReasoningScore

Specificity

The description names the domain and the three outcome actions ("validate, invalidate, or reach an inconclusive result") but the means are generic — "take the necessary investigation steps" lists no concrete activities such as gathering or recording evidence. This matches the anchor for naming a domain with 1-2 concrete actions but not comprehensive coverage; it is above the minimal/generic anchor because the three distinct outcome actions are explicitly stated.

3 / 5

Completeness

It clearly answers 'what' ("take the necessary investigation steps to validate, invalidate, or reach an inconclusive result") but has no 'when' guidance at all — no "Use when..." clause or trigger context is present, which caps completeness at 3. It is not a 2 because the 'what' is clear rather than vague.

3 / 5

Trigger Term Quality

Terms like "hypothesis", "validate", "invalidate", and "investigation" are relevant to the domain, but the description misses common natural variations users would say, such as "test a theory", "verify an assumption", or "confirm or rule out". Some relevant keywords with missing synonyms matches the middle anchor.

3 / 5

Distinctiveness Conflict Risk

The hypothesis framing is somewhat distinctive, but "take the necessary investigation steps" broadly overlaps with general investigation and troubleshooting skills, and no distinguishing trigger phrases are provided. It could still overlap with similar skills, matching the middle anchor rather than the 'mostly distinct' anchor.

3 / 5

Total

12

/

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

sjoerd2025/eve-sre-agent-template

Path

agent/skills/hypothesis-validation/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.