
Session Analyzer
When you need to verify that a Claude Code skill actually did what it was supposed to, this parses session logs and compares them against the SKILL.md spec. It digs through your ~/.claude/ debug logs to extract SubAgent calls, hook triggers, and artifact changes, then builds a pass/fail report. Honestly most useful when you're debugging why a skill isn't behaving right or when you're building new skills and want to confirm the hooks and SubAgents fired in the right order. The scripts handle the grep patterns for you, which saves time since the log format isn't exactly intuitive. Think of it as a test suite for skills that already ran.
- skills.sh installs
- 1.3K
- GitHub stars
- 19
- last updated
- Aug 21, 2026
Install
$ npx -y skills add ai-native-camp/camp-2 --skill session-analyzer --agent claude-codeInstalls into .claude/skills of the current project.
Files
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/:
# 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:
${baseDir}/scripts/find-session-files.sh {sessionId}
Sponsors
Details
- Repository
- github.com/ai-native-camp/camp-2
- Category
- AI & Agent Building
- First seen
- Apr 16, 2026