# Session Review

> Use after completing work sessions to analyze agent behavior patterns, prepare session handoffs for continuity, document completed work, identify blockers, or preserve context for the next session.

- Skill: `srstomp/session-review` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds add srstomp/session-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/srstomp/session-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: srstomp (https://skillmd.com/u/srstomp)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/srstomp/session-review

---


# Session Review & Handoff

Analyze agent sessions and prepare context handoffs for session continuity.

## Purpose

This skill serves two complementary workflows:

**Review** (`/pokayokay:review`) — Retrospective analysis:
- Understand what the agent actually did vs what was planned
- Identify good patterns to reinforce and bad patterns to prevent
- Find wasted effort and context efficiency issues
- Generate improvements for skills, prompts, and workflows

**Handoff** (`/pokayokay:handoff`) — Forward-looking context preservation:
- Document completed work and in-progress state
- Capture decisions, blockers, and next steps
- Track skill usage and ad-hoc work
- Prepare context for the next session or agent

## When NOT to Use

- **Auditing feature completeness** — Use `feature-audit` for PRD gap analysis; this skill analyzes agent behavior
- **Planning new work** — Use `planning` for PRD breakdown; this skill reviews completed sessions

## Key Principles

- Compare plan vs reality — what was expected vs what happened
- Assess work quality — were reviews passing? How many cycles?
- Detect patterns — recurring issues across multiple sessions
- Learn from checkpoints — were pauses at the right moments?

## Quick Start Checklist

1. Gather session data (git log, ohno activity, session notes)
2. Analyze execution against original task plan
3. Evaluate quality metrics (review pass rate, cycle count)
4. Identify patterns (positive and negative)
5. Generate actionable improvements

## References

| Reference | Description |
|-----------|-------------|
| [pattern-library.md](references/pattern-library.md) | Common session patterns and their fixes |
| [analysis-scripts.md](references/analysis-scripts.md) | Scripts for extracting session metrics |
| [review-report-template.md](references/review-report-template.md) | Template for session review reports |
| [handoff-guide.md](references/handoff-guide.md) | Handoff state documentation, templates, ohno integration |