handoff-log-condense
Create a short summary of recent handoff log entries without modifying the append-only log.
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.
| name | handoff-log-condense |
|---|---|
| description | Create a short summary of recent handoff log entries without modifying the append-only log. |
| short-description | Summarize 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
- Choose the scope (for example, the last N entries) and write it down.
- Copy the scoped entries into a new file under
.agent/docs/agent_handoffs/(for example,agent_conversation_log.summary.md). - 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