MCP HubMCP Hub
← Back to Skills

compress-session

majiayu000
Updated Yesterday
58
9
58
View on GitHub
Designdesign

About

The compress-session skill condenses conversation history into structured summaries that capture decisions, tools built, and breakthroughs—context that git commits miss. It activates when users explicitly request compression, after significant milestones, or periodically in long sessions. The skill automatically organizes summaries with sequence numbers and focuses on preserving the "why" and "how" of development work.

Quick Install

Claude Code

Recommended
Plugin CommandRecommended
/plugin add https://github.com/majiayu000/claude-skill-registry
Git CloneAlternative
git clone https://github.com/majiayu000/claude-skill-registry.git ~/.claude/skills/compress-session

Copy and paste this command in Claude Code to install this skill

Documentation

Compress Session

Compress active session into structured summary. Capture decisions, tools built, breakthroughs - the "why" and "how" that git commits don't preserve.

When to Activate

  • User says: "compress", "compress session"
  • After significant milestones
  • Every ~10 messages in long sessions
  • Before ending major work

Process

1. Determine Sequence Number

ls -t inbox/session-summaries/$(date +%Y-%m-%d)*.md 2>/dev/null | head -1
  • If files exist: increment (seq2, seq3...)
  • If none: this is seq1

2. Review Conversation

Identify signal vs. noise:

  • INCLUDE: Decisions, tools built, breakthroughs, key quotes, context
  • SKIP: Pleasantries, process discussion without outcome, redundant info

3. Write Summary

Create: inbox/session-summaries/YYYY-MM-DD-HHMM-seqN.md

# Session Capture: YYYY-MM-DD [Sequence N]

**Time:** [Start] - [Current]
**Roles Active:** [List or "general"]
**Messages:** [Approximate range]
**Branch:** [git branch]

---

## Context

[1-3 sentence narrative of what happened this sequence]

---

## Decisions Made

- [Decision 1]
  - Reason: [Why]
- [Decision 2]

---

## Tools/Workflows Built

- **[Name]:** [Description and purpose]

[Or: None this sequence]

---

## Breakthroughs/Insights

- [Insight] - [Significance]

---

## Key Quotes

- "[Quote]" ([Context])

---

## Files Created/Modified

[From git status]
- New: [files]
- Modified: [files]

---

## Next Steps

- [What's coming]

---

**Session compressed. Sequence [N] captured.**

4. Confirm

Session compressed. Sequence [N] captured.
Stored: inbox/session-summaries/YYYY-MM-DD-HHMM-seqN.md

What to Include

  • Decisions affecting work/strategy/direction
  • Tools/workflows built or planned
  • Breakthroughs (creative, technical, conceptual)
  • Context explaining why decisions were made
  • Key quotes revealing intent

What to Skip

  • Conversational filler
  • Detailed implementation (git shows that)
  • Process discussion without decision
  • Speculation that didn't become action

Tone

  • Concise, structured
  • Bullet points over paragraphs
  • Searchable and scannable
  • Neutral observation

GitHub Repository

majiayu000/claude-skill-registry
Path: skills/compress-session

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

creating-opencode-plugins

Meta

This skill provides the structure and API specifications for creating OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It offers implementation patterns for JavaScript/TypeScript modules that intercept and extend the AI assistant's lifecycle. Use it when you need to build event-driven plugins for monitoring, custom handling, or extending OpenCode's capabilities.

View skill

langchain

Meta

LangChain is a framework for building LLM applications using agents, chains, and RAG pipelines. It supports multiple LLM providers, offers 500+ integrations, and includes features like tool calling and memory management. Use it for rapid prototyping and deploying production systems like chatbots, autonomous agents, and question-answering services.

View skill

Algorithmic Art Generation

Meta

This skill helps developers create algorithmic art using p5.js, focusing on generative art, computational aesthetics, and interactive visualizations. It automatically activates for topics like "generative art" or "p5.js visualization" and guides you through creating unique algorithms with features like seeded randomness, flow fields, and particle systems. Use it when you need to build reproducible, code-driven artistic patterns.

View skill