CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

kopai/root-cause-analysis

Investigate and root-cause production issues from live OpenTelemetry telemetry (traces, logs, metrics) with the Kopai SDK in TypeScript code mode. Use this skill to debug errors and error-rate spikes, investigate latency/slowness and timeouts, trace requests across services, find failing or cascading services, and correlate logs to a trace — including vague symptom reports like 'why is my API slow', 'getting 500 errors', 'service is down', 'requests are timing out', or 'something is failing in prod', even when the user never says 'traces' or 'observability'. This analyzes existing telemetry to find a cause. Do NOT use it to add instrumentation (use otel-instrumentation), to build dashboards or visualizations (use create-dashboard), or to fix non-telemetry problems like failing CI, lint errors, unit tests, or SQL query tuning.

Quality

91%

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

Overview
Quality
Evals
Security
Files

Quality

Content

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

A highly actionable, information-dense skill body with runnable TypeScript for every workflow step and a genuinely valuable catalog of backend pitfalls. Its weaknesses are systematic repetition (the typed-rows point, the duplicated Quick Example) and — most seriously — a Rules section that points at nine rule files that do not exist in the bundle, breaking the skill's own progressive-disclosure structure.

Suggestions

Ship the rules/ directory (workflow-find-errors, workflow-get-context, workflow-correlate-logs, workflow-check-metrics, workflow-identify-cause, pattern-http-errors, pattern-slow-requests, pattern-distributed, pattern-log-driven) or remove the 'Read rules/<rule-name>.md' pointers — nine referenced files are missing from the bundle.

Delete or differentiate the Quick Example section: it repeats the RCA Workflow step-1 query almost verbatim, adding only the avg/max Duration measures that step 4 already shows.

State the typed-rows guarantee once (e.g., in Code mode) and drop the repeats in the code comment, the aggregate explanation, and Tip 3.

DimensionReasoningScore

Conciseness

The body is dense and expert-level — the gotchas list contains only non-obvious backend knowledge and it never explains concepts Claude already knows. However, the typed-rows guarantee is stated four times ('fully typed — rows autocomplete and typos are compile errors', 'Result rows are fully typed — iterate data directly and never cast', the '// typed rows' comment, and Tip 3), and the Quick Example duplicates the Workflow step-1 query almost verbatim. This is minor over-explanation that could be trimmed — above anchor 3's midpoint, but not anchor 5's 'every token earns its place'.

4 / 5

Actionability

Fully executable throughout: a connect snippet with config-override args, the run command 'npx tsx rca.mts' with a '.mts' rationale and a 'node --experimental-strip-types' fallback, complete built queries for every workflow step, a copy-paste error-handling pattern for KopaiQueryBuildError with e.issues, and concrete CLI commands. Specific examples cover the common cases (error triage, trace context, log correlation, metric time-series).

5 / 5

Workflow Clarity

The RCA Workflow is a clearly sequenced 5-step process (find failing work → get trace context → correlate logs → quantify impact → present findings), each with runnable code and pointers to detail rules. Validation exists — the 'empty result on a busy system ≈ a wrong column/value' re-check, the retention-floor caution, and build-error try/catch — but these checkpoints live in the gotchas section rather than being embedded as explicit workflow steps, which fits anchor 4's 'most checkpoints present; minor validation gaps' rather than anchor 5's explicit in-workflow validation with feedback loops.

4 / 5

Progressive Disclosure

Section structure is good and the three references/*.md files exist and are one level deep, but 9 of the 12 referenced paths are dangling: 'Read rules/<rule-name>.md for details' and every 'See workflow-find-errors' / 'pattern-http-errors' pointer targets a rules/ directory that is absent from the bundle. Navigation to the promised detail material is impossible, which falls below anchor 4's 'references mostly clear' despite the otherwise good organization.

3 / 5

Total

16

/

20

Passed

Description

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

An excellent description: third-person, specific, and comprehensive, with concrete trigger phrases including the vague symptom reports real users type, plus explicit do-not-use boundaries that disambiguate it from sibling observability skills. The only critique is length — it is on the far end of what a description field should carry — but every clause is functional rather than padded.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'Investigate and root-cause production issues', 'debug errors and error-rate spikes', 'investigate latency/slowness and timeouts', 'trace requests across services', 'find failing or cascading services', 'correlate logs to a trace' — with comprehensive coverage across traces, logs, and metrics. There are no meaningful coverage gaps, so it matches the anchor-5 example rather than anchor 4's 'minor gaps'.

5 / 5

Completeness

It explicitly answers both what ('Investigate and root-cause production issues from live OpenTelemetry telemetry (traces, logs, metrics) with the Kopai SDK') and when ('Use this skill to debug errors and error-rate spikes... including vague symptom reports like...') with concrete trigger phrases, mirroring the anchor-5 example structure. It also adds explicit anti-triggers, so it is not score 4, where the 'when' 'could be more explicit or specific'.

5 / 5

Trigger Term Quality

Beyond natural keywords ('debug errors', 'latency/slowness', 'timeouts', 'correlate logs'), it enumerates the exact vague phrases users say — 'why is my API slow', 'getting 500 errors', 'service is down', 'requests are timing out', 'something is failing in prod' — and explicitly states it should trigger 'even when the user never says traces or observability'. This is comprehensive natural-term coverage including synonyms and paraphrases, exceeding anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (telemetry-based production RCA with the Kopai SDK) and actively disambiguates: 'Do NOT use it to add instrumentation (use otel-instrumentation), to build dashboards or visualizations (use create-dashboard), or to fix non-telemetry problems like failing CI, lint errors, unit tests, or SQL query tuning.' Explicit exclusion of adjacent skills means minimal conflict risk, matching anchor 5.

5 / 5

Total

20

/

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.

Reviewed

On this page