Sop Creator

Gjør en prosess om til en skannbar runbook eller SOP med en Definition-of-Done sjekkliste

av coleam00 · coleam00/second-brain-skills

Bestått ★ 9.2/10

Sop Creator — Gjør en prosess om til en skannbar runbook eller SOP med en Definition-of-Done sjekkliste

Hva den gjør

Genererer operasjonell dokumentasjon (runbooks, deployment playbooks, feilsøkingsguider, sjekklister, onboarding-guider, beslutningstrær) fra en beskrevet prosess, ved hjelp av seks markdown-maler som hver starter med en Definition-of-Done sjekkliste. Utløses når brukeren ber om å opprette en runbook, dokumentere en prosess, skrive en playbook, eller formalisere en repeterbar teknisk prosedyre. Anvender spesifisitetsregler som erstatter vag formulering og passiv stemme med imperative, nummererte, verifiserbare trinn.

Testrapport

Hentet SKILL.md og stikkprøvekontrollerte 3 av 7 referansemaler (runbook.md, standard-sop.md, checklist.md) — alle HTTP 200; frontmatter parses med name+description; ingen skript eller sikkerhetsbrudd (ren markdown). For OUTPUT skrev jeg en "checkout API high 5xx rate runbook" to ganger: en baseline (21 linjer, 3 prosa-avsnitt, passiv stemme, vage fraser som "as appropriate"/"regularly", null kommandoer, null avkrysningsbokser, ingen metadata) og en ferdighetsfulgt versjon (73 linjer) etter å ha anvendt runbook-malen og skrevet regler. Ferdighetsversjonen la til 5 kjørbare kubectl-blokker, 12 avkrysningsbokser, en Definition-of-Done med numeriske terskler (5xx<0.1% for 10 min), en symptom-årsak-fiks-tabell, en advarsel-først rollback-blokk, og trinnvise "Done when"-kriterier — som direkte eliminerer de vage/passive anti-mønstrene ferdigheten navngir.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

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/.

Kommandoer og eksempelprompter

  • /sop-creatorGjør en prosess om til en skannbar runbook eller SOP med en Definition-of-Done sjekkliste

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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