maintenance

Archive, split, and reorganize project files with configurable YAML thresholds.

3.0k|300|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/Chachamaru127/claude-code-harness --skill maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintenance
Source: https://github.com/Chachamaru127/claude-code-harness/tree/main/skills/maintenance
Command: npx skills add https://github.com/Chachamaru127/claude-code-harness --skill maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents project bloat and disorganization by automatically archiving old tasks, rotating session logs, and warning about oversized files, ensuring your project remains clean and manageable.

Core Features & Use Cases

  • Smart File Cleanup: Uses LLM evaluation to intelligently recommend when to archive old tasks from Plans.md or split large session-log.md files, going beyond simple line counts.
  • Configurable Thresholds: Allows customization of cleanup rules (e.g., archive tasks older than 7 days) via a simple config file.
  • Use Case: Is your Plans.md file becoming unwieldy? This Skill monitors file sizes and, at the end of a session, can suggest running a cleanup to archive completed items, keeping your active task list focused.

Quick Start

Say "clean up my old tasks" to automatically archive completed items from Plans.md that are older than the configured threshold.

Frequently Asked Questions about maintenance

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

FAQPage Schema
How do I automatically archive old tasks from my Plans.md file?

Archive old tasks by saying 'clean up my old tasks' or '/cleanup'. The Skill evaluates completed items older than your configured threshold and automatically archives them to keep your active task list focused and manageable.

Can I set custom thresholds for when files should be cleaned up?

Yes. Configure cleanup rules via a YAML config file to customize thresholds like archiving tasks older than 7 days. Settings apply project-wide to Plans.md, session-log.md, and CLAUDE.md files.

What happens when my session-log.md file gets too large?

The Skill monitors file size and intelligently recommends splitting large session-log.md files based on LLM evaluation. It can automatically split and archive old entries, preventing unwieldy log files.

Does the cleanup process create backups before making changes?

Yes. The Skill implements automatic backups before archiving or splitting files. Use dry-run mode to preview cleanup actions without modifying your project files.

How does this Skill decide which tasks are ready to archive?

It uses LLM evaluation combined with age thresholds to intelligently recommend archiving. Rather than simple line counts, it assesses task completion status and relevance to determine what should move to archive.