CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deep-investigation

Investigate an operational problem to determine what happened, assess its impact, and recommend next steps using a hypothesis-backed approach.

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

86%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 is a tight, well-sequenced investigation procedure with concrete counts, named evidence tools, explicit guardrails against over-claiming, and a clearly prescribed output shape. Its only meaningful weakness is reliance on external instructions (hypothesis-validation skill, agent Evidence rules) that are referenced but not summarized, leaving minor gaps in actionability and error-recovery guidance.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanation of what investigations or incidents are, and directives like "Do not infer customer impact from an error or alert alone" and "Do not state that no related incident exists because you do not have complete incident history" each earn their tokens. Only the opening sentence mildly restates the frontmatter description, which does not rise to the anchor-4 "minor instances that could be trimmed".

5 / 5

Actionability

Concrete, specific guidance throughout: "generate 2-4 plausible root-cause hypotheses" with required fields, named tools ("Call evidence_record, evidence_remove, and evidence_list"), "Recommend 1-4 concrete actions", and a defined output shape. Not 5 because key steps delegate to external dependencies ("Use the hypothesis-validation skill", "Follow the Evidence rules in the agent instructions") with no inline fallback or example.

4 / 5

Workflow Clarity

A clear 5-phase numbered sequence (understand → hypothesize → validate → assess impact → next steps) with a per-hypothesis checkpoint ("determine whether it is validated, invalidated, or inconclusive") and a prescribed result structure. Not 5 because explicit error-recovery loops (e.g. what to do when a hypothesis is inconclusive or evidence conflicts) are not spelled out.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed: the body is one cohesive, well-sectioned procedure (Procedure / Result / Boundaries) with no inline reference material that belongs in a separate file, and references to other skills are clearly signaled rather than buried. This matches the well-organized, self-contained top anchor.

5 / 5

Total

18

/

20

Passed

Description

66%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 and concretely states what the skill does in third person with a distinctive hypothesis-backed framing, but it omits any explicit "when to use" trigger guidance, which caps its completeness and limits natural trigger-term coverage for the incident/outage/root-cause vocabulary users would actually say.

Suggestions

Append a trigger clause such as "Use when asked to investigate an incident, outage, or unexplained behavior, determine root cause, or assess the impact of an operational problem."

Include the natural synonyms users would say — incident, outage, root cause, postmortem, degraded, on-call — so the description matches real phrasing and file-extension-level specificity seen in the top anchor examples.

Keep the current action list but tie one action to each trigger phrase (e.g. root-cause analysis, impact assessment, remediation recommendations) to strengthen the what/when pairing.

DimensionReasoningScore

Specificity

"determine what happened, assess its impact, and recommend next steps using a hypothesis-backed approach" lists several distinct concrete actions with only minor gaps. Not 5 because "operational problem" keeps the domain generic and no further capabilities are enumerated; not 3 because it goes well beyond naming 1-2 actions.

4 / 5

Completeness

The "what" is clearly stated (investigate, assess impact, recommend next steps), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. Not 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural phrases like "Investigate", "what happened", "impact", and "next steps" are present, giving good keyword coverage. Not 5 because the most common domain synonyms users would say — "incident", "outage", "root cause", "postmortem" — are missing; not 3 because coverage is clearly more than "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

The "hypothesis-backed approach" framing and the what-happened/impact/next-steps triad make it mostly distinct from generic debugging or analysis skills. Not 5 because "investigate an operational problem" is broad enough to overlap with incident-response and triage skills; not 3 because the framing is more distinctive than "works with document files".

4 / 5

Total

15

/

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/deep-investigation/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.