CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

incident-triage-runbook

The SRE team's runbook for triaging production latency and error-rate incidents. Use this whenever investigating an incident, a latency spike, elevated error rates, or when asked "what caused X" about a production service.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 exemplary lean operational runbook: terse, opinionated, and grounded in named metrics, services, and dependencies, with a clear decision tree and an exact output format. The only soft spot is that the tooling for pulling deploys and grepping logs is left implicit, which keeps actionability just short of fully copy-paste ready.

DimensionReasoningScore

Conciseness

Every line is a directive, a team-specific fact, or a template — no padding and no explanations of concepts Claude already knows; tips like 'Ask `get_metrics` for a name that doesn't exist and it lists the ones that do' are non-obvious operational knowledge that earns its tokens. Nothing is trimmable, so it fits the 'lean and efficient' top anchor rather than 4.

5 / 5

Actionability

Guidance is highly concrete — named metrics (`p99_latency_ms`, `error_rate`, `db_pool_utilization`), named services and deps (checkout/cart/auth/inventory, `db-primary`, `db-inventory`, `idp.internal`), an exact output path, and a copy-paste JSON template. It stops short of the 5 anchor because the mechanisms for 'Pull deploys' and 'grep the log' (which tool or command) are never specified — minor gaps against 'fully copy-paste ready'.

4 / 5

Workflow Clarity

A clear numbered sequence with an explicit confirmation step ('Then grep the log to confirm'), a decision branch for the no-deploy case ('No deploy lines up → ... Find what moved first'), and a checklist of what to look for in diffs. This is read-only triage so the destructive/batch validation cap does not apply, and 'State the gap' plus the `ruled_out` field in the write-up enforce evidence checkpoints — matching the top anchor rather than 4, which requires missing checkpoints.

5 / 5

Progressive Disclosure

A self-contained ~50-line runbook with three well-organized sections (Order of operations, Things that have burned us, Write-up) and no bundle files; nothing belongs in a separate reference and there is no nesting or buried content. Per the under-50-line guideline, well-organized sections alone justify the top anchor.

5 / 5

Total

19

/

20

Passed

Description

82%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 that explicitly covers both what the skill does and when to use it, with natural trigger phrasing including the quoted user question 'what caused X'. Its main limitation is that 'triaging' is the only action verb, leaving the capability list thinner than the domain framing suggests.

Suggestions

Enumerate 2-3 concrete triage actions in the description (e.g., 'correlates deploys with latency and error-rate metrics, traces upstream dependencies, and produces a root-cause write-up') to lift specificity beyond a single action verb.

Add incident vocabulary users naturally say — 'outage', 'page/alert', '5xx errors', 'service is down' — to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

It names the domain ('production latency and error-rate incidents') and a single action ('triaging'), matching the 'domain plus 1-2 concrete actions' anchor. It does not list several specific actions, so it is not a 4.

3 / 5

Completeness

Both halves are explicit: what ('The SRE team's runbook for triaging production latency and error-rate incidents') and when ('Use this whenever investigating an incident, a latency spike, elevated error rates, or when asked "what caused X" about a production service') with concrete trigger phrases — the top anchor. A 4 would require a less explicit or specific 'when' clause.

5 / 5

Trigger Term Quality

Natural triggers users would actually say are present: 'investigating an incident', 'a latency spike', 'elevated error rates', and 'what caused X'. Common incident vocabulary like 'outage', 'page/alert', or '5xx errors' is missing, so coverage is good but not comprehensive (not a 5).

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (SRE production incident triage) with distinct triggers that would not plausibly fire a document, commit-message, or general-file skill — minimal conflict risk, matching the top anchor.

5 / 5

Total

17

/

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

anthropics/cwc-workshops

Path

ship-your-first-managed-agent/skills/incident-triage-runbook/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.