skill-session-analyzer

Analyze Claude Code sessions against SKILL.md specifications and generate structured reports.

171|23|Updated Jan 21, 2026

Search Tags:#qa #subagent #SKILL.md #analyze #session-logs #hook-verification #debug-log

Ready to run

npx skills add https://github.com/team-attention/hoyeon --skill skill-session-analyzer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-session-analyzer
Source: https://github.com/team-attention/hoyeon/tree/main/skills/skill-session-analyzer
Command: npx skills add https://github.com/team-attention/hoyeon --skill skill-session-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill analyzes Claude Code sessions to verify execution against SKILL.md specifications.

Core Features & Use Cases

Validate post-hoc session results, including SubAgent, Hook, and Tool interactions.
Verify artifacts and workflow outputs against SKILL.md guidance.
Use Case: Audit a finished session to confirm compliance and generate a findings report.

Quick Start

Use the session-analyzer tool with a sessionId and a target SKILL.md path to produce a structured report. Example: analyze-session --session-id <ID> --target-skill path/to/SKILL.md

Frequently Asked Questions about skill-session-analyzer

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

FAQPage Schema

How do I validate Claude Code sessions against SKILL.md specifications?▼

You validate Claude Code sessions by running the session-analyzer tool with a session ID and target SKILL.md path. It parses frontmatter like hooks and allowed-tools to produce a structured report of findings, deviations, and recommendations for completed sessions.

What is post-hoc session log analysis for subagent interactions?▼

Post-hoc session log analysis is the process of auditing completed Claude Code sessions to verify subagent interactions, hook results, and artifacts. It checks executed workflows against the guidance defined in a SKILL.md file to confirm compliance.

Can I verify hook execution and tool outputs from a finished Claude Code session?▼

Yes, you can verify hook execution and tool outputs by analyzing the session logs. The analyzer parses the SKILL.md frontmatter to check allowed-tools and hook configurations, validating that the finished session actions match the specified constraints.

How do I audit a completed Claude Code workflow for compliance?▼

You audit a completed workflow by passing the session ID and SKILL.md path to the analyzer. It reviews the session logs, validates artifacts and workflow outputs against the SKILL.md guidance, and generates a structured findings report detailing any deviations.

Does the session analyzer require dependencies to parse SKILL.md frontmatter?▼

No external dependencies are required to parse SKILL.md frontmatter. The skill operates independently using its internal scripts and references to extract hooks and allowed-tools metadata for session validation.