team-attention/plugins-for-claude-natives/session-analyzer

Name: session-analyzer
Author: team-attention

Claude Code and agent skill by team-attention/plugins-for-claude-natives

Trust tier 3

community

By team-attention
Coding
team-attention/plugins-for-claude-natives
Plugin session-wrap
plugins/session-wrap/skills/session-analyzer/SKILL.md
Updated 25 Mar 2026
Version 1.0.0

Source check pending

Checking that the SKILL.md file is still in the repository.

This skill should be used when the user asks to "analyze session", "세션 분석", "evaluate skill execution", "스킬 실행 검증", "check session logs", "로그 분석", provides a session ID with a skill path, or wants to verify that a skill executed correctly in a past session. Post-hoc analysis of Claude Code sessions to validate skill/agent/hook behavior against SKILL.md specifications.

Install

npx vskill@latest install team-attention/plugins-for-claude-natives/session-analyzer

SKILL.md

Session Analyzer Skill

Post-hoc analysis tool for validating Claude Code session behavior against SKILL.md specifications.

Purpose

Analyze completed sessions to verify:

Expected vs Actual Behavior - Did the skill follow SKILL.md workflow?
Component Invocations - Were SubAgents, Hooks, and Tools called correctly?
Artifacts - Were expected files created/deleted?
Bug Detection - Any unexpected errors or deviations?

Input Requirements

Parameter	Required	Description
`sessionId`	YES	UUID of the session to analyze
`targetSkill`	YES	Path to SKILL.md to validate against
`additionalRequirements`	NO	Extra validation criteria

Phase 1: Locate Session Files

Step 1.1: Find Session Files

Session files are located in ~/.claude/:

bash

# Main session log
~/.claude/projects/-{encoded-cwd}/{sessionId}.jsonl
 
# Debug log (detailed)
~/.claude/debug/{sessionId}.txt
 
# Agent transcripts (if subagents were used)
~/.claude/projects/-{encoded-cwd}/agent-{agentId}.jsonl

Use script to locate files:

bash

${baseDir}/scripts/find-session-files.sh {sessionId}

Step 1.2: Verify Files Exist

Check all required files exist before proceeding. If debug log is missing, analysis will be limited.

Phase 2: Parse Target SKILL.md

Step 2.1: Extract Expected Components

Read the target SKILL.md and identify:

From YAML Frontmatter:

hooks.PreToolUse - Expected PreToolUse hooks and matchers
hooks.PostToolUse - Expected PostToolUse hooks
hooks.Stop - Expected Stop hooks
hooks.SubagentStop - Expected SubagentStop hooks
allowed-tools - Tools the skill is allowed to use

From Markdown Body:

SubAgents mentioned (Task(subagent_type="..."))
Skills called (Skill("..."))
Artifacts created (.dev-flow/drafts/, .dev-flow/plans/, etc.)
Workflow steps and conditions

Step 2.2: Build Expected Behavior Checklist

Create checklist from SKILL.md analysis:

markdown

## Expected Behavior
 
### SubAgents
-[ ] Explore agent called (parallel, run_in_background)
-[ ] gap-analyzer called before plan generation
-[ ] reviewer called after plan creation
 
### Hooks
-[ ] PreToolUse[Edit|Write] triggers plan-guard.sh
-[ ] Stop hook validates reviewer approval
 
### Artifacts
-[ ] Draft file created at .dev-flow/drafts/{name}.md
-[ ] Plan file created at .dev-flow/plans/{name}.md
-[ ] Draft file deleted after OKAY
 
### Workflow
-[ ] Interview Mode before Plan Generation
-[ ] User explicit request triggers plan generation
-[ ] Reviewer REJECT causes revision loop

Phase 3: Analyze Debug Log

The debug log (~/.claude/debug/{sessionId}.txt) contains detailed execution traces.

Step 3.1: Extract SubAgent Calls

Search patterns:

SubagentStart with query: {agent-name}
SubagentStop with query: {agent-id}

Use script:

bash

${baseDir}/scripts/extract-subagent-calls.sh {debug-log-path}

Step 3.2: Extract Hook Events

Search patterns:

Getting matching hook commands for {HookEvent} with query: {tool-name}
Matched {N} unique hooks for query "{query}"
Hooks: Processing prompt hook with prompt: {prompt}
Hooks: Prompt hook condition was met/not met
permissionDecision: allow/deny

Use script:

bash

${baseDir}/scripts/extract-hook-events.sh {debug-log-path}

Step 3.3: Extract Tool Calls

Search patterns:

executePreToolHooks called for tool: {tool-name}
File {path} written atomically

Step 3.4: Extract Hook Results

For prompt-based hooks, find the model response:

Hooks: Model response: {
  "ok": true/false,
  "reason": "..."
}

Phase 4: Verify Artifacts

Step 4.1: Check File Creation

For each expected artifact:

Search debug log for FileHistory: Tracked file modification for {path}
Search for File {path} written atomically
Verify current filesystem state

Step 4.2: Check File Deletion

For files that should be deleted:

Search for rm commands in Bash calls
Verify file no longer exists on filesystem

Phase 5: Compare Expected vs Actual

Step 5.1: Build Comparison Table

markdown

| Component | Expected | Actual | Status |
|-----------|----------|--------|--------|
| Explore agent | 2 parallel calls | 2 calls at 09:39:26 | ✅ |
| gap-analyzer | Called before plan | Called at 09:43:08 | ✅ |
| reviewer | Called after plan | 2 calls (REJECT→OKAY) | ✅ |
| PreToolUse hook | Edit\|Write matcher | Triggered for Write | ✅ |
| Stop hook | Validates approval | Returned ok:true | ✅ |
| Draft file | Created then deleted | Created→Deleted | ✅ |
| Plan file | Created | Exists (10KB) | ✅ |

Step 5.2: Identify Deviations

Flag any mismatches:

Missing component calls
Wrong order of operations
Hook failures
Missing artifacts
Unexpected errors

Phase 6: Generate Report

Report Template

markdown

# Session Analysis Report
 
## Session Info
-**Session ID**: {sessionId}
-**Target Skill**: {skillPath}
-**Analysis Date**: {date}
 
---
 
## 1. Expected Behavior (from SKILL.md)
 
[Summary of expected workflow]
 
---
 
## 2. Skill/SubAgent/Hook Verification
 
### SubAgents
| SubAgent | Expected | Actual | Time | Result |
|----------|----------|--------|------|--------|
| ... | ... | ... | ... | ✅/❌ |
 
### Hooks
| Hook | Matcher | Triggered | Result |
|------|---------|-----------|--------|
| ... | ... | ... | ✅/❌ |
 
---
 
## 3. Artifacts Verification
 
| Artifact | Path | Expected State | Actual State |
|----------|------|----------------|--------------|
| ... | ... | ... | ✅/❌ |
 
---
 
## 4. Issues/Bugs
 
| Severity | Description | Location |
|----------|-------------|----------|
| ... | ... | ... |
 
---
 
## 5. Overall Result
 
**Verdict**: ✅ PASS / ❌ FAIL
 
**Summary**: [1-2 sentence summary]

Scripts Reference

Script	Purpose
`find-session-files.sh`	Locate all files for a session ID
`extract-subagent-calls.sh`	Parse subagent invocations from debug log
`extract-hook-events.sh`	Parse hook events from debug log

Usage Example

User: "Analyze session 3cc71c9f-d27a-4233-9dbc-c4f07ea6ec5b against .claude/skills/specify/SKILL.md"
 
1. Find session files
2. Parse SKILL.md → Expected: Explore, gap-analyzer, reviewer, hooks
3. Analyze debug log → Extract actual calls
4. Verify artifacts → Check .dev-flow/
5. Compare → Build verification table
6. Generate report → PASS/FAIL with details

Additional Resources

Reference Files

`references/analysis-patterns.md` - Detailed grep patterns for log analysis
`references/common-issues.md` - Known issues and troubleshooting

Scripts

`scripts/find-session-files.sh` - Session file locator
`scripts/extract-subagent-calls.sh` - SubAgent call extractor
`scripts/extract-hook-events.sh` - Hook event extractor

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingplugins/session-wrap/skills/session-analyzer/SKILL.md

Popularity

Repository stars: 690
Repository forks: 83
7-day trend score: 33

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 20 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/team-attention/plugins-for-claude-natives/session-analyzer/badge)](https://verified-skill.com/skills/team-attention/plugins-for-claude-natives/session-analyzer)

Something wrong with this skill or its page? Tell us.