retro

Extract human-readable content from Claude Code session JSONL files into structured retrospective reports.

77|4|Updated Jun 20, 2022
One-click install
npx skills add https://github.com/htlin222/dotfiles --skill retro-htlin222
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/htlin222/dotfiles/tree/main/claude.symlink/skills/retro
Command: npx skills add https://github.com/htlin222/dotfiles --skill retro-htlin222

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you understand and improve your AI coding sessions by providing a structured retrospective, identifying areas for efficiency, and suggesting learning opportunities.

Core Features & Use Cases

  • Session Summarization: Extracts only human-readable content (prompts and responses) from your conversation history.
  • Efficiency Analysis: Pinpoints where your prompts or workflow could have been more effective.
  • Learning & Improvement: Suggests topics for deeper study and improvements to your project's documentation (CLAUDE.md).
  • Use Case: At the end of a complex debugging session, use this Skill to get a clear summary of what was achieved, what went wrong, and how to avoid similar issues in the future.

Quick Start

Run the retro skill to generate a summary of the current Claude Code session.

Frequently Asked Questions about retro

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

FAQPage Schema
How do I generate a retrospective report from a Claude Code session JSONL file?

To generate a retrospective report from a Claude Code session, run the skill to extract human-readable content from the JSONL file. It analyzes accomplishments, efficiency, and learning recommendations, outputting structured reports in markdown, JSON, or plain text formats.

What is session review in AI coding and when do I need it?

Session review in AI coding is the process of analyzing conversation history to identify workflow improvements. You need it after complex debugging sessions to understand what was achieved, pinpoint prompt inefficiencies, and get suggestions for future learning and documentation updates.

Can I export my Claude Code session review as JSON with timestamps and statistics?

Yes, you can export your Claude Code session review as JSON with optional timestamps and statistics. The skill extracts human-readable content and supports multiple output formats, including JSON, to provide a structured retrospective of your prompts and responses.

How does analyzing Claude Code conversation history improve my coding efficiency?

Analyzing Claude Code conversation history improves coding efficiency by pinpointing where your prompts or workflow could have been more effective. The retrospective report highlights areas for improvement and suggests specific topics for deeper study to avoid similar issues.

Does the session retrospective skill suggest improvements for project documentation?

Yes, the session retrospective skill suggests improvements for project documentation. It analyzes your conversation history to generate recommendations and specific suggestions for updating your project's CLAUDE.md file to enhance future AI coding sessions.

What is the best way to summarize a complex debugging session with an AI assistant?

The best way to summarize a complex debugging session is to use a retrospective tool that extracts human-readable content from your conversation history. This generates a structured report of what went wrong, what was achieved, and how to avoid similar issues.