What files does the Session Analyzer need to function?

It requires the .jsonl session log, the detailed .txt debug log, and the target SKILL.md specification file to perform a full comparison.

How do I find my Claude Code session IDs?

Session IDs are UUIDs found in the ~/.claude/projects/ directory or displayed in the terminal at the start of a session.

Can I use this to check if files were correctly deleted?

Yes, the skill verifies artifact states on the filesystem, checking both for the creation of required files and the successful removal of temporary drafts.

Does this skill support multi-agent workflows?

Yes, it is designed to track SubagentStart and SubagentStop events to verify complex interactions between multiple agents.

Session Analyzer

Name: Session Analyzer
Author: team-attention

byteam-attention

•

Analíticas y Monitorización

Validates Claude Code session behavior against SKILL.md specifications to ensure correct execution of agents, hooks, and tools.

The Session Analyzer skill provides a comprehensive post-hoc evaluation of Claude Code sessions by auditing debug logs and session files against defined requirements. It automatically extracts subagent calls, hook events, and tool invocations to verify that workflows followed the intended logic specified in SKILL.md. This is particularly useful for debugging complex multi-agent interactions, ensuring artifact integrity, and identifying deviations or bugs in automated development workflows by comparing expected versus actual execution traces.

Características Principales

01Artifact verification to confirm files were created or deleted as expected

02Automated discovery and parsing of session and debug logs from the Claude directory

03Extraction and validation of subagent calls, including parallel execution patterns

0464 GitHub stars

05Comprehensive reporting with pass/fail status for every workflow component

06Detailed tracking of hook events including PreToolUse and Stop conditions

Casos de Uso

01Debugging failed multi-agent workflows by identifying exactly where execution deviated from the plan

02Verifying that security hooks and plan-guards triggered correctly during automated coding tasks

03Auditing session history for compliance and artifact integrity in complex software migrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add team-attention/hoyeon skill-session-analyzer

For use in Claude.ai and ChatGPT

Download Skill