session-analyzer

Analyze Claude Code session logs against SKILL.md to generate a verification report.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/seungwonme/.claude --skill session-analyzer-seungwonme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-analyzer
Source: https://github.com/seungwonme/.claude/tree/main/skills/session-wrap/session-analyzer
Command: npx skills add https://github.com/seungwonme/.claude --skill session-analyzer-seungwonme

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The Session Analyzer provides a structured method to verify that Claude Code sessions conform to a target SKILL.md, ensuring the observed flow, subagent usage, hooks, and artifacts align with the defined specifications.

Core Features & Use Cases

  • Validate completed sessions against SKILL.md frontmatter and workflow requirements, surface deviations, and provide an audit trail.
  • Verify SubAgent invocations, Hook outcomes, and artifact lifecycle (drafts/plans) to ensure correct behavior and outcome.
  • Generate a reproducible verification report for QA, compliance, or post-mortem analysis in training or production runs.

Quick Start

Analyze a completed Claude Code session against a target SKILL.md to validate adherence and identify deviations.

Frequently Asked Questions about session-analyzer

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

FAQPage Schema
How do I validate a completed Claude Code session against SKILL.md requirements?

Session validation compares session logs and artifact lifecycles against SKILL.md frontmatter to identify deviations and generate a structured audit trail. It checks subagent invocations, hook outcomes, and artifact drafts to ensure observed flow matches defined specifications.

What is post-hoc verification of Claude Code sessions and when do I need it?

Post-hoc verification of Claude Code sessions quantifies how closely a completed session conforms to a target SKILL.md, surfacing deviations across subagents, hooks, and artifacts. You need it for QA, compliance checks, or post-mortem analysis to ensure reproducible behavior.

Can I analyze hook outcomes and subagent invocations from session logs?

Yes, you can analyze hook outcomes and subagent invocations from session logs to verify correct behavior. The analyzer relies on session logs, SKILL.md frontmatter, and configured artifact paths to evaluate whether the observed flow aligns with the defined workflow.

How do I generate a reproducible audit trail for Claude Code session compliance?

Generate a reproducible audit trail by analyzing completed session logs against target SKILL.md frontmatter and configured artifact paths. The process surfaces deviations in subagent usage, hook outcomes, and artifact drafts, producing a structured verification report for compliance.

Does the session analyzer require external dependencies or API keys to run?

No, the session analyzer has no external dependencies or API keys. It operates using session logs, the target SKILL.md frontmatter, and configured artifact paths to produce its structured verification report.

What are the limitations of using session logs for Claude Code workflow verification?

Session log verification is limited to post-hoc analysis of completed runs, meaning it surfaces deviations after execution rather than preventing them in real-time. It relies entirely on the accuracy of configured artifact paths and SKILL.md frontmatter to validate subagent and hook behavior.