CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

investigate

Finds the root cause of a production problem from observability data (logs, traces, errors, sessions, metrics): scope and onset, what changed (deploys and flag changes), which host, version, route or flag variation is over-represented against a baseline, then trace, log and error evidence and blast radius. Use when the user reports a bug, an outage, an error or latency spike, an incident, or asks about patterns across application data.

Quality

87%

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

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

An exceptionally actionable, well-sequenced investigation workflow with strong validation loops and clear companion-file navigation. Its main cost is token weight: version-compatibility conditionals woven into every step and duplicated aggregation depth keep it from being lean.

Suggestions

Consolidate the scattered old-server compatibility notes (bucket formats, Unix-second timestamps, missing summary/low_sample/error_span_rate fields) into a single 'Older server versions' section so each step reads cleanly.

Move the sampling/percentile thresholds and the series/formula mechanics of step 4 into metrics.md, keeping only the decision rule ('set exact: true for numbers you will quote') inline.

Trim the per-field version enumerations in Prerequisites to just the fallback rule and one example, cutting the list of recently added fields.

DimensionReasoningScore

Conciseness

The body is dense and tool-specific with no explanation of concepts Claude already knows, but old-server/new-server compatibility notes ("an older server returns `buckets` with `bucket_min`…", "on a server without `summary`…", "On an older server every change is returned") are interleaved in nearly every step instead of being consolidated, adding version-sensitive overhead that could be tightened.

3 / 5

Actionability

Fully executable guidance: exact tool names and parameters (`groupBy`, `compareTo`, `bucketCount: 24 to 48`, `patternKeys: ["service_name", "message"]`), a complete copy-paste JSON aggregation call, concrete query strings (`span_kind=Server has_errors=true`), and numeric thresholds (P99 under 200 sampled rows, P95 under 50).

5 / 5

Workflow Clarity

Six explicitly ordered steps with validation checkpoints throughout — confirm keys before filtering, "Check that a filter filtered", rerun with `exact: true` when `low_sample` appears — plus error-recovery feedback loops ("On tool failure, try the alternative… and report… the exact next query to run") and a defined output checklist.

5 / 5

Progressive Disclosure

The overview clearly signals one-level companion references, each scoped by a when-to-use line ("logs.md: error messages, log patterns…"), but the referenced companion files are absent from this bundle to verify, and substantial aggregation/sampling detail is inlined that metrics.md is said to cover.

4 / 5

Total

17

/

20

Passed

Description

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

A strong description: concrete, comprehensive, third-person, with an explicit Use-when clause covering the main incident-reporting phrasings. Its only weaknesses are a few missing natural trigger synonyms and slight overlap with generic debugging triggers.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full investigation workflow — "scope and onset, what changed (deploys and flag changes), which host, version, route or flag variation is over-represented against a baseline, then trace, log and error evidence and blast radius" — with comprehensive coverage rather than minor gaps.

5 / 5

Completeness

It explicitly answers both: what ("Finds the root cause of a production problem from observability data (logs, traces, errors, sessions, metrics)" with enumerated sub-capabilities) and when ("Use when the user reports a bug, an outage, an error or latency spike, an incident, or asks about patterns across application data") with concrete trigger phrases, in third-person voice.

5 / 5

Trigger Term Quality

"Use when the user reports a bug, an outage, an error or latency spike, an incident" provides good natural-phrase coverage, but common variants users would say ("alert is firing", "errors are spiking", "the site is slow") are missing.

4 / 5

Distinctiveness Conflict Risk

"Production problem from observability data" carves a clear niche, but the bare trigger "user reports a bug" could also fire for ordinary code-debugging skills, leaving minor overlap risk.

4 / 5

Total

18

/

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

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

launchdarkly/ai-tooling

Path

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