recap

Generates session orientation summaries from git state, focus files, handoffs, and retrospectives.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill recap-heman1033p-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recap
Source: https://github.com/heman1033p-create/cv-v2-kongphop/tree/main/.gemini/skills/recap
Command: npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill recap-heman1033p-create

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When starting a new session, returning after a context switch, or losing track mid-session, you waste time reconstructing what you were doing. This Skill restores situational awareness by reading your git state, focus file, handoffs, tracks, and retrospectives to answer "where are we" and "what's next". ## Core Features & Use Cases - Rich Recap Mode: Runs a Bun script that aggregates focus state, schedule, git status, tracks, last retrospective, and handoff content, then suggests next actions. - Quick Mode: A fast (~0.1s) minimal recap showing only git status and focus state with no file content reads. - Now Mode: Reconstructs a mid-session timeline from conversation memory, classifying topic jumps as sparks, completions, returns, parks, or escapes to surface avoidance patterns. - Use Case: After a weekend break, run /recap to instantly see your last session summary, uncommitted changes, pending handoff, and two or three concrete options for what to tackle next. ## Quick Start Ask the assistant to run /recap to get a full orientation of the current session including git state, focus, and suggested next steps.

Frequently Asked Questions about recap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a summary of my last work session?▼

Run /recap to execute the recap-rich script, which reads your latest retrospective, handoff file, tracks, and git state. The assistant then adds two or three suggested next actions based on that context.

How to check current session status without reading files?▼

Use /recap --now for mid-session awareness reconstructed from conversation memory, or /recap --quick for a fast git-plus-focus snapshot that takes about 0.1 seconds with no content reads.

What runtime does the recap script require?▼

The scripts require the Bun runtime and are executed with bun recap.ts or bun recap-rich.ts. They use Bun's built-in shell and file APIs, so no additional npm packages are needed.

Does recap work without a git repository?▼

The scripts fall back to the current working directory if git rev-parse fails, but most output sections such as branch, commits, and modified files depend on git. Focus and schedule files are read independently of git.

What are the limitations of the now mode timeline?▼

Now mode reconstructs the session timeline from AI conversation memory rather than persisted logs, so durations are approximate and earlier details may be lost in long sessions. Use --now deep to supplement with handoff and tracks files.