What does the 'Verdict' in the report mean?

The Verdict provides a PASS or FAIL status based on whether the actual session logs align with the mandatory steps and hooks defined in your skill documentation.

Can this skill detect subagent failures?

Yes, it extracts SubagentStart and SubagentStop events from debug logs to confirm if agents like 'reviewer' or 'gap-analyzer' were called in the correct order.

Where are Claude Code session logs stored?

The skill automatically searches for logs in ~/.claude/projects/ and detailed execution traces in ~/.claude/debug/.

How do I start a session analysis?

To analyze a session, provide the specific session UUID and the file path to the target SKILL.md you wish to validate against.

Does it check if temporary files were deleted?

Yes, the tool verifies artifact lifecycle by searching for file creation events and confirming subsequent deletion commands or filesystem states.

Session Analyzer for Claude Code

Name: Session Analyzer for Claude Code
Author: team-attention

byteam-attention

•

313

Analíticas y Monitorización

Analyzes completed Claude Code sessions to verify tool execution, hook triggers, and artifact creation against specification files.

Acerca de

Session Analyzer is a specialized debugging and verification tool designed for developers building complex workflows in Claude Code. It automatically retrieves session logs and debug traces, compares actual execution history against the requirements defined in a SKILL.md file, and generates a comprehensive report. This is particularly useful for identifying why a subagent failed to trigger, verifying that security hooks were correctly applied, or ensuring that temporary artifacts were properly cleaned up after a task completion, ensuring high-reliability AI agent deployments.

Características Principales

313 GitHub stars
Comparison of actual behavior vs. SKILL.md specifications
Comprehensive pass/fail reporting with deviation summaries
Detailed tracking of subagent invocations and hook events
Automated session log and debug trace retrieval
Artifact verification for file creation and deletion

Casos de Uso

Debugging complex multi-agent workflows that failed unexpectedly
Verifying compliance with defined development patterns and artifact management
Validating that security hooks and tool matchers are triggering correctly

Acerca de

Características Principales

313 GitHub stars
Comparison of actual behavior vs. SKILL.md specifications
Comprehensive pass/fail reporting with deviation summaries
Detailed tracking of subagent invocations and hook events
Automated session log and debug trace retrieval
Artifact verification for file creation and deletion

Casos de Uso

Debugging complex multi-agent workflows that failed unexpectedly
Verifying compliance with defined development patterns and artifact management
Validating that security hooks and tool matchers are triggering correctly