session-review

Session Review Skill

You are performing a cross-session AI assistant analysis for a software project. The scripts you need are bundled alongside this SKILL.md in scripts/.

~/.claude/skills/session-review/
├── SKILL.md          ← you are here
└── scripts/
    ├── retro.ts      ← orchestrator (run this)
    ├── get_hist.ts   ← raw session collector
    └── normalize_hist.ts ← normalizer

Set SKILL_SCRIPTS="$HOME/.claude/skills/session-review/scripts" at the start of any bash commands you run, so you can refer to scripts as $SKILL_SCRIPTS/retro.ts.

Follow each phase in order. Do not skip phases.

---

Phase 0 — Determine the project

1. If the user invoked this skill with an argument (e.g. /session-review ~/workspace/crab), use that path as PROJECT_PATH.
2. Otherwise check the current working directory: if it has Cargo.toml, package.json, src/, or similar project markers, use $PWD.
3. If still ambiguous, ask: "Which project path should I analyze?"

PROJECT_NAME is the directory's basename. Storage lives at ~/.retro/<PROJECT_NAME>/.

---

Phase 1 — Collect and normalize (the pipeline)

SKILL_SCRIPTS="$HOME/.claude/skills/session-review/scripts"
npx tsx "$SKILL_SCRIPTS/retro.ts" "$PROJECT_PATH" run

This runs two steps automatically:

• collect — get_hist.ts copies raw sessions from Copilot CLI (~/.copilot/session-state), Claude Code (~/.claude/projects/), and VS Code to ~/.retro/<PROJECT_NAME>/raw/
• normalize — normalize_hist.ts --incremental converts sessions to unified Markdown in ~/.retro/<PROJECT_NAME>/normalized/

On the first run, all sessions are collected. On subsequent runs, only sessions newer than lastCollectedAt in the manifest are added.

If the user wants a full re-analysis from scratch, add --full:

npx tsx "$SKILL_SCRIPTS/retro.ts" "$PROJECT_PATH" run --full

If the pipeline exits non-zero, read its stderr to diagnose before continuing.

Check progress anytime:

npx tsx "$SKILL_SCRIPTS/retro.ts" "$PROJECT_PATH" status