prune

Delete aged session transcripts and scratchpads via mechanical sweeps.

2|Updated Jul 11, 2024
One-click install
npx skills add https://github.com/nicograef/handbook --skill prune-nicograef
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prune
Source: https://github.com/nicograef/handbook/tree/main/.claude/skills/prune
Command: npx skills add https://github.com/nicograef/handbook --skill prune-nicograef

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill manages the accumulation of agent session state, transcripts, and outdated memories, preventing clutter and ensuring that the AI environment remains performant and contextually relevant.

Core Features & Use Cases

  • Mechanical Sweep: Automatically deletes aged session transcripts and scratchpads based on a configurable time threshold.
  • Semantic Review: Provides a gated, human-in-the-loop process to identify and remove stale memories, outdated rules, and unused repo leftovers.
  • Use Case: After completing a long-term project, use this Skill to purge temporary session files and clean up obsolete project-specific instructions to maintain a clean workspace.

Quick Start

Invoke the prune skill to perform a dry run of the cleanup process for the current project using a 30-day threshold.

Frequently Asked Questions about prune

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

FAQPage Schema
How do I clean up stale agent session state and accumulated memories?

You can safely retire stale agent state and memories by running a dry run with a 30-day threshold, which identifies aged session transcripts and scratchpads for non-destructive removal before applying any changes.

Can I delete outdated agent session transcripts without losing important workspace context?

You can delete outdated session transcripts safely because the process adheres to strict state-map definitions and uses a gated, human-in-the-loop semantic review to preserve important workspace context.

Do I need Bash to automate cleanup of project scratchpads and agent memories?

Yes, you need Bash to automate cleanup of project scratchpads and agent memories, as the Skill requires Bash for script execution to perform mechanical sweeps and gated semantic reviews.

What is the best way to purge temporary session files after completing a long-term project?

The best way to purge temporary session files after a long-term project is to invoke an age-based mechanical sweep with a configurable time threshold, automatically deleting accumulated transcripts and obsolete project-specific instructions.

How does a semantic review process identify stale memories and unused repo leftovers?

A gated, human-in-the-loop semantic review identifies stale memories and unused repo leftovers by evaluating accumulated global state classes and outdated rules before safely removing them from the workspace.