handoff-log-condense

cdrguru's avatarfrom cdrguru

Create a short summary of recent handoff log entries without modifying the append-only log.

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads

When & Why to Use This Skill

The handoff-log-condense skill is a specialized utility designed to optimize AI agent performance by summarizing extensive handoff logs into concise, manageable files. By creating a high-level overview of recent activities while strictly preserving the original append-only logs, this skill ensures seamless context transitions between sessions, reduces token consumption, and maintains a clear, non-destructive audit trail for complex agentic workflows.

Use Cases

  • Session Handoffs: Use this skill when transitioning between AI agent sessions to provide the next agent with a condensed context of previous actions without overwhelming the context window.
  • Project Progress Reviews: Generate quick summaries of recent agent activities for human supervisors to review milestones and decisions without reading through raw log data.
  • Context Window Optimization: Periodically condense long-running conversation logs into summary files to keep the agent's active memory focused on the most relevant recent information.
  • Audit Trail Documentation: Create a structured summary of agent handoffs for documentation purposes while keeping the original logs intact for compliance or debugging.
namehandoff-log-condense
descriptionCreate a short summary of recent handoff log entries without modifying the append-only log.
short-descriptionSummarize recent handoff entries into a new file

Handoff Log Condense

When to use

Use when the handoff log is long and you need a short summary for a new session or review.

Procedure

  1. Choose the scope (for example, the last N entries) and write it down.
  2. Copy the scoped entries into a new file under .agent/docs/agent_handoffs/ (for example, agent_conversation_log.summary.md).
  3. Add a brief summary at the top of the new file, then leave the original log unchanged.

Inputs and outputs

  • Inputs: .agent/docs/agent_handoffs/agent_conversation_log.md, chosen scope
  • Outputs: new summary file under .agent/docs/agent_handoffs/

Constraints

  • Never modify or truncate the append-only log
  • Keep summaries in a separate file
  • ASCII-only

Examples

  • $handoff-log-condense