How do I install the Session Recap skill?

Run npx skillmds@latest add claude-hangar/session-recap in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Session Recap safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Session Recap?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Session Recap free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Session Recap?

claude-hangar (@claude-hangar) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Session Recap by claude-hangar — Agent Skill

Name: Session Recap
Author: claude-hangar

Session Recap

Summarize the pre-compact snapshot produced by the PreCompact hook into a human-readable recap. Equivalent to Claude Code's `/recap` but driven by Hangar snapshots so it works across sessions even without telemetry. Use when: "recap", "where did we stop", "what was going on", "session summary", "catch me up", "session-recap".

claude-hangar c2ce06f 2 files · 2.2 KB Updated Sep 17, 2026

File contents

/session-recap

Converts the Hangar pre-compact snapshot into a short human-readable summary. Complements Claude Code's native /recap (v2.1.108+) by surviving compaction, session-end, and handoff boundaries.

Data sources (in order)

${TEMP}/claude-pre-compact-snapshot-<session>.json — pre-compact hook output
.tasks.json — active task list at time of compaction
STATUS.md — project-level status file
HANDOFF.md — explicit handoff note if the user wrote one
git status --porcelain + git log --oneline -5 — recent repo activity

If no snapshot exists, fall back to sources 2–5 and mark the recap as "live" rather than "restored".

Output modes

`brief` (default)

Session recap — <timestamp>
Branch: <branch>    Uncommitted: <N files>
Last commit: <sha> <subject>
Active tasks (<N>):
  - <task 1 subject>
  - <task 2 subject>
Next: <recommended next action from STATUS.md or last in-progress task>

`full`

Brief output + last 5 commits, uncommitted file preview, HANDOFF.md inline, STATUS.md inline.

`tasks-only`

Just the active task list with status indicators. Use when pivoting between features.

Behavior

Never mutates files — read-only recap
Never invokes other agents — pure data aggregation
Exits cleanly when no snapshot exists (fallback to live state)
Recap is plain markdown, safe to quote back to the user

Frequently asked questions