Sop Creator

Przekształca proces w skanowalny runbook lub SOP z listą kontrolną Definition-of-Done

Autor: coleam00 · coleam00/second-brain-skills

Testowano · Działa ★ 9.2/10

Sop Creator — Przekształca proces w skanowalny runbook lub SOP z listą kontrolną Definition-of-Done

Co robi ten skill

Generuje dokumentację operacyjną (runbooki, podręczniki wdrożeniowe, przewodniki rozwiązywania problemów, listy kontrolne, przewodniki wdrożeniowe, drzewa decyzyjne) z opisanego procesu, używając sześciu szablonów markdown, z których każdy zaczyna się od listy kontrolnej Definition-of-Done. Uruchamia się, gdy użytkownik prosi o utworzenie runbooka, udokumentowanie procesu, napisanie playbooka lub sformalizowanie powtarzalnej procedury technicznej. Stosuje zasady specyficzności, które zastępują niejasne sformułowania i stronę bierną imperatywnymi, numerowanymi, weryfikowalnymi krokami.

Raport z testu

Pobrano SKILL.md i sprawdzono 3 z 7 szablonów referencyjnych (runbook.md, standard-sop.md, checklist.md) — wszystkie HTTP 200; frontmatter parsowany z name+description; brak skryptów ani zagrożeń bezpieczeństwa (czysty markdown). Dla OUTPUT napisałem dwukrotnie "checkout API high 5xx rate runbook": baseline (21 linii, 3 akapity prozy, strona bierna, niejasne frazy takie jak "as appropriate"/"regularly", zero poleceń, zero pól wyboru, brak metadanych) i wersję zgodną z umiejętnością (73 linie) po zastosowaniu szablonu runbooka i napisaniu reguł. Wersja umiejętności dodała 5 uruchamialnych bloków kubectl, 12 pól wyboru, Definition-of-Done z progami liczbowymi (5xx<0.1% przez 10 min), tabelę symptom-cause-fix, blok rollback z ostrzeżeniem na początku i kryteria "Done when" dla każdego kroku — bezpośrednio eliminując niejasne/bierne antywzorce, które wymienia umiejętność.

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

Instalacja

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

Komendy i przykładowe prompty

  • /sop-creatorPrzekształca proces w skanowalny runbook lub SOP z listą kontrolną Definition-of-Done

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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