CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

incident-runbook-templates

Create structured incident response runbooks with step-by-step procedures, escalation paths, and recovery actions. Use this skill when building a service outage runbook for a payment processing system; creating database incident procedures covering connection pool exhaustion, replication lag, and disk space alerts; onboarding new on-call engineers who need step-by-step recovery guides written for a 3 AM brain; or standardizing escalation matrices across multiple engineering teams.

73

Quality

92%

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

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.

A well-structured instruction-style skill: the body stays at overview-and-failure-pattern altitude with fully executable snippets, the heavy worked templates are cleanly pushed to a single one-level reference file, and workflows carry explicit validation gates (dry-run checks, 'If this fails' notes, verification steps). The only slack is a 'When to Use' section that restates the description and a few generic Do's/Don'ts.

DimensionReasoningScore

Conciseness

The body is largely lean: a severity table with concrete response times, a 9-step structure skeleton, and five troubleshooting patterns each carried by a short executable snippet rather than prose. Not a 5 because there is minor trimmable material — the 'When to Use This Skill' bullet list substantially duplicates the frontmatter description's triggers, and some Do's/Don'ts ('Don't work alone - Escalate early', 'Don't skip postmortems') are generic advice Claude doesn't need; not a 3 because no section teaches concepts Claude already knows or pads with library-style exposition.

4 / 5

Actionability

Guidance is copy-paste ready throughout: a kubectl snippet with prerequisites, failure fallback, and expected output; a Quick Checklist markdown template; a Runbook Metadata table; a communication update agenda; and SQL with a WARNING, a dry-run count query, and an explicit 'EXECUTE only after verifying count is reasonable (< 50)' gate. These cover the common cases (outage triage, database recovery, stakeholder comms) the skill targets.

5 / 5

Workflow Clarity

The runbook structure gives a clear 1-9 sequence that explicitly includes '7. Verification & Rollback' as a checkpoint, and the body models feedback loops: the kubectl example pairs each step with prerequisites and 'If this fails' recovery, the destructive SQL is gated behind a dry-run count check before execution, and the Quick Checklist pattern tracks progress under stress. The destructive-operation cap is satisfied, so the sequence-with-validation anchor is fully met.

5 / 5

Progressive Disclosure

Scored against the actual bundle: references/ contains exactly one file, details.md (342 lines of worked runbook templates), which contains no nested references — one level deep. The body signals it clearly and with an explicit condition ('Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient'), and the split is appropriate: templates live in the reference, overview and failure patterns live in SKILL.md.

5 / 5

Total

19

/

20

Passed

Description

87%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 in the mold of the reference good examples: third-person imperative what-clause with concrete capabilities, followed by an explicit 'Use this skill when' clause enumerating four concrete triggering scenarios. Trigger coverage is good rather than comprehensive, and the what-clause omits a few capabilities the body actually delivers.

DimensionReasoningScore

Specificity

The what-clause names concrete actions — 'Create structured incident response runbooks with step-by-step procedures, escalation paths, and recovery actions' — comparable to the anchor-4 example's several distinct actions. Not a 5 because coverage has minor gaps: capabilities the body delivers (detection, triage, verification/rollback, communication templates) are absent from the description; not a 3 because far more than 1-2 actions are named, and the when-clause adds further concrete procedures (connection pool exhaustion, replication lag, disk space alerts).

4 / 5

Completeness

Both what and when are explicit: 'Create structured incident response runbooks with step-by-step procedures, escalation paths, and recovery actions' followed by 'Use this skill when building a service outage runbook... creating database incident procedures... onboarding new on-call engineers... or standardizing escalation matrices'. This matches the anchor-5 pattern of the PDF example: clear what plus concrete enumerated trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are well covered — 'service outage runbook', 'onboarding new on-call engineers', 'escalation matrices', 'connection pool exhaustion, replication lag, and disk space alerts'. Not a 5 because common variations are missing (e.g. 'production down/degraded', 'SEV1', 'incident commander', ' PagerDuty/page'); not a 3 because coverage clearly exceeds the single-domain-keyword anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (incident runbook authoring) with distinct triggers — outage runbooks, database incident procedures, on-call onboarding, escalation matrix standardization — that no generic skill would claim. Related skills (postmortem-writing, on-call-handoff) cover disjoint tasks and are not referenced in the description, so conflict risk is minimal.

5 / 5

Total

18

/

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

wshobson/agents

Path

plugins/incident-response/skills/incident-runbook-templates/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.