When is the best time to run a session review?

You should run the session-review skill after completing a project epic, hitting a series of technical issues, or finishing a full development cycle to extract learnings.

Does it provide specific recommendations for other skills?

Absolutely. The output includes specific updates you can make to your other Claude Code skills, such as adding checklists or known-issue files to prevent repeated mistakes.

How does this skill help improve AI task estimation?

It compares the original time estimates in your tasks.db against the actual time logged, providing variance data and suggested multipliers for specific task types.

Can this skill identify why an agent is over-engineering a feature?

Yes, by analyzing session logs and git diffs against the original features.json, it can detect scope creep and suggest tighter checkpoint settings.

What data sources does the skill use for its analysis?

It analyzes the .claude/ directory (logs, progress.md, tasks.db) and your Git history (commit messages, diffs, and reverts) to get a full picture of the work.

Session Review

Name: Session Review
Author: srstomp

bysrstomp

•

Productividad y Flujo de Trabajo

Analyzes completed development sessions to identify performance patterns, estimate accuracy, and actionable improvements for AI agents.

The Session Review skill acts as a dedicated retrospective tool for Claude Code, meticulously examining session logs, git history, and task databases to evaluate agent performance. By comparing initial plans against actual execution, it uncovers behavioral patterns—such as recurring bugs or over-engineering tendencies—and provides structured reports with recommendations for skill updates and checkpoint adjustments. It is an essential tool for developers looking to move from supervised to autonomous AI workflows by learning from past sessions to optimize future performance.

Características Principales

01Automated analysis of session logs, progress reports, and git history

02Pattern detection for identifying recurring agent habits and errors

03Generation of project artifacts like known-issues.md and estimate-adjustments.md

04Actionable recommendation engine for prompt and skill improvements

052 GitHub stars

06Quantitative comparison of planned vs. actual task completion and timing

Casos de Uso

01Conducting a retrospective after completing a major project epic to improve future velocity

02Calibrating task multipliers based on historical data for more accurate project planning

03Troubleshooting agent 'thrashing' or repeated reverts in complex codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add srstomp/pokayokay session-review

For use in Claude.ai and ChatGPT

Download Skill