session-analyzer

Analyze Claude Code session logs to verify skill execution against SKILL.md.

1|Updated Mar 30, 2026

Search Tags:#logs #verification #analysis #subagent #session #hook

Ready to run

npx skills add https://github.com/Driving-Teacher/driving-teacher-ai-native --skill session-analyzer-driving-teacher

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-analyzer
Source: https://github.com/Driving-Teacher/driving-teacher-ai-native/tree/main/.claude/skills/session-analyzer
Command: npx skills add https://github.com/Driving-Teacher/driving-teacher-ai-native --skill session-analyzer-driving-teacher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides post-hoc analysis of Claude Code sessions to verify that skill execution followed the defined SKILL.md, ensure correct subagent/hook usage, artifact creation/deletion, and generate an auditable report.

Core Features & Use Cases

Validate session flows by mapping SubAgents, Hooks, and Tool calls against SKILL.md specifications.
Extract and verify artifacts such as drafts and plans, and identify deviations or errors.
Produce a structured Session Analysis Report with a machine-readable summary and human-friendly narrative.

Quick Start

Provide the sessionId and target SKILL.md path to run the analysis and generate a structured report.

Frequently Asked Questions about session-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I verify Claude Code session compliance against a SKILL.md file?▼

Analyze completed Claude Code sessions to verify skill execution against SKILL.md by parsing frontmatter, extracting subagent calls and hook events, and checking artifact creation to produce an auditable report.

What is the best way to validate subagent and hook usage in session logs?▼

Validate subagent and hook usage by extracting session logs to map tool calls against SKILL.md specifications, identifying discrepancies or errors in the execution flow, and generating a structured analysis report.

How do I generate an audit report for Claude Code artifacts and session deviations?▼

Generate an audit report by verifying draft and plan artifacts against SKILL.md definitions, detecting execution deviations across multiple steps, and outputting a standardized YAML or JSON-like summary with a human-friendly narrative.

Can I check if a Claude Code session followed the correct multi-step workflow?▼

Check multi-step workflow compliance by mapping subagent calls, hook events, and tool invocations against the defined SKILL.md process to identify any potential deviations and produce evidence-based validation.

What do I need to provide to run a session analysis and extract execution evidence?▼

Provide the sessionId and the target SKILL.md path to run the analysis, which extracts execution evidence from session logs and generates a structured compliance report.

Does session log analysis work for tracking artifact creation and deletion?▼

Session log analysis tracks artifact creation and deletion by verifying drafts and plans against SKILL.md specifications, extracting evidence from the session to identify any discrepancies in artifact handling.