ai-native-camp avatar

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-code

Installs 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:

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

Input Requirements

ParameterRequiredDescription
sessionIdYESUUID of the session to analyze
targetSkillYESPath to SKILL.md to validate against
additionalRequirementsNOExtra 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

More from ai-native-camp/camp-2

All 12
1orchestra-research avatarfaissorchestra-research/ai-research-skillsFacebook's library for efficient similarity search and clustering of dense vectors. Supports billions of vectors, GPU acceleration, and various index types (Fla1.1Kskills.sh installs
2azurecosmosdb avatarcosmosdb-best-practicesazurecosmosdb/cosmosdb-agent-kitAzure Cosmos DB performance optimization and best practices guidelines for NoSQL, partitioning, queries, and SDK usage. Use when writing, reviewing, or refactor1.1Kskills.sh installs
3github avatararize-tracegithub/awesome-copilotDownloads, exports, and inspects existing Arize traces and spans to understand what an LLM app is doing or debug runtime issues. Covers exporting traces by ID, 1.1Kskills.sh installs
4github avatarphoenix-evalsgithub/awesome-copilotBuild and run evaluators for AI/LLM applications using Phoenix.1Kskills.sh installs
5orchestra-research avatarwhisperorchestra-research/ai-research-skillsOpenAI's general-purpose speech recognition model. Supports 99 languages, transcription, translation to English, and language identification. Six model sizes fr1Kskills.sh installs
6github avatarphoenix-tracinggithub/awesome-copilotOpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to p1Kskills.sh installs