santa-method

Descripción general de la skill santa-method

Para qué sirve santa-method

La skill santa-method es un flujo de verificación multiagente para salidas que tienen que estar correctas antes de publicarse. Es especialmente útil para contenidos, entregables cercanos al código y cualquier material de cara al cliente o regulado en el que un solo paso del modelo resulte demasiado arriesgado. Su valor principal no es redactar más rápido; es reducir los puntos ciegos mediante revisión independiente.

Quién debería usarla

Usa la skill santa-method si necesitas un bucle de revisión repetible para trabajos publicados, código destinado a producción, texto sensible a cumplimiento normativo o generación de gran volumen en la que las comprobaciones manuales puntuales se quedan cortas. Encaja mejor cuando el trabajo real es “generar, verificar, converger” que cuando solo quieres una lluvia de ideas rápida o un primer borrador aproximado.

Qué la diferencia

A diferencia de un prompt normal que pide a un solo modelo que se autocorrija, santa-method separa de forma deliberada la generación de la revisión. Eso importa cuando el modo de fallo es un sesgo compartido, casos límite pasados por alto o afirmaciones sin respaldo. La skill se basa en el patrón de “hacer una lista, revisarla dos veces”, así que el resultado queda más preparado para tomar decisiones que un prompt genérico de una sola pasada.

Cómo usar la skill santa-method

Instalar y localizar la fuente

Instala la skill santa-method con npx skills add affaan-m/everything-claude-code --skill santa-method. Después de instalarla, abre primero SKILL.md, porque ahí está la definición del flujo y la guía de activación. En este repositorio no hay scripts auxiliares ni carpetas de apoyo, así que el archivo de la skill es la fuente principal de verdad.

Dale el tipo de tarea correcto

El patrón de uso de santa-method funciona mejor cuando le das un entregable concreto, una audiencia clara y el perfil de riesgo. Las buenas entradas nombran el formato objetivo, las restricciones y los criterios de aceptación. Por ejemplo: “Redacta una nota de cambios de cara al cliente para una actualización de API con cambios incompatibles; verifica cada afirmación contra las notas de la versión; marca cualquier cosa incierta.” Eso es mejor que “escribe una buena nota de cambios”.

Moldea tu prompt para lograr convergencia

Un prompt útil para santa-method debe decirle al modelo qué generar, qué revisar y qué tiene que ser cierto antes de aceptar la salida final. Incluye el material de origen, el estándar requerido y los casos de fallo que quieres que detecte. Si vas a usar santa-method para Workflow Automation, especifica las herramientas, la condición de activación y el punto exacto de traspaso entre generación y revisión para que la skill evalúe la integridad del flujo de trabajo y no solo la redacción.

Lee primero para tener contexto práctico

Empieza por SKILL.md y luego revisa las secciones sobre cuándo activarla, arquitectura y detalles de las fases. Esas son las partes que determinan si la skill encaja y cómo ejecutarla correctamente. Si solo echas un vistazo superficial al repositorio, puedes perderte el límite clave: santa-method está pensada para salidas que deban resistir una revisión independiente, no para tareas en las que unas pruebas deterministas ya resuelven la corrección.

Preguntas frecuentes sobre la skill santa-method

¿Merece la pena instalar santa-method para prompts normales?

Si tu tarea puede darse por buena después de un solo borrador sólido, probablemente no. La skill santa-method es más valiosa cuando los errores son costosos, se repiten o son difíciles de detectar en una sola pasada. Para ideación informal, un prompt normal es más simple y rápido.

¿Santa-method sustituye las pruebas o la revisión humana?

No. Las complementa. Usa pruebas, linting y aprobación humana donde ya existan. santa-method ayuda sobre todo cuando esos controles son incompletos, caros o no aplican al tipo de salida, especialmente en trabajos narrativos, de políticas o de juicio mixto.

¿La skill santa-method es apta para principiantes?

Sí, si puedes formular el objetivo con claridad y aportar material de origen. No hace falta tener conocimientos profundos sobre flujos de trabajo con agentes para usarla bien. Lo importante es dar al modelo una tarea acotada y suficiente contexto para que la fase de verificación tenga sentido.

¿Cuándo debería evitar santa-method?

Evítala en la exploración temprana, en notas internas o en tareas donde una comprobación directa con herramientas sea más rápida y fiable. Tampoco la uses si no puedes aportar suficiente verdad de origen para la fase de revisión; el método solo es tan fuerte como la evidencia que puede inspeccionar.

Cómo mejorar la skill santa-method

Aporta una verdad de origen más sólida

Los mejores resultados de santa-method vienen de entradas que distinguen entre hechos, supuestos y preguntas abiertas. Proporciona el documento fuente, enlaces, requisitos o el texto exacto que hay que verificar. Si pides “un resumen pulido de la política”, los revisores tendrán poco que comprobar; si pides “un resumen que conserve cada paso de aprobación y señale cualquier requisito que falte”, el bucle de verificación sí aporta valor.

Define criterios explícitos de rechazo

Dile a la skill qué debe provocar una revisión: afirmaciones sin respaldo, casos límite omitidos, redacción débil, deriva de la política o pasos incompletos. Esto es especialmente importante para santa-method en Workflow Automation, donde un flujo puede parecer limpio mientras oculta una dependencia rota, un trigger ambiguo o una ausencia de fallback. Unas condiciones de parada claras hacen la fase de revisión mucho más precisa.

Vigila los modos de fallo más comunes

El fallo habitual es una salida demasiado segura de sí misma que supera las comprobaciones de estilo pero no las de hechos. Otro es una revisión que simplemente reescribe el borrador en vez de cuestionarlo. Si ocurre eso, acota el prompt a un solo entregable, pide comprobaciones independientes frente a criterios concretos y exige una pasada final que incluya solo contenido validado.

Itera después del primer paso

Trata la primera salida como una candidata, no como el estado final. Si la revisión detecta problemas, devuelve los defectos exactos y pide una versión corregida con los mismos criterios de aceptación. La guía de santa-method funciona mejor cuando cada iteración es más pequeña y más precisa que la anterior, porque la convergencia mejora cuando el modelo se ve obligado a resolver huecos concretos en lugar de reescribir desde cero.