reflect

Visión general de la skill reflect

Para qué sirve reflect

reflect es una skill de Skill Validation para una segunda revisión: toma una respuesta ya terminada o casi terminada y la somete a presión para detectar fallos que se pasaron por alto, razonamientos débiles o aprobaciones demasiado confiadas. La reflect skill es especialmente útil cuando necesitas un filtro de calidad rápido pero escéptico, no una solución nueva.

Quién debería instalarla

Usa reflect si revisas trabajo generado por IA, publicas respuestas orientadas a producción o necesitas una comprobación disciplinada de “¿esto debería pasar?”. Encaja con agentes que puedan aportar la salida previa junto con el contexto de la tarea. Si lo que buscas es ayuda para idear o redactar desde cero, esta no es la skill adecuada.

Qué la hace diferente

La skill está construida alrededor de la clasificación de complejidad, las comprobaciones de confianza y una retroalimentación orientada a la verificación. Eso significa que instalar reflect aporta valor sobre todo cuando quieres que el modelo decida cuán a fondo debe revisar y concentre el escrutinio donde es más probable que falle algo. Se trata menos de pulir el estilo y más de detectar defectos antes de que se propaguen.

Cómo usar la skill reflect

Instala reflect y pásale una respuesta previa

Instala la skill reflect en tu entorno de agente y luego invócala con la salida objetivo que quieres revisar. El patrón de instalación del propio repositorio es npx skills add NeoLabHQ/context-engineering-kit --skill reflect. Para obtener mejores resultados, incluye el prompt original, la respuesta en borrador y cualquier criterio de aceptación.

Dale la forma de entrada correcta

reflect funciona mejor cuando la entrada deja claros la tarea, lo que está en juego y el umbral de confianza. Un prompt sólido sería: “Reflexiona sobre esta nota de despliegue para comprobar su corrección y riesgos omitidos; haz una reflexión profunda si la confianza es inferior al 90%”. Un prompt débil sería solo: “Revísalo”. Cuanto más explícitos sean tus criterios de aprobado/rechazado, más útil será la revisión.

Lee primero estos archivos

Empieza por SKILL.md; contiene las reglas básicas, la identidad y la lógica de triaje que determinan cómo se comporta la skill. Si estás adaptando la skill dentro de un kit más grande, revisa también README.md, AGENTS.md y cualquier archivo de políticas a nivel de repositorio para que la fase de reflexión encaje con tu flujo real. En este repositorio, SKILL.md es la principal fuente de verdad.

Usa la skill como filtro de revisión

Un flujo práctico de reflect usage es: redactar la respuesta, ejecutar reflect y luego revisar solo las partes que la evaluación señale como arriesgadas. No le pidas que vuelva a redactarlo todo salvo que la salida original sea inutilizable. El mejor uso de reflect guide es uno acotado: verificar afirmaciones, sacar a la luz restricciones omitidas y decidir si el borrador es seguro para publicarse.

Preguntas frecuentes sobre la skill reflect

¿Reflect es un prompt general de escritura?

No. reflect no está pensado para producir el primer borrador; está pensado para evaluarlo. Si lo usas como un prompt normal de generación, pierdes la principal ventaja de la reflect skill: un escrutinio disciplinado después de la respuesta.

¿Cuándo no encaja reflect?

Es una mala opción cuando no hay una respuesta previa que evaluar, cuando la tarea es puramente creativa o cuando necesitas ideación amplia en lugar de una revisión centrada en descartar. También resulta menos útil si no puedes aportar suficiente contexto para juzgar corrección o completitud.

¿Reflect es apto para principiantes?

Sí, siempre que el usuario pueda aportar un borrador y un objetivo. No hace falta conocer todo el repositorio para usarlo, pero sí debes decir qué significa “bueno”. Para principiantes, la mayor ventaja es simplemente dejar explícitos los criterios de revisión antes de llamar a reflect for Skill Validation.

¿En qué se diferencia de un prompt corriente?

Un prompt corriente suele pedir una solución. reflect pide una crítica de esa solución bajo incertidumbre, con más atención a lagunas y falsa confianza. Eso lo hace mejor para QA, comprobaciones de aceptación y salidas de alto riesgo que para la generación en primera pasada.

Cómo mejorar la skill reflect

Ajusta la evidencia que le das

Los mejores resultados de reflect vienen de entradas concretas: la tarea original, la respuesta en borrador y los modos de fallo que más te preocupan. Si el trabajo es técnico, incluye restricciones, casos límite y el público objetivo. Si el trabajo es de políticas o editorial, incluye las normas que debe cumplir.

Pide la profundidad adecuada

Usa de forma intencional el disparador de confianza de la skill. Si el borrador es simple, pide una comprobación rápida; si es ambiguo o de alto riesgo, solicita una reflexión profunda y criterios explícitos de rechazo. Así evitas que reflect sobreanalice casos fáciles o revise por encima los riesgosos.

Vigila los fallos más comunes

Los problemas habituales son una aprobación vaga, críticas sin base y falta de verificación frente a las restricciones reales. Para mejorar la salida de reflect skill, pídele que cite el problema específico, explique por qué importa y señale si el borrador debe aprobarse sin cambios, revisarse o rechazarse.

Itera después de la primera revisión

Trata la primera reflexión como un paso de triaje, no como el veredicto final. Revisa el borrador y vuelve a ejecutar reflect sobre la versión actualizada para confirmar que los arreglos realmente cerraron las brechas. Aquí es donde la skill demuestra su valor: menos aprobaciones falsas, re-trabajo más claro y un filtro final más sólido.