runbook-generator

Generate operational runbooks from a service name — deployment, incident response, maintenance, and rollback workflows. Templated structure customizable per environment. Use when documenting on-call procedures for a new service, standardizing incident response across teams, or producing runbooks before launching to production.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

75%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-organized, mostly lean skill body with concrete quick-start commands, a clear workflow, and correctly-signaled bundle references. Minor gaps in output examples, feedback loops, and section consolidation keep each dimension at a solid 4.

Suggestions

Show a short example of the generated runbook skeleton so users know what to expect without running the script first.

Add an explicit validate→fix→retry step to the Recommended Workflow (e.g., verify generated sections against the template, fix gaps, re-check) to strengthen feedback loops.

Consolidate the overlapping Overview, Core Capabilities, and When to Use sections to tighten conciseness.

Dimension	Reasoning	Score
Conciseness	The body is lean with no concept over-explanation and real copy-pasteable commands, but Overview, Core Capabilities, and When to Use mildly restate each other and could be consolidated to reach a 5.	4 / 5
Actionability	Quick Start gives concrete executable commands ('python3 scripts/runbook_generator.py payments-api' and a flagged --owner/--output variant), but there is no example of the generated runbook output, leaving a minor gap.	4 / 5
Workflow Clarity	The Recommended Workflow lists a clear 5-step sequence including a 'Dry-run in staging' checkpoint, but lacks an explicit validate→fix→retry feedback loop that would justify a 5.	4 / 5
Progressive Disclosure	The body is an overview that cleanly signals one-level-deep references to the real files references/runbook-templates.md and scripts/runbook_generator.py, with content appropriately split; only the single reference listing keeps it from a 5.	4 / 5
	Total	16 / 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, specific description that clearly states capabilities and provides explicit 'Use when…' trigger guidance with natural on-call/incident-response vocabulary. The only minor gap is slightly limited synonym coverage in the trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'deployment, incident response, maintenance, and rollback workflows' plus 'templated structure customizable per environment' — giving comprehensive coverage of runbook types rather than vague language.	5 / 5
Completeness	Explicitly answers both what ('Generate operational runbooks from a service name…') and when ('Use when documenting on-call procedures for a new service, standardizing incident response across teams, or producing runbooks before launching to production') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural phrases users would say are present — 'on-call procedures', 'incident response', 'runbooks' — but coverage stops short of synonyms/variations that would warrant a 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (operational runbooks for services) with distinct triggers (on-call procedures, incident response, runbooks) and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: alirezarezvani/claude-skills
Path: engineering/skills/runbook-generator/SKILL.md
Commit: 19392f7

Reviewed: ~5 hours ago

Table of Contents

Discovery Implementation Validation

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.