Session Investigator
Investiga los archivos de sesión e historial de fast-agent para diagnosticar por qué falló una ejecución.
Probado · Funciona
Qué hace
Investiga los archivos de sesión e historial de fast-agent para diagnosticar problemas. Úsala cuando una sesión termina de forma inesperada, al depurar bucles de herramientas, al correlacionar trazas de subagentes con sesiones principales, o al analizar el flujo y los tiempos de una conversación. Cubre los metadatos de session.json, el formato JSON del historial, la estructura de mensajes, la correlación llamada/resultado de herramientas y los patrones de fallo habituales.
Informe de la prueba
Se probó la instalación literal (clone+copy limpio, SKILL.md autocontenido, frontmatter en YAML estricto) junto con un history_dev.json de fast-agent fabricado con una llamada a herramienta colgada a propósito. Tanto el brazo con skill como el base identificaron correctamente el patrón Unanswered Tool Call en el índice de mensaje 5 y el mismo punto de truncamiento 0-4; el brazo con skill se adelantó solo por nombrar el patrón de fallo canónico y señalar que su propia receta de truncamiento con jq ancla de forma demasiado conservadora, así que la ganancia del A/B fue marginal. Nota: los comandos de la skill asumen en silencio que jq está instalado (ausente en la máquina de prueba y nunca listado como prerrequisito).
Probado el: 2026-07-13 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/evalstate/fast-agent cd fast-agent mkdir -p ~/.claude/skills cp -r examples/hf-toad-cards/skills/session-investigator ~/.claude/skills/session-investigator
Comandos y prompts de ejemplo
/session-investigatorInvestiga los archivos de sesión e historial de fast-agent para diagnosticar por qué falló una ejecución.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Why did this fast-agent session end unexpectedlyCorrelate this sub-agent trace with the main sessionDebug this tool loop using the session history