ze-recap

Generate a structured recap of the current Ze session state.

50|2|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/ze-software/ze --skill ze-recap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ze-recap
Source: https://github.com/ze-software/ze/tree/main/.codex/skills/ze-recap
Command: npx skills add https://github.com/ze-software/ze --skill ze-recap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a compact, structured recap of the current Ze development session by aggregating the selected spec metadata, git state, recent session state, and deferrals, and presenting what is done, in progress, remaining, and skipped.

Core Features & Use Cases

  • Read the active spec metadata to anchor the recap to the current task
  • Read per-spec session state to reflect recent activity and decisions
  • Summarize the repository state (branch, changes) to provide context
  • Check deferrals and highlight items that are deferred or skipped
  • Output a structured five- to six-part recap with goal, done, in progress, remaining, deferred, and skipped

Quick Start

Summarize the current Ze session state and deferrals into a concise six-part recap.

Frequently Asked Questions about ze-recap

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

FAQPage Schema
How do I generate a progress summary for my current development session?

To generate a progress summary, the skill reads active spec metadata and git state to output a structured recap. It consolidates session state into sections for goal, done, in progress, remaining, deferred, and skipped items.

What is the best way to track deferred tasks and skipped items in a git repository?

Tracking deferred tasks and skipped items requires reading per-spec session state and spec metadata. The skill checks deferrals and highlights outstanding items alongside the current git branch and recent changes.

How does session state tracking work with spec metadata?

Session state tracking works by reading the active spec metadata to anchor the current task, then capturing recent activity and decisions. It reflects ongoing development by aggregating repository state and per-spec session data.

Can I consolidate git branch status and spec progress into a single recap?

Yes, you can consolidate git branch status and spec progress into a single recap. The skill captures the repository state, reads selected spec metadata, and outputs a compact summary of what is done and what remains.

Does the ze-recap skill require external dependencies to summarize session state?

No, the ze-recap skill requires no external dependencies to summarize session state. It operates independently to read spec metadata, capture git state, and generate a structured progress summary.

When do I need a structured six-part recap for my development workflow?

A structured six-part recap is needed when you want to review ongoing development tasks within a repository. It provides a compact overview of your goal, completed work, in-progress items, remaining steps, deferrals, and skipped elements.