reflect
por alirezarezvanireflect es un skill de reevaluación a mitad de conversación para pausar la ejecución, releer desde el objetivo original, revisar sesgos y desvíos, y decidir si conviene continuar, pivotar o pausar. Úsalo para Decision Support, planificación, bucles de depuración y trabajo estratégico cuando necesitas una revisión franca de coherencia, no otro resumen.
Este skill obtiene 84/100, lo que lo convierte en una opción sólida para usuarios del directorio que buscan un flujo reutilizable de reevaluación a mitad de conversación, en lugar de un prompt genérico para “pensar más”. Es fácil de activar, tiene una disciplina de salida bien definida e incluye referencias útiles y scripts de validación, aunque su adopción sería más sencilla con instrucciones de instalación explícitas y ejemplos de inicio rápido más visibles.
- Superficie de activación muy clara: el frontmatter enumera frases explícitas como “reflect,” “take a step back,” “sanity check this,” además de disparadores implícitos como conversaciones largas en modo detalle o señales de bloqueo.
- El flujo operativo es específico: pausar la ejecución, releer la conversación, evaluar la perspectiva macro, las brechas, la indagación reflexiva, el sesgo y la alineación, y cerrar con una recomendación de continuar, pivotar o pausar.
- Buen material de apoyo: tres referencias enfocadas definen el canon de cinco sesgos, la práctica de reflexión y la disciplina de resultados honestos, mientras que los scripts ayudan a detectar patrones de sesgo, disparadores de profundidad y calidad de las recomendaciones.
- No hay un comando de instalación ni un README en la ruta del skill, por lo que los usuarios del directorio pueden necesitar seguir el patrón de instalación general del repositorio para adoptarlo.
- Los scripts de apoyo son explícitamente herramientas heurísticas basadas en regex y conteos; pueden señalar indicios, pero no sustituyen el juicio que exige el skill sobre toda la conversación.
Descripción general de reflect skill
Qué hace reflect
reflect es una skill de reevaluación a mitad de conversación para Claude: detiene la ejecución, vuelve a leer la conversación desde el objetivo original y ofrece un juicio directo sobre la dirección que se está tomando. En lugar de seguir profundizando en los detalles, reflect comprueba si el camino actual todavía tiene sentido, qué supuestos lo están guiando, qué podría faltar y si el siguiente paso debería ser continuar, cambiar de rumbo o pausar.
Resulta especialmente útil para Decision Support, planificación, trabajo de producto, ciclos de depuración, conversaciones estratégicas y cualquier intercambio largo en el que el avance táctico pueda estar ocultando una desviación estratégica.
Usuarios y situaciones donde mejor encaja
Instala reflect si sueles pedirle a un asistente de IA ayuda con trabajo de varios pasos y quieres un mecanismo fiable de “control de cordura”. Encaja con usuarios que suelen decir cosas como “demos un paso atrás”, “¿nos estamos dejando algo?”, “¿lo estamos complicando de más?”, “miremos esto con más perspectiva” o “¿seguimos bien encaminados?”.
Su caso de uso más potente no es resumir. Su verdadero trabajo es corregir la dirección: detectar sesgo de confirmación, pensamiento de coste hundido, anclaje, crecimiento innecesario de la complejidad o sesgo de recencia antes de que la conversación se comprometa con el camino equivocado.
Qué hace diferente a reflect
La skill está diseñada para pedir poco contexto adicional. Si la conversación previa ya contiene suficiente información, debería ejecutarse de inmediato en lugar de solicitar una preparación larga. Si el contexto es demasiado escaso, hace una única pregunta aclaratoria obligada en vez de convertir la reflexión en otro ejercicio de planificación.
Sus referencias de apoyo añaden una disciplina útil: la reflexión debe releer desde el objetivo original, evitar inventar problemas solo para parecer rigurosa y terminar con una recomendación concreta. Los scripts incluidos también son útiles para equipos que quieren probar transcripciones o validar si las salidas de reflexión son lo bastante específicas.
Cómo usar reflect skill
Instalación de reflect y ruta del repositorio
Instala la skill desde el repositorio de GitHub con:
npx skills add alirezarezvani/claude-skills --skill reflect
El código fuente está en:
productivity/reflect/skills/reflect
Lee primero SKILL.md y después revisa estos archivos para entender el modelo operativo:
references/cognitive_bias_canon.mdreferences/conversation_reflection_practice.mdreferences/honest_output_discipline.mdscripts/bias_pattern_detector.pyscripts/conversation_depth_analyzer.pyscripts/directional_recommendation_validator.py
Esta es una skill de razonamiento puro. No requiere APIs externas, bases de datos ni herramientas específicas de un proveedor más allá de un entorno de skills compatible.
Cómo invocar reflect en la práctica
Usa lenguaje directo dentro de una conversación activa:
- “Reflect on where we are before we continue.”
- “Take a step back. Are we solving the right problem?”
- “Sanity check this plan for bias and drift.”
- “Are we overthinking this, or is the complexity justified?”
- “Use reflect for Decision Support: should we continue, pivot, or pause?”
Un buen prompt para usar reflect incluye la presión de decisión, no solo el tema. Por ejemplo, en lugar de escribir “reflect on this”, escribe: “Reflect before we implement. Original goal: reduce onboarding friction. Current path: adding a multi-step configuration wizard. Check whether this is still aligned, what assumptions we are making, and whether we should continue, pivot, or pause.”
Entradas que mejoran la calidad del resultado
La skill funciona mejor cuando la conversación ya contiene el objetivo original, el plan actual, las restricciones y las decisiones recientes. Si esa información está dispersa, repítela brevemente antes de invocar reflect.
Patrón de entrada útil:
- Objetivo original: qué se suponía que significaba el éxito
- Dirección actual: qué está optimizando ahora la conversación
- Punto de decisión: a qué estás a punto de comprometerte
- Restricciones: plazos, tolerancia al riesgo, necesidades de usuarios, límites técnicos
- Preocupación: desviación, complejidad, sesgo, falta de evidencia o bloqueo
Esto ayuda a la skill a comparar el camino actual con el marco inicial, en lugar de reaccionar solo a los últimos turnos.
Flujo de trabajo opcional asistido por scripts
Los scripts no son obligatorios, pero son útiles para revisiones repetibles. Guarda una transcripción como texto plano con turnos User: y Assistant:, y luego ejecuta:
python scripts/conversation_depth_analyzer.py --conversation /tmp/transcript.txt
Usa bias_pattern_detector.py para marcar posibles patrones de sesgo y luego deja que la IA aplique criterio, en lugar de tratar las coincidencias de regex como prueba. Después de generar una reflexión, directional_recommendation_validator.py puede comprobar si la salida termina con una recomendación específica de continuar, cambiar de rumbo o pausar, y si evita tranquilizaciones vagas.
Preguntas frecuentes sobre reflect skill
¿reflect es solo un prompt de resumen mejorado?
No. Un resumen comprime lo que ocurrió; reflect juzga si la conversación sigue orientada al resultado correcto. La skill reflect debería sacar a la luz desviaciones, evidencia faltante, soluciones sobredimensionadas, restricciones ignoradas o impulso injustificado. Si todo está realmente bien fundamentado, debería decirlo con evidencia en lugar de fabricar objeciones.
¿Cuándo no debería usar reflect?
No lo uses para tareas simples de una sola interacción, búsquedas factuales o momentos en los que no hay contexto previo significativo que reevaluar. Tampoco encaja bien si solo quieres ánimo o comentarios de estilo. La skill está diseñada para interrumpir el impulso, algo valioso en trabajos complejos pero innecesario para tareas triviales.
¿reflect es apta para principiantes?
Sí, porque invocarla puede ser tan simple como decir “reflect” o “take a step back.” Las personas principiantes se benefician de su diseño de baja fricción, mientras que los usuarios avanzados pueden obtener mejores resultados dando el objetivo original, la decisión actual y el posible modo de fallo.
¿Cómo ayuda reflect para Decision Support a los equipos?
Para Decision Support, reflect ofrece una pausa estructurada antes de comprometerse con una decisión. Es útil antes de elegir una dirección de producto, cerrar un diseño técnico, continuar por una ruta de depuración o aceptar una recomendación. Su valor es mayor cuando el coste de seguir en la dirección equivocada supera el coste de pausar para reevaluar.
Cómo mejorar reflect skill
Dale a reflect un borde de decisión claro
La salida débil más común viene de una invocación vaga. “Reflect on our discussion” puede funcionar, pero “Reflect before we choose option B; check for anchoring, missing counterevidence, and whether we should continue, pivot, or pause” le da a la skill un objetivo mucho más preciso.
Si te preocupa un riesgo concreto, nómbralo. Por ejemplo: “I’m worried we are adding features because each one sounds reasonable individually. Check for complexity bias.”
Fuerza una reevaluación basada en evidencia
Una buena salida de reflect debería citar evidencia concreta de la conversación: el objetivo original, el punto en que cambió el encuadre, el supuesto que pasó a dominar o la decisión que necesita validación. Si la respuesta suena genérica, pide: “Redo the reflection using specific evidence from earlier turns and end with a concrete recommendation.”
Esto está alineado con la disciplina de salida honesta del repositorio: nada de pesimismo vago, nada de tranquilización vaga y nada de problemas inventados.
Vigila los modos de fallo comunes
Los fallos comunes de reflect incluyen centrarse solo en los últimos turnos, resumir en lugar de juzgar, encontrar problemas sin evidencia o terminar sin un siguiente paso claro. Otro fallo es hacer demasiadas preguntas: la skill solo debería pedir una aclaración cuando la conversación es demasiado escasa para reevaluarla.
Puedes corregirlo diciendo: “Reread from the original goal, not just the recent implementation details. Identify the strongest reason to continue and the strongest reason to pivot.”
Itera después de la primera recomendación
Trata la primera reflexión como un punto de control de decisión, no como el final del trabajo. Si la recomendación es “continue”, pregunta qué evidencia cambiaría esa postura. Si es “pivot”, pide el cambio de rumbo viable más pequeño. Si es “pause”, pregunta qué información faltante exacta debe resolverse antes de continuar.
Así reflect se mantiene práctico: el objetivo no es más análisis, sino una mejor siguiente acción.