session-analyzer
Installation
SKILL.md
Session Analyzer
Overview
Use this skill when the job is "figure out what happened in Codex sessions for repo X and synthesize the next move" rather than doing open-ended manual log spelunking.
The default path is: run the bundled Python sync+digest script once, read its compact digest, then only inspect raw transcripts or repo artifacts if the digest is complete and still leaves an ambiguity.
Default time selection is the previous calendar date in the user's locale timezone. If the user instead asks for a rolling recent window such as "last 6 hours" or "past 12 hours", pass --last-hours N and let the script own the window math.
The script now does more than enumerate sessions:
- inventories by target-day activity, not just thread creation day
- assigns repo-match confidence (
high,medium,low) - classifies each thread outcome heuristically (
implemented_and_merged,plan_only,blocked_waiting_for_input, etc.) - separates target-day historical evidence from current repo state
- emits ranked
candidate_next_actionsinstead of forcing the final synthesis to start from a blank slate - emits
theme_summariesthat collapse many sessions into one workstream-level truth, including current state, superseded earlier sessions, and landed-vs-local-only counts - adds local-time timestamp fields alongside UTC so handoff reconstruction is easier in the user's timezone
- reports current-branch divergence from
main/upstream when--include-gitis enabled