session-analyzer

Parse Claude Code session logs to extract decisions, blockers, and learnings.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/arbgjr/smart_alarm --skill session-analyzer-arbgjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-analyzer
Source: https://github.com/arbgjr/smart_alarm/tree/main/.claude/skills/session-analyzer
Command: npx skills add https://github.com/arbgjr/smart_alarm --skill session-analyzer-arbgjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, gh, jq, curl, and includes scripts (resource) components.

What problem does it solve?

Claude Code generates a wealth of session data, but insights are scattered across logs. This Skill automatically parses Claude Code session files to extract decisions, blockers, learnings, and generate handoff-ready context, enabling faster retrospectives and better knowledge persistence.

Core Features & Use Cases

  • Extracts decisions, blockers and learnings from Claude Code sessions.
  • Persists learnings to the RAG corpus and generates structured session handoffs for continuity.
  • Integrates with gate-check, orchestrator, and memory-manager workflows to keep project context in sync.

Quick Start

Run the session analyzer wrapper to process the latest session and persist results: .claude/skills/session-analyzer/scripts/analyze.sh --persist --project /path/to/project

Frequently Asked Questions about session-analyzer

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

FAQPage Schema
How do I extract learnings from Claude Code sessions?

You can extract learnings from Claude Code sessions by running a wrapper script that parses session logs in ~/.claude/projects to identify decisions, blockers, and insights, persisting results to a RAG corpus.

What is a Claude Code session handoff and how does it work?

A Claude Code session handoff is structured context generated by parsing session logs to capture decisions and blockers, ensuring project continuity and feeding memory-manager workflows.

Do I need Python and PyYAML to analyze Claude session logs?

Yes, you need Python 3 and PyYAML to analyze Claude session logs, along with gh, jq, and curl. These dependencies are required to run the parsing scripts and persist extracted learnings.

How do I persist Claude Code learnings to a RAG corpus?

You persist Claude Code learnings to a RAG corpus by executing the analyzer wrapper with the --persist flag, which processes session logs and saves structured results for reuse.

Can I use the session analyzer with gate-check and orchestrator workflows?

Yes, the session analyzer integrates directly with gate-check, orchestrator phase transitions, and memory-manager workflows, feeding extracted learnings to keep project context synchronized.

What's the best way to generate structured context from Claude session files?

The best way to generate structured context from Claude session files is using a dedicated parsing script that identifies decisions and learnings, creating handoff-ready context and feeding a reusable RAG corpus.