Sop Creator

Transforme un processus en un runbook ou SOP scannable avec une liste de contrôle Definition-of-Done

par coleam00 · coleam00/second-brain-skills

Testé · Fonctionne ★ 9.2/10

Sop Creator — Transforme un processus en un runbook ou SOP scannable avec une liste de contrôle Definition-of-Done

Ce que fait

Génère de la documentation opérationnelle (runbooks, playbooks de déploiement, guides de dépannage, listes de contrôle, guides d'intégration, arbres de décision) à partir d'un processus décrit, en utilisant six modèles Markdown qui commencent chacun par une liste de contrôle Definition-of-Done. Se déclenche lorsque l'utilisateur demande de créer un runbook, de documenter un processus, d'écrire un playbook ou de formaliser une procédure technique reproductible. Applique des règles de spécificité qui remplacent les formulations vagues et la voix passive par des étapes impératives, numérotées et vérifiables.

Rapport de test

Récupéré SKILL.md et vérifié 3 des 7 modèles de référence (runbook.md, standard-sop.md, checklist.md) — tous HTTP 200 ; le frontmatter est parsé avec name+description ; pas de scripts ou de problèmes de sécurité (markdown pur). Pour la SORTIE, j'ai écrit deux fois un "runbook de vérification du taux élevé de 5xx de l'API" : une référence (21 lignes, 3 paragraphes de prose, voix passive, phrases vagues comme "as appropriate"/"regularly", zéro commandes, zéro cases à cocher, pas de métadonnées) et une version suivant la compétence (73 lignes) après avoir appliqué le modèle de runbook et écrit des règles. La version de la compétence a ajouté 5 blocs kubectl exécutables, 12 cases à cocher, une Definition-of-Done avec des seuils numériques (5xx<0.1% pendant 10 min), un tableau symptôme-cause-solution, un bloc de rollback avec avertissement en premier, et des critères "Done when" par étape — éliminant directement les anti-modèles vagues/passifs nommés par la compétence.

Testé le: 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/.

Commandes et exemples de prompts

/sop-creatorTransforme un processus en un runbook ou SOP scannable avec une liste de contrôle Definition-of-Done

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →