session-retrospective

Generates retrospective summaries from uploaded session logs and user metadata.

3|Updated Aug 28, 2025
One-click install
npx skills add https://github.com/mrgeoffrich/mini-infra --skill session-retrospective-mrgeoffrich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-retrospective
Source: https://github.com/mrgeoffrich/mini-infra/tree/main/.claude/skills/session-retrospective
Command: npx skills add https://github.com/mrgeoffrich/mini-infra --skill session-retrospective-mrgeoffrich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of systematically reviewing and reflecting on Claude Code sessions to identify insights, errors, and lessons learned, facilitating continuous improvement.

Core Features & Use Cases

  • Session Analysis: Processes JSONL session logs to extract user chats, assistant responses, and tool results.
  • Retrospective Generation: Creates detailed markdown summaries capturing key challenges, mistakes, and techniques from the session.
  • Use Case: When a developer wants to review their interaction with Claude to improve prompt engineering or debugging strategies, this Skill automates the retro process and archives it as an issue in mk.

Quick Start

Invoke the skill with your session ID and target issue key, then review the generated retrospective in the linked issue.

Frequently Asked Questions about session-retrospective

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

FAQPage Schema
How do I analyze Claude session logs to identify errors and lessons learned?

You can analyze Claude session logs by parsing JSONL files to extract user and assistant exchanges, errors, and corrections, which are then compiled into structured retrospective summaries documenting key challenges and techniques.

What is the best way to automate retrospective reviews of AI assistant interactions?

Automating retrospective reviews of AI assistant interactions is done by processing session JSON logs to produce detailed markdown summaries capturing challenges, mistakes, and techniques, which are then archived as tracked issues for progress monitoring.

How do I generate a retrospective summary from a specific Claude session ID?

You generate a retrospective summary by invoking the skill with your session ID and target issue key, prompting it to parse the JSONL session log and post the resulting reflective summary directly to the linked issue.

Can I use session review to improve my prompt engineering and debugging strategies?

Yes, you can use session review to improve prompt engineering and debugging strategies because the retrospective summaries highlight specific mistakes and techniques from your Claude interactions, facilitating continuous improvement of your AI sessions.

Does the retrospective analysis require any specific dependencies or external libraries?

No external dependencies are required for retrospective analysis; the Skill operates independently using its bundled scripts and references to parse JSONL session logs and generate structured markdown retrospectives without external libraries.

What limitations should I expect when parsing JSONL session data for reflective summaries?

When parsing JSONL session data, limitations include reliance on valid session JSON logs for extraction accuracy, and the requirement to provide a target issue key for archiving, meaning incomplete logs may result in fragmented retrospective summaries.