compress-session

Compress session conversations into structured Markdown summaries for system memory.

1|1|Updated Nov 19, 2025

Search Tags:#inbox #breakthroughs #notes #session #summary #compress

Ready to run

npx skills add https://github.com/joshuacook/motoko --skill compress-session

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: compress-session
Source: https://github.com/joshuacook/motoko/tree/main/.claude/skills/compress-session
Command: npx skills add https://github.com/joshuacook/motoko --skill compress-session

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill compresses active sessions into a structured summary, capturing decisions, tools built, breakthroughs, and context that git commits may not preserve.

Core Features & Use Cases

Structured summaries: Capture Decisions Made, Tools/Workflows, Breakthroughs, and Key Quotes.
Context preservation: Document the rationale and context behind actions.
Next steps: Outline follow-up tasks for clarity.

Quick Start

After a meaningful milestone, run compress-session to store a compact, searchable summary in inbox/session-summaries/.

Frequently Asked Questions about compress-session

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

FAQPage Schema

How do I capture session decisions and context that git commits don't preserve?▼

Compress-session summarizes active sessions into structured markdown files that capture decisions made, tools built, breakthroughs, and key context. Run the Skill after meaningful milestones to store a compact, searchable summary in your inbox for future reference.

When should I compress a session into a summary?▼

Compress your session after completing significant work, reaching a breakthrough, or finishing a milestone-driven phase. The Skill activates on user commands like 'compress' or 'compress session', or automatically captures the rationale and context that version control can't preserve.

What information does a compressed session summary include?▼

A compressed session summary documents decisions made, tools or workflows built, breakthroughs achieved, key quotes, and next steps. The output is a structured markdown file named with a date and sequence, stored in inbox/session-summaries/ for searchability.

Can I compress ongoing dialogues and multi-session work?▼

Yes. Compress-session handles both ongoing dialogues and milestone-driven sessions. It's applicable whenever you need to preserve session context—activate it by command after meaningful work to capture decision rationale and progress that commits alone cannot document.

What tools do I need to run compress-session?▼

Compress-session requires Read, Write, and Bash tools to access conversation data and write the standardized markdown summary file. These tools enable the Skill to extract session content and output a structured record to your inbox.