Sop Creator

Trasforma un processo in un runbook o SOP scansionabile con una checklist Definition-of-Done

di coleam00 · coleam00/second-brain-skills

Promosso ★ 9.2/10

Sop Creator — Trasforma un processo in un runbook o SOP scansionabile con una checklist Definition-of-Done

Cosa fa

Genera documentazione operativa (runbook, playbook di deployment, guide alla risoluzione dei problemi, checklist, guide di onboarding, alberi decisionali) da un processo descritto, utilizzando sei template markdown che iniziano ciascuno con una checklist Definition-of-Done. Si attiva quando l'utente chiede di creare un runbook, documentare un processo, scrivere un playbook o formalizzare una procedura tecnica ripetibile. Applica regole di specificità che sostituiscono frasi vaghe e voce passiva con passaggi imperativi, numerati e verificabili.

Rapporto di test

Recuperato SKILL.md e controllati 3 dei 7 template di riferimento (runbook.md, standard-sop.md, checklist.md) — tutti HTTP 200; il frontmatter viene analizzato con name+description; nessuno script o problema di sicurezza (solo markdown puro). Per l'OUTPUT ho scritto due volte un "runbook per API con alto tasso di 5xx": una baseline (21 righe, 3 paragrafi in prosa, voce passiva, frasi vaghe come "se appropriato"/"regolarmente", zero comandi, zero checkbox, nessun metadato) e una versione seguendo la skill (73 righe) dopo aver applicato il template del runbook e scritto le regole. La versione della skill ha aggiunto 5 blocchi kubectl eseguibili, 12 checkbox, una Definition-of-Done con soglie numeriche (5xx<0.1% per 10 min), una tabella sintomo-causa-fix, un blocco di rollback con avviso iniziale e criteri "Done when" per ogni passaggio — eliminando direttamente gli anti-pattern vaghi/passivi che la skill nomina.

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

Installazione

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

Comandi e prompt di esempio

/sop-creatorTrasforma un processo in un runbook o SOP scansionabile con una checklist Definition-of-Done

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →