context-compactor

Save conversational decisions, steps, and context into organized markdown files.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/jrodrigopuca/skills --skill context-compactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-compactor
Source: https://github.com/jrodrigopuca/skills/tree/main/context-compactor
Command: npx skills add https://github.com/jrodrigopuca/skills --skill context-compactor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill prevents the AI's context window from becoming saturated by systematically saving important decisions, steps, and general context into organized markdown files.

Core Features & Use Cases

  • Context Management: Saves key information to prevent loss and improve recall.
  • Structured Notes: Organizes information into 'decisions', 'steps', and 'context' categories with templates.
  • Use Case: When a complex feature is being developed, use this Skill to save critical design decisions and implementation steps, ensuring that this information is easily retrievable later, even after long periods or context resets.

Quick Start

Use context-compactor to save the current decision about the authentication flow by running the command ccsave "Auth Flow Decision" "We decided to use JWT with refresh tokens for simplicity and scalability." decision.

Frequently Asked Questions about context-compactor

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

FAQPage Schema
How do I save conversational context to prevent loss during long development sessions?

To save conversational context, you can use a context compaction approach that systematically records decisions, steps, and general notes into organized markdown files within a dedicated directory. This prevents context window saturation and information loss.

What is the best way to organize project decisions and implementation steps for later recall?

The best way to organize project decisions is by categorizing them into structured markdown files using predefined templates for 'decisions', 'steps', and 'context', ensuring critical information is easily retrievable after context resets.

Can I use bash scripts to manage and search through saved project notes?

Yes, you can use bash scripts to initialize a context directory, save notes, and search through saved markdown files. This allows you to systematically manage and retrieve project context directly from your command line.

How do I trigger context saving when the AI's context window is getting saturated?

Context saving can be triggered by explicit user commands or automatically when context saturation is detected. This systematically offloads important information into organized markdown files to free up context space.

Does context compaction require any external dependencies to manage markdown notes?

No external dependencies are required to manage markdown notes with context compaction. It relies solely on bash scripts to handle initialization, saving, listing, and searching through your structured project context files.