make-it-runbook SKILL.md skillA

make-it-runbook from mostafa-drz/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mostafa-drz/claude-skills/make-it-runbook@git:20260922.9ce28fa

Pins git:20260922.9ce28fa in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mostafa-drz/claude-skills
Path
desktop/make-it-runbook/SKILL.md
Versions recorded
1
Latest version
git:20260922.9ce28fa, committed Sep 22, 2026
Size
8,852 bytes
Repository stars
5
License
MIT

Turns the current conversation into a trackable, phase-by-phase runbook: a page with a checkbox per step, a progress bar, amber bars for forced waits, notes for warnings, and copyable literal values (commands, DNS records, amounts). Distills the chat first, so only the final agreed state survives: advice that was later corrected, changed values and tangents are dropped, steps run in real execution order, and each wait sits where it actually blocks. Ticks persist in the browser; prints to PDF…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Make it a runbook

You worked something out in the chat: an email setup, a migration, a move. The steps are
scattered across twenty messages, some were corrected halfway, and a couple of them have
to wait a day. This turns that into one page you can work through: tick as you go, come
back tomorrow, and never follow the advice that was later taken back.

In Claude Desktop and claude.ai the skill starts automatically on a matching request, with
no slash command. "Make it a runbook" is the natural trigger.

Two references, loaded when a step needs them:
[`distill.md`](./references/distill.md) (turning a messy conversation into the final agreed
steps: **read it every time**) · [`runbook-schema.md`](./references/runbook-schema.md) (the
data the page renders from, and the id rules).

---

## The flow

`conversation → distill → runbook.json → validate → page`. Copy this checklist into your
reply and tick it off, because the distillation is where a confident-looking runbook goes
wrong:

```
Runbook progress:
- [ ] 1. Distill: ledger → final agreed steps, execution order, waits, notes, literals
- [ ] 2. Ask only what blocks the shape (≤3 questions, defaults) or flag it on the step
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mostafa-drz/claude-skills/make-it-runbook@sha256:caaa89f11f36b3c2

The line at the top of this page pins the label git:20260922.9ce28fa, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2wqineltvb2jjrva.svg)](https://markdownregistry.com/a/art_2wqineltvb2jjrva)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 22, 2026.

versioncommittedcommitsizeaudit
git:20260922.9ce28fa latest2026-09-22 9ce28fa 8,852 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8852 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mostafa-drz/claude-skills · 5 stars · license MIT · pushed 2026-10-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2wqineltvb2jjrva
GET https://markdownregistry.com/api/v1/resolve?ref=mostafa-drz/claude-skills/make-it-runbook
GET https://markdownregistry.com/api/v1/blob/caaa89f11f36b3c251a31b4f3c2e62526b1f5c2716fbdf698b48cb1c82e6d2ea

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mostafa-drz/claude-skills

address-pr-comments SKILL.md skill
mostafa-drz/claude-skills · code/address-pr-comments/SKILL.md · Fetches unresolved PR comments, categorizes them (must-fix, suggestion, question, nit), proposes fixes or replies for…
git:20260911.22df896 · audit A · 5 stars
address-pr-feedback SKILL.md skill
mostafa-drz/claude-skills · code/address-pr-feedback/SKILL.md · Comprehensively addresses PR feedback by fetching all comments, deploying parallel agents for critical analysis of each…
git:20260911.22df896 · audit A · 5 stars
audit-skills SKILL.md skill
mostafa-drz/claude-skills · code/audit-skills/SKILL.md · Audits all personal Claude skills against the SKILLS_GUIDE.md manifest, latest official Claude skills documentation…
git:20260911.22df896 · audit A · 5 stars
audit-ui-e2e SKILL.md skill
mostafa-drz/claude-skills · code/audit-ui-e2e/SKILL.md · Runs a beginner-mind end-to-end UI audit of any running app — local dev server, staging, production, or a specific URL…
git:20260911.22df896 · audit A · 5 stars
build-incremental SKILL.md skill
mostafa-drz/claude-skills · code/build-incremental/SKILL.md · Implements code in progressive, verified increments — auto-detects the project's toolchain, builds each unit, runs…
git:20260911.22df896 · audit A · 5 stars
build-until-agreed SKILL.md skill
mostafa-drz/claude-skills · code/build-until-agreed/SKILL.md · Builds toward a goal agreed up front, then has independent read-only auditors judge whether it is actually met —…
git:20260915.01439e8 · audit A · 5 stars
capture-screens SKILL.md skill
mostafa-drz/claude-skills · code/capture-screens/SKILL.md · Automatically navigates a web app using Playwright MCP and captures context-aware named screenshots at each product…
git:20260911.22df896 · audit A · 5 stars
chunk-pr SKILL.md skill
mostafa-drz/claude-skills · code/chunk-pr/SKILL.md · Analyzes a large pull request (or branch, or commit range) and proposes a sequence of smaller, logically-grouped…
git:20260911.22df896 · audit A · 5 stars
clean-copy SKILL.md skill
mostafa-drz/claude-skills · code/clean-copy/SKILL.md · Cleans terminal-formatted text and copies it to the macOS clipboard via pbcopy, formatted for the target platform…
git:20260911.22df896 · audit A · 5 stars
compliance-audit SKILL.md skill
mostafa-drz/claude-skills · code/compliance-audit/SKILL.md · Audits codebases against compliance frameworks (SOC2, HIPAA, PCI-DSS, GDPR, ISO27001, etc.) using parallel agents per…
git:20260911.22df896 · audit A · 5 stars
create-pr SKILL.md skill
mostafa-drz/claude-skills · code/create-pr/SKILL.md · Creates a well-structured pull request with product-focused summary, change highlights, and test steps. Auto-detects…
git:20260911.22df896 · audit A · 5 stars
daily-brief SKILL.md skill
mostafa-drz/claude-skills · code/daily-brief/SKILL.md · Surfaces recent updates relevant to you from GitHub, Linear, Slack, and other configured sources — PR reviews, new…
git:20260911.22df896 · audit A · 5 stars

Every file in mostafa-drz/claude-skills

Browse by kind, by grade A, or by owner.