session-analyzer — Claude Code skill: session analysis
Checks a completed Claude Code session against a target SKILL.md, including agent and hook activity, file changes, and errors. Use it to spot gaps between the expected and observed workflow.
npx skills add ai-native-camp/camp-2 --skill session-analyzer -a claude-codeWhat session-analyzer does
Give the skill a session ID and the path to the SKILL.md you want to check. It compares the documented workflow with session evidence, including subagent, hook, and tool activity, operation order, file creation or deletion, and errors. The resulting report includes findings and a PASS or FAIL verdict.
The skill looks for session records under ~/.claude/. Its scripts, find-session-files.sh, extract-subagent-calls.sh, and extract-hook-events.sh, help locate records and pull out events. You can also provide extra checks. A missing debug log limits the analysis, and the logs it examines belong to Claude Code sessions.
What it helps with
- compare a completed run with a target
SKILL.md - check whether expected agents and hooks ran
- spot missing calls or steps in the wrong order
- verify expected files were created or removed
- produce a report with a PASS or FAIL verdict
Example prompts for the agent
- Check session
3cc71c9f-d27a-4233-9dbc-c4f07ea6ec5bagainst.claude/skills/specify/SKILL.md. - Compare the hook and subagent activity in this session with
.claude/skills/review/SKILL.md. - Check whether the expected file was created, and add this criterion: the reviewer must run before the plan is saved.
How to install session-analyzer
1Skills CLI (Vercel)
npx skills add ai-native-camp/camp-2 --skill session-analyzer -a claude-code2Manually: put the files in place
~/.claude/skills/session-analyzer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/session-analyzer/
1Skills CLI (Vercel)
npx skills add ai-native-camp/camp-2 --skill session-analyzer -a codex2Manually: put the files in place
.agents/skills/session-analyzer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-native-camp/camp-2 --skill session-analyzer -a cursor2Manually: put the files in place
.cursor/skills/session-analyzer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-native-camp/camp-2 session-analyzer2Manually: put the files in place
.github/skills/session-analyzer/SKILL.md1Skills CLI (Vercel)
npx skills add ai-native-camp/camp-2 --skill session-analyzer -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-native-camp/camp-2 --path .claude/skills/session-analyzerManually: put the files in place
.devin/skills/session-analyzer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-native-camp/camp-2 --skill session-analyzer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about session-analyzer
How do I install session-analyzer in Claude Code?
Run npx skills add ai-native-camp/camp-2 --skill session-analyzer -a claude-code. The skill file is at ~/.claude/skills/session-analyzer/SKILL.md.
What does session-analyzer do?
It checks a finished session against a chosen SKILL.md, examining hook events, subagent and tool calls, and expected file changes. It then reports discrepancies and gives a PASS or FAIL verdict.
What information does session-analyzer need?
Provide the session ID and the path to the SKILL.md used as the expected behavior. You can also add extra validation criteria.
