Sop Creator

Convierte un proceso en un runbook escaneable o SOP con una lista de verificación de Definición de Hecho

Por coleam00 · coleam00/second-brain-skills

Probado · Funciona ★ 9.2/10

Sop Creator — Convierte un proceso en un runbook escaneable o SOP con una lista de verificación de Definición de Hecho

Qué hace

Genera documentación operativa (runbooks, playbooks de despliegue, guías de solución de problemas, listas de verificación, guías de incorporación, árboles de decisión) a partir de un proceso descrito, utilizando seis plantillas markdown que cada una comienza con una lista de verificación de Definición de Hecho. Se activa cuando el usuario solicita crear un runbook, documentar un proceso, escribir un playbook o formalizar un procedimiento técnico repetible. Aplica reglas de especificidad que reemplazan frases vagas y voz pasiva con pasos imperativos, numerados y verificables.

Informe de la prueba

Obtuve SKILL.md y verifiqué 3 de 7 plantillas de referencia (runbook.md, standard-sop.md, checklist.md) — todas HTTP 200; el frontmatter se analiza con name+description; no hay scripts ni indicios de seguridad (markdown puro). Para la SALIDA, escribí un "runbook de alta tasa de 5xx de la API de checkout" dos veces: una línea base (21 líneas, 3 párrafos en prosa, voz pasiva, frases vagas como "según corresponda"/"regularmente", cero comandos, cero casillas de verificación, sin metadatos) y una versión siguiendo la skill (73 líneas) después de aplicar la plantilla de runbook y las reglas de escritura. La versión de la skill añadió 5 bloques kubectl ejecutables, 12 casillas de verificación, una Definición de Hecho con umbrales numéricos (5xx<0.1% durante 10 min), una tabla de síntoma-causa-solución, un bloque de rollback con advertencia primero, y criterios "Done when" por paso — eliminando directamente los anti-patrones vagos/pasivos que la skill nombra.

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

Instalación

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

Comandos y prompts de ejemplo

/sop-creatorConvierte un proceso en un runbook escaneable o SOP con una lista de verificación de Definición de Hecho

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →