Sop Creator

Förvandlar en process till en skanningsbar runbook eller SOP med en Definition-of-Done-checklista

av coleam00 · coleam00/second-brain-skills

Testad · Fungerar ★ 9.2/10

Sop Creator — Förvandlar en process till en skanningsbar runbook eller SOP med en Definition-of-Done-checklista

Vad den gör

Genererar operationell dokumentation (runbooks, deployment playbooks, felsökningsguider, checklistor, onboarding-guider, beslutsträd) från en beskriven process, med hjälp av sex markdown-mallar som var och en inleds med en Definition-of-Done-checklista. Utlöses när användaren ber om att skapa en runbook, dokumentera en process, skriva en playbook, eller formalisera en repeterbar teknisk procedur. Tillämpar specificitetsregler som ersätter vag formulering och passiv röst med imperativa, numrerade, verifierbara steg.

Testrapport

Hämtade SKILL.md och punktkontrollerade 3 av 7 referensmallar (runbook.md, standard-sop.md, checklist.md) — alla HTTP 200; frontmatter parsas med namn+beskrivning; inga skript eller säkerhetsbrister (ren markdown). För UTDATA skrev jag en "checkout API high 5xx rate runbook" två gånger: en baseline (21 rader, 3 prosastycken, passiv röst, vaga fraser som "as appropriate"/"regularly", noll kommandon, noll kryssrutor, ingen metadata) och en skill-följande version (73 rader) efter att ha applicerat runbook-mallen och skrivit regler. Skill-versionen lade till 5 körbara kubectl-block, 12 kryssrutor, en Definition-of-Done med numeriska tröskelvärden (5xx<0.1% i 10 min), en symptom-orsak-fix-tabell, ett varnings-först-rollback-block, och per-steg "Done when"-kriterier — vilket direkt eliminerade de vaga/passiva anti-mönster som skillen nämner.

Testad: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/coleam00/second-brain-skills.git /tmp/sop-creator-src
mkdir -p ~/.claude/skills
cp -R /tmp/sop-creator-src/.claude/skills/sop-creator ~/.claude/skills/sop-creator
# No deps, no scripts, no API keys. Pure markdown skill + 7 reference templates.
# SKILL.md lands at ~/.claude/skills/sop-creator/SKILL.md; templates under references/.

Kommandon och exempelprompter

  • /sop-creatorFörvandlar en process till en skanningsbar runbook eller SOP med en Definition-of-Done-checklista

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • Create a runbook for our deployment process
  • Document the incident response procedure for our team
  • Write a playbook for onboarding new engineers