Home / mostafa-drz / claude-skills · desktop/make-it-runbook/SKILL.md · GitHub

make-it-runbook skillA

make-it-runbook is agent-read markdown (skill) from mostafa-drz/claude-skills: 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 wit.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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

Latest version
mdr add mostafa-drz/claude-skills/make-it-runbook@git:20260922.9ce28fa
Exact content
mdr add mostafa-drz/claude-skills/make-it-runbook@sha256:caaa89f11f36b3c2

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

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

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 · 4 stars · license MIT · pushed 2026-09-24 · 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 agent 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.

More from mostafa-drz/claude-skills

address-pr-comments 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 · 4 stars
address-pr-feedback 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 · 4 stars
audit-skills 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 · 4 stars
audit-ui-e2e 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 · 4 stars
build-incremental 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 · 4 stars
build-until-agreed 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 · 4 stars
capture-screens 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 · 4 stars
chunk-pr 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 · 4 stars
clean-copy 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 · 4 stars
compliance-audit 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 · 4 stars
create-pr 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 · 4 stars
daily-brief 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 · 4 stars

Every file in mostafa-drz/claude-skills

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