CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

root-cause-analysis

Produce a systemic, evidence-based incident RCA/postmortem after a failure: timeline, causal chain, contributing conditions, corrective actions, and prevention. Use when recurrence prevention and organizational learning are primary. Do not use as a generic live debugger.

Quality

91%

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

88%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 well-engineered methodology skill: clearly sequenced phases with validation gates and confidence discipline, actionable throughout without code, and a clean one-level-deep reference structure. The two deductions are trimmable verbosity in the output template and optional workflow sections, and the dangling shared/ policy links that point outside the shipped bundle.

Suggestions

Fix the dangling references: the "Required packaged policies" section links nine shared/base/*.md files plus shared/workflow-contract.md, but the bundle contains no shared/ directory — either ship those files or inline the essential rules.

Trim the ~24-section annotated output template: move the per-section commentary (the ← annotations) into references/prevention.md and keep a bare section list inline.

Compress the "Optional Workflow Integration" section to a few lines plus a pointer, since it is explicitly opt-in and its handoff-topic list and state.json mechanics are only relevant in a rare configuration.

DimensionReasoningScore

Conciseness

The body is dense and directive — the recurrence test, confidence classification ladder, symptom-shape filter ("100% failure rules out races; deploy-aligned onset implicates the release"), and blameless framing are judgment Claude would not produce reliably by default, and no space is spent on concepts Claude already knows. It misses the 5 anchor because of trimming opportunities: the ~24-section annotated output template with per-line commentary, the long opt-in "Optional Workflow Integration" section, and a routing boundary that restates the description.

4 / 5

Actionability

As an instruction-only skill the guidance is fully actionable: eight phases each with concrete checklists (e.g., Phase 1's "expected vs actual... first occurrence and frequency (once / intermittent / constant)"), a defined four-level statement classification (Verified Fact / Likely Cause / Possible Cause / Unknown), a copy-paste-ready report template, and a fully worked example with real evidence-based reasoning (deploy-correlated KeyError, ruled-out lockfile hypothesis). Per the rubric's scoring note, absence of code is not penalized when the guidance is this specific.

5 / 5

Workflow Clarity

The eight phases are explicitly sequenced with mandatory/optional marking ("1–4 are mandatory for every RCA; 5–7 deepen the analysis"), scaling guidance ("for a small bug-RCA compress the phases"), and validation checkpoints throughout: hypotheses must carry "confidence, supporting evidence, contradicting evidence... and a validation method" with cheapest-test-first elimination, evidence classification gates every claim, the confidence model blocks silent promotion ("may ship at MEDIUM only with the missing verification named as the first action item"), and the recurrence test is the acceptance criterion for preventive actions. This is the explicit-validation-with-feedback-loops anchor.

5 / 5

Progressive Disclosure

Structure is good: a Read|When reference map, six phase-linked references that all exist in the bundle and are one level deep, and "Read a reference when its phase begins" on-demand loading. It is not the 5 anchor because the "Required packaged policies" section links ten files — `shared/base/*.md` (nine policy modules) and `shared/workflow-contract.md` — that do not exist in the provided bundle, so those references dangle; it is above the 3 anchor because the core navigation (the reference map and in-phase citations) is clear and the inline content is appropriately placed.

4 / 5

Total

18

/

20

Passed

Description

92%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 deliverable list, explicit use-when clause, and an explicit anti-trigger for its nearest competing skill. The only gap is keyword coverage — the spelled-out phrase "root cause analysis" and terms like "outage" / "post-incident review" would strengthen natural triggering.

DimensionReasoningScore

Specificity

Lists multiple concrete deliverables — "timeline, causal chain, contributing conditions, corrective actions, and prevention" — under the specific action "Produce a systemic, evidence-based incident RCA/postmortem after a failure", in third person. This matches the comprehensive-coverage anchor; it is not the level below (4) because the action list covers the skill's full output surface, not just several actions with gaps.

5 / 5

Completeness

Explicitly answers both: what — "Produce a systemic, evidence-based incident RCA/postmortem... timeline, causal chain, contributing conditions, corrective actions, and prevention"; when — "Use when recurrence prevention and organizational learning are primary", reinforced by an explicit exclusion ("Do not use as a generic live debugger"). Both are explicit with concrete trigger concepts; a missing/weak when-clause would cap it at 3 and a merely serviceable when at 4, neither of which applies.

5 / 5

Trigger Term Quality

Natural terms users would say are present: "incident RCA/postmortem", "failure", "recurrence prevention", "organizational learning", plus the negative trigger "Do not use as a generic live debugger". It falls short of the 5 anchor because common natural phrasings like the spelled-out "root cause analysis", "outage", and "post-incident review" are absent, while "organizational learning" is more abstract than user-utterable.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (post-incident systemic analysis with recurrence prevention) and actively disambiguates the closest rival by saying "Do not use as a generic live debugger", matching the clear-niche/minimal-conflict anchor. It is above the 4 anchor because the negative trigger plus goal-based routing ("recurrence prevention and organizational learning are primary") makes wrong-skill triggering unlikely, not merely minor.

5 / 5

Total

19

/

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: 10 missing, 9 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

Noorkhalel/saas-ai-skills

Path

skills/root-cause-analysis/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.