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.