cleanup

Archive old Gran Maestro sessions and requests using configurable retention policies.

24|5|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/myrtlepn/gran-maestro --skill cleanup-myrtlepn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup
Source: https://github.com/myrtlepn/gran-maestro/tree/main/skills/cleanup
Command: npx skills add https://github.com/myrtlepn/gran-maestro --skill cleanup-myrtlepn

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps manage and reduce clutter within your Gran Maestro sessions by automatically archiving old or completed tasks, freeing up resources and improving organization.

Core Features & Use Cases

  • Automated Archiving: Cleans up ideation, discussion, debug, plans, and completed requests based on configurable retention policies.
  • Interactive Cleanup: Allows users to review and select old, active requests for archiving.
  • Use Case: After a week of development, you can run /mst:cleanup --run to archive all completed tasks and old requests, keeping your Maestro workspace tidy and focused on current work.

Quick Start

Run the cleanup skill to see what would be archived.

Frequently Asked Questions about cleanup

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

FAQPage Schema
How do I archive completed Gran Maestro sessions to reduce workspace clutter?

You can archive completed Gran Maestro sessions by running the cleanup skill, which automatically moves old ideation, discussion, debug, and plan files based on configurable retention policies. This frees up resources and maintains a tidy workspace.

What is the best way to manage old active requests in a Maestro project?

The best way to manage old active Maestro requests is using the interactive cleanup feature, which allows you to review and manually select outdated requests for archiving to keep your project workspace focused on current work.

Can I configure retention policies for archiving ideation and debug sessions?

Yes, you can configure retention policies for archiving ideation, discussion, debug, and plan sessions. These policies determine when the automated cleanup process moves old or completed Maestro session files into the archive.

How does automated session cleanup handle absolute paths for .gran-maestro directories?

Automated session cleanup enforces absolute path rules for all `.gran-maestro/` directories and applies robust error handling for file operations and parsing, ensuring safe and reliable archiving of old or completed sessions.

Do I need to review sessions before archiving completed Maestro tasks?

You do not strictly need to review completed tasks before archiving since automated retention policies handle them, but the interactive cleanup option lets you review and manually select old, active requests that require archiving.