health

Visión general de health skill

Qué hace health skill

health ejecuta una auditoría de salud de agentes con criterio de presupuesto para Codex, Claude Code, Pi, instrucciones del agente, hooks/MCP, superficies de verificación y mantenibilidad de IA. Está pensado para quienes necesitan una guía práctica de salud para entender por qué un agente ignora instrucciones, se salta la verificación o deriva hacia un comportamiento difícil de mantener.

Mejor encaje y función principal

Usa este health skill cuando necesites una comprobación rápida de configuración y flujo de trabajo, no una revisión de código. Es especialmente útil para trabajos de estilo Security Audit, porque ayuda a determinar si la pila de agentes es lo bastante fiable como para apoyarte en ella antes de revisar la lógica de la app, el manejo de secretos o el cumplimiento de políticas.

Qué lo diferencia

Este skill tiene una postura clara sobre la salud por capas de los agentes: superficies de configuración, archivos de instrucciones, herramientas/runtime, verificadores y mantenibilidad. Eso hace que el resultado esté más listo para tomar decisiones que un prompt genérico, porque puede señalar la capa desalineada en lugar de limitarse a decir que “algo no cuadra”.

Cómo usar health skill

Contexto de instalación y primeros archivos

Instala health skill con npx skills add tw93/Waza --skill health. Después de instalarlo, lee primero SKILL.md y luego revisa agents/inspector-context.md, agents/inspector-control.md y agents/inspector-maintainability.md para entender qué espera la auditoría y qué evidencia prioriza.

Qué información necesita el skill

health skill funciona mejor cuando aportas señales específicas del repositorio: archivos de instrucciones del agente, ajustes de hooks o MCP, comandos de verificación y síntomas como “Claude ignora AGENTS.md” o “la configuración de Codex parece correcta, pero el comportamiento es inconsistente.” Si quieres un resultado útil de uso de health, incluye la ruta exacta del repo, la plataforma de agente y el modo de fallo que observaste.

Cómo formular una buena solicitud

Una petición débil sería “check health”. Una mejor sería: “Run a health audit on this repo for Claude Code and Codex. Focus on instruction layering, hooks, verifier coverage, and whether AI maintainability is likely to degrade. Call out any broken paths, stale references, or missing verification surfaces.” Eso le da al skill el alcance suficiente para producir una auditoría útil para la toma de decisiones.

Flujo de trabajo y orden de lectura del repositorio

Usa primero los scripts de recopilación del repositorio si están disponibles, y luego revisa los resultados de la auditoría antes de leer el código fuente bruto. En este repo, las rutas prácticas son scripts/check_agent_context.py, scripts/check_doc_refs.py, scripts/check_maintainability.py y scripts/check_verifier_output.py. Ese orden te ayuda a ubicar dónde está el problema antes de inspeccionar manualmente cada archivo.

Preguntas frecuentes sobre health skill

¿Esto es solo para comprobaciones de configuración?

No. health skill sirve para auditorías de configuración de agentes, deriva de instrucciones, vacíos de verificación y riesgo de mantenibilidad. No está pensado para depurar fallos de la aplicación ni para revisar el diff de un pull request.

¿Cuándo no debería usar health skill?

No lo uses si solo quieres una corrección a nivel de código, un diagnóstico de un bug o una reescritura puntual de un prompt. Si el repo es pequeño y no tiene superficies de agente, normalmente basta con un prompt simple; health skill aporta más valor cuando hay varios archivos de agente, hooks o capas de verificación.

¿Es health skill apto para principiantes?

Sí, si puedes proporcionar el repo y el síntoma. El error más común al empezar es pedir un “health check” vago sin decir qué agente, qué superficie de instrucciones o qué paso de verificación parece roto. Cuanto más precisa sea la entrada, más accionable será la salida.

¿En qué se diferencia de un prompt genérico?

Un prompt genérico puede resumir preocupaciones, pero health skill está diseñado para inspeccionar de forma sistemática las superficies del agente y repartir su atención con criterio. Eso importa cuando necesitas una decisión de instalación de health para flujos de trabajo de Security Audit, donde la falta de validación o unas instrucciones obsoletas pueden minar la confianza sin hacer ruido.

Cómo mejorar health skill

Dale el síntoma y el límite correctos

Indica si te importa Claude Code, Codex, Pi o los tres, y nombra el fallo: instrucciones ignoradas, hooks ausentes, cobertura débil del verificador o deriva en la mantenibilidad de IA. Si conoces el límite, el skill puede evitar gastar atención en una estructura del repo que no viene al caso.

Aporta evidencia, no solo una conclusión

Las entradas más sólidas incluyen los archivos o fragmentos relevantes: AGENTS.md, superposiciones de instrucciones locales, configuración, configuración de hooks y cualquier salida de comandos que muestre el fallo. Por ejemplo, “AGENTS.md dice que hay que verificar con make test, pero el repo solo tiene pytest -q” es mucho mejor que “las pruebas parecen raras”.

Itera después de la primera auditoría

Usa el primer resultado para decidir si el problema está en la capa de instrucciones, en una incompatibilidad de herramientas/runtime o en la debilidad del verificador, y luego vuelve a ejecutar la auditoría con un objetivo más acotado. Si el skill dice que la pila de agentes está sana pero la mantenibilidad es frágil, pide una segunda pasada centrada en densidad de TODOs, ownership de hotspots y referencias obsoletas en la documentación en lugar de reauditar todo.