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.
Resources
1Install
npx skillscat add srstomp/pokayokay/session-review Install via the SkillsCat registry.
SKILL.md
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
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
- Gather session data (git log, ohno activity, session notes)
- Analyze execution against original task plan
- Evaluate quality metrics (review pass rate, cycle count)
- Identify patterns (positive and negative)
- Generate actionable improvements
References
| Reference | Description |
|---|---|
| pattern-library.md | Common session patterns and their fixes |
| analysis-scripts.md | Scripts for extracting session metrics |
| review-report-template.md | Template for session review reports |
| handoff-guide.md | Handoff state documentation, templates, ohno integration |