Analyze a session

Work the steps in order. This skill ends once the retrospective exists on disk and the operator has its path. Acting on what it recommends is separate work. Use the codex-commit skill for any change that comes out of it.

Which session

Use the absolute transcript path from the user's request. A bare session ID also works when it names exactly one file under ~/.codex/sessions/.

If the user gives neither, preflight explains how to find a session. Spawn a fresh delegated agent with fork_turns: "none". Run preflight again with the path it returns. Never load session files into model context merely to locate one because the locator can stream them.

Preflight

Run bash .agents/skills/codex-analyze-session/scripts/preflight.sh <path-or-id> and read its report.

Step 0: open the task list

Create these tasks with update_plan, then move each to in_progress and completed as you go. They're the checklist the rest of this document expands.